com.ibm.mq.jms

Class MQQueueSender

java.lang.Object

com.ibm.mq.jms.MQRoot

com.ibm.mq.jms.MQMessageProducer

com.ibm.mq.jms.MQQueueSender

All Implemented Interfaces:

JmsMessageProducer, JmsPropertyContext, JmsQueueSender, JmsReadablePropertyContext, java.io.Serializable, java.lang.AutoCloseable, java.util.Map<java.lang.String,java.lang.Object>, javax.jms.MessageProducer, javax.jms.QueueSender

public class MQQueueSender
extends MQMessageProducer
implements javax.jms.QueueSender, JmsQueueSender

A client uses an MQQueueSender to send messages to a queue. A QueueSender is normally associated with a particular queue. However, it is possible to create an unidentified QueueSender that is not associated with any given queue.

See Also:

MessageProducer, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

java.util.Map.Entry<K,V>

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Close the sender.
javax.jms.Queue	getQueue() Gets the Queue associated with this sender.
void	send(javax.jms.Queue queue, javax.jms.Message message) Sends a message to a queue for an unidentified message producer.
void	send(javax.jms.Queue queue, javax.jms.Message message, int deliveryMode, int priority, long timeToLive) Sends a message to a queue for an unidentified message producer, specifying delivery mode, priority and time to live.

Methods inherited from class com.ibm.mq.jms.MQMessageProducer

getDeliveryDelay, getDeliveryMode, getDestination, getDisableMessageID, getDisableMessageTimestamp, getPriority, getTimeToLive, send, send, send, send, send, send, setDeliveryDelay, setDeliveryMode, setDisableMessageID, setDisableMessageTimestamp, setPriority, setTimeToLive

Methods inherited from class com.ibm.mq.jms.MQRoot

clear, containsKey, containsValue, entrySet, equals, get, getBooleanProperty, getByteProperty, getBytesProperty, getCharProperty, getDoubleProperty, getFloatProperty, getIntProperty, getLongProperty, getObjectProperty, getPropertyNames, getShortProperty, getStringProperty, hashCode, isEmpty, keySet, propertyExists, put, putAll, remove, setBatchProperties, setBooleanProperty, setByteProperty, setBytesProperty, setCharProperty, setDoubleProperty, setFloatProperty, setIntProperty, setLongProperty, setObjectProperty, setShortProperty, setStringProperty, size, values

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.ibm.msg.client.jms.JmsPropertyContext

setBatchProperties, setBooleanProperty, setByteProperty, setBytesProperty, setCharProperty, setDoubleProperty, setFloatProperty, setIntProperty, setLongProperty, setObjectProperty, setShortProperty, setStringProperty

Methods inherited from interface com.ibm.msg.client.jms.JmsReadablePropertyContext

getBooleanProperty, getByteProperty, getBytesProperty, getCharProperty, getDoubleProperty, getFloatProperty, getIntProperty, getLongProperty, getObjectProperty, getPropertyNames, getShortProperty, getStringProperty, propertyExists

Methods inherited from interface java.util.Map

clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, size, values

Methods inherited from interface javax.jms.QueueSender

send, send

Methods inherited from interface javax.jms.MessageProducer

getDeliveryDelay, getDeliveryMode, getDestination, getDisableMessageID, getDisableMessageTimestamp, getPriority, getTimeToLive, send, send, send, send, send, send, setDeliveryDelay, setDeliveryMode, setDisableMessageID, setDisableMessageTimestamp, setPriority, setTimeToLive

Method Detail

close

public void close()
           throws javax.jms.JMSException

Close the sender. Releases underlying resources associated with this sender.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface javax.jms.MessageProducer

Overrides:

close in class MQMessageProducer

Throws:

javax.jms.JMSException - if underlying MQ calls fail.

getQueue

public javax.jms.Queue getQueue()
                         throws javax.jms.JMSException

Gets the Queue associated with this sender.

Specified by:

getQueue in interface javax.jms.QueueSender

Returns:

the queue

Throws:

javax.jms.JMSException - if the operation fails

send

public void send(javax.jms.Queue queue,
        javax.jms.Message message)
          throws javax.jms.JMSException

Sends a message to a queue for an unidentified message producer. Use the QueueSender's default delivery mode, timeToLive and priority.

Typically a JMS message producer is assigned a queue at creation time; however, JMS also supports unidentified message producers which require that the queue be supplied on every message send.

Specified by:

send in interface javax.jms.QueueSender

Parameters:

queue - the queue that this message should be sent to

message - the message to be sent

Throws:

javax.jms.JMSException - if the operation fails

send

public void send(javax.jms.Queue queue,
        javax.jms.Message message,
        int deliveryMode,
        int priority,
        long timeToLive)
          throws javax.jms.JMSException

Sends a message to a queue for an unidentified message producer, specifying delivery mode, priority and time to live.

Typically a JMS message producer is assigned a queue at creation time; however, JMS also supports unidentified message producers which require that the queue be supplied on every message send.

Specified by:

send in interface javax.jms.QueueSender

Parameters:

queue - the queue that this message should be sent to

message - the message to be sent

deliveryMode - the delivery mode to use

priority - the priority for this message

timeToLive - the message's lifetime (in milliseconds).

Throws:

javax.jms.JMSException - if the operation fails