Interface QueueReceiver
- All Superinterfaces:
AutoCloseable
,MessageConsumer
QueueReceiver
object to receive messages that
have been delivered to a queue.
Although it is possible to have multiple QueueReceiver
s
for the same queue, the JMS API does not define how messages are
distributed between the QueueReceiver
s.
If a QueueReceiver
specifies a message selector, the
messages that are not selected remain on the queue. By definition, a message
selector allows a QueueReceiver
to skip messages. This
means that when the skipped messages are eventually read, the total ordering
of the reads does not retain the partial order defined by each message
producer. Only QueueReceiver
s without a message selector
will read messages in message producer order.
Creating a MessageConsumer
provides the same features as
creating a QueueReceiver
. A MessageConsumer
object is
recommended for creating new code. The QueueReceiver
is
provided to support existing code.
-
Method Summary
Methods inherited from interface javax.jms.MessageConsumer
close, getMessageListener, getMessageSelector, receive, receive, receiveNoWait, setMessageListener
-
Method Details
-
getQueue
Gets theQueue
associated with this queue receiver.- Returns:
- this receiver's
Queue
- Throws:
JMSException
- if the JMS provider fails to get the queue for this queue receiver due to some internal error.
-