Movatterモバイル変換

Interface QueueSender

All Superinterfaces:: MessageProducer

public interfaceQueueSender
extendsMessageProducer

A client uses aQueueSender object to send messages to a queue.

Normally, theQueue is specified when aQueueSender is created. In this case, an attempt to use thesend methods for an unidentifiedQueueSender will throw ajava.lang.UnsupportedOperationException.

If theQueueSender is created with an unidentifiedQueue, an attempt to use thesend methods that assume that theQueue has been identified will throw ajava.lang.UnsupportedOperationException.

During the execution of itssend method, a message must not be changed by other threads within the client. If the message is modified, the result of thesend is undefined.

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.

The following message headers are set as part of sending a message:JMSDestination,JMSDeliveryMode,JMSExpiration,JMSPriority,JMSMessageID andJMSTimeStamp. When the message is sent, the values of these headers are ignored. After the completion of thesend, the headers hold the values specified by the method sending the message. It is possible for thesend method not to setJMSMessageID andJMSTimeStamp if the setting of these headers is explicitly disabled by theMessageProducer.setDisableMessageID orMessageProducer.setDisableMessageTimestamp method.

See Also:: MessageProducer,QueueSession.createSender(Queue)


	`getQueue()` Gets the queue associated with this`QueueSender`.
	`send(Message message)` Sends a message to the queue.
	`send(Message message, int deliveryMode, int priority, long timeToLive)` Sends a message to the queue, specifying delivery mode, priority, and time to live.
	`send(Queue queue,Message message)` Sends a message to a queue for an unidentified message producer.
	`send(Queue queue,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 interface javax.jms.MessageProducer

close,getDeliveryMode,getDisableMessageID,getDisableMessageTimestamp,getPriority,getTimeToLive,setDeliveryMode,setDisableMessageID,setDisableMessageTimestamp,setPriority,setTimeToLive

getQueue

publicQueuegetQueue()               throwsJMSException

Gets the queue associated with thisQueueSender.

Returns:: this sender's queue
Throws:: JMSException - if the JMS provider fails to get the queue for thisQueueSender due to some internal error.

send

public voidsend(Message message)          throwsJMSException

Sends a message to the queue. Uses theQueueSender's default delivery mode, priority, and time to live.

Parameters:: message - the message to send
Throws:: JMSException - if the JMS provider fails to send the message due to some internal error.; MessageFormatException - if an invalid message is specified.; InvalidDestinationException - if a client uses this method with aQueueSender with an invalid queue.; java.lang.UnsupportedOperationException - if a client uses this method with aQueueSender that did not specify a queue at creation time.
See Also:: MessageProducer.getDeliveryMode(),MessageProducer.getTimeToLive(),MessageProducer.getPriority()

send

public voidsend(Message message,                 int deliveryMode,                 int priority,                 long timeToLive)          throwsJMSException

Sends a message to the queue, specifying delivery mode, priority, and time to live.

Parameters:: message - the message to send; deliveryMode - the delivery mode to use; priority - the priority for this message; timeToLive - the message's lifetime (in milliseconds)
Throws:: JMSException - if the JMS provider fails to send the message due to some internal error.; MessageFormatException - if an invalid message is specified.; InvalidDestinationException - if a client uses this method with aQueueSender with an invalid queue.; java.lang.UnsupportedOperationException - if a client uses this method with aQueueSender that did not specify a queue at creation time.

send

public voidsend(Queue queue,Message message)          throwsJMSException

Sends a message to a queue for an unidentified message producer. Uses theQueueSender's default delivery mode, priority, and time to live.

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.

Parameters:: queue - the queue to send this message to; message - the message to send
Throws:: JMSException - if the JMS provider fails to send the message due to some internal error.; MessageFormatException - if an invalid message is specified.; InvalidDestinationException - if a client uses this method with an invalid queue.
See Also:: MessageProducer.getDeliveryMode(),MessageProducer.getTimeToLive(),MessageProducer.getPriority()

send

public voidsend(Queue queue,Message message,                 int deliveryMode,                 int priority,                 long timeToLive)          throwsJMSException

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

Parameters:: queue - the queue to send this message to; message - the message to send; deliveryMode - the delivery mode to use; priority - the priority for this message; timeToLive - the message's lifetime (in milliseconds)
Throws:: JMSException - if the JMS provider fails to send the message due to some internal error.; MessageFormatException - if an invalid message is specified.; InvalidDestinationException - if a client uses this method with an invalid queue.

[8]ページ先頭