alvinalexander.com | career | drupal | java | mac | mysql | perl | scala | uml | unix  

ActiveMQ example source code file (ActiveMQQueueSender.java)

This example ActiveMQ source code file (ActiveMQQueueSender.java) is included in the DevDaily.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" TM.

Java - ActiveMQ tags/keywords

activemqdestination, activemqmessageproducer, activemqmessageproducer, activemqqueuesender, activemqqueuesender, jmsexception, jmsexception, message, message, queue, queuesender

The ActiveMQ ActiveMQQueueSender.java source code

/**
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.apache.activemq;

import javax.jms.JMSException;
import javax.jms.Message;
import javax.jms.Queue;
import javax.jms.QueueSender;

import org.apache.activemq.command.ActiveMQDestination;

/**
 * A client uses a <CODE>QueueSender object to send messages to a
 * queue. <p/>
 * <P>
 * Normally, the <CODE>Queue is specified when a QueueSender
 * </CODE>
 * is created. In this case, an attempt to use the <CODE>send methods
 * for an unidentified <CODE>QueueSender will throw a 
 * java.lang.UnsupportedOperationException</CODE>.
 * <p/>
 * <P>
 * If the <CODE>QueueSender is created with an unidentified 
 * Queue</CODE>,
 * an attempt to use the <CODE>send methods that assume that the
 * <CODE>Queue has been identified will throw a 
 * java.lang.UnsupportedOperationException</CODE>.
 * <p/>
 * <P>
 * During the execution of its <CODE>send method, a message must not be
 * changed by other threads within the client. If the message is modified, the
 * result of the <CODE>send is undefined. 

* <P> * After sending a message, a client may retain and modify it without affecting * the message that has been sent. The same message object may be sent multiple * times. <p/> * <P> * The following message headers are set as part of sending a message: * <code>JMSDestination, JMSDeliveryMode,JMSExpiration,JMSPriority, * <code>JMSMessageID and JMSTimeStamp. When the * message is sent, the values of these headers are ignored. After the * completion of the <CODE>send, the headers hold the values specified * by the method sending the message. It is possible for the <code>send * method not to set <code>JMSMessageID and JMSTimeStamp * if the setting of these headers is explicitly disabled by the * <code>MessageProducer.setDisableMessageID or * <code>MessageProducer.setDisableMessageTimestamp method.

* <P> * Creating a <CODE>MessageProducer provides the same features as * creating a <CODE>QueueSender. A MessageProducer * object is recommended when creating new code. The <CODE>QueueSender * is provided to support existing code. * * @see javax.jms.MessageProducer * @see javax.jms.QueueSession#createSender(Queue) */ public class ActiveMQQueueSender extends ActiveMQMessageProducer implements QueueSender { protected ActiveMQQueueSender(ActiveMQSession session, ActiveMQDestination destination,int sendTimeout) throws JMSException { super(session, session.getNextProducerId(), destination,sendTimeout); } /** * Gets the queue associated with this <CODE>QueueSender. * * @return this sender's queue * @throws JMSException if the JMS provider fails to get the queue for this * <CODE>QueueSender due to some internal error. */ public Queue getQueue() throws JMSException { return (Queue)super.getDestination(); } /** * Sends a message to a queue for an unidentified message producer. Uses the * <CODE>QueueSender's default delivery mode, priority, and time * to live. <p/> * <P> * Typically, a message producer is assigned a queue at creation time; * however, the JMS API also supports unidentified message producers, which * require that the queue be supplied every time a message is sent. * * @param queue the queue to send this message to * @param message the message to send * @throws JMSException if the JMS provider fails to send the message due to * some internal error. * @see javax.jms.MessageProducer#getDeliveryMode() * @see javax.jms.MessageProducer#getTimeToLive() * @see javax.jms.MessageProducer#getPriority() */ public void send(Queue queue, Message message) throws JMSException { super.send(queue, message); } /** * Sends a message to a queue for an unidentified message producer, * specifying delivery mode, priority and time to live. <p/> * <P> * Typically, a message producer is assigned a queue at creation time; * however, the JMS API also supports unidentified message producers, which * require that the queue be supplied every time a message is sent. * * @param queue the queue to send this message to * @param message the message to send * @param deliveryMode the delivery mode to use * @param priority the priority for this message * @param timeToLive the message's lifetime (in milliseconds) * @throws JMSException if the JMS provider fails to send the message due to * some internal error. */ public void send(Queue queue, Message message, int deliveryMode, int priority, long timeToLive) throws JMSException { super.send(queue, message, deliveryMode, priority, timeToLive); } }

Other ActiveMQ examples (source code examples)

Here is a short list of links related to this ActiveMQ ActiveMQQueueSender.java source code file:

... this post is sponsored by my books ...

#1 New Release!

FP Best Seller

 

new blog posts

 

Copyright 1998-2021 Alvin Alexander, alvinalexander.com
All Rights Reserved.

A percentage of advertising revenue from
pages under the /java/jwarehouse URI on this website is
paid back to open source projects.