|
Java EE 5 SDK | ||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
public interface QueueReceiver
A client uses a QueueReceiver object to receive messages that
have been delivered to a queue.
Although it is possible to have multiple QueueReceivers
for the same queue, the JMS API does not define how messages are
distributed between the QueueReceivers.
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 QueueReceivers 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.
Session.createConsumer(Destination, String),
Session.createConsumer(Destination),
QueueSession.createReceiver(Queue, String),
QueueSession.createReceiver(Queue),
MessageConsumer| Method Summary | |
|---|---|
Queue |
getQueue()
Gets the Queue associated with this queue receiver. |
| Methods inherited from interface javax.jms.MessageConsumer |
|---|
close, getMessageListener, getMessageSelector, receive, receive, receiveNoWait, setMessageListener |
| Method Detail |
|---|
Queue getQueue()
throws JMSException
Queue associated with this queue receiver.
Queue
JMSException - if the JMS provider fails to get the queue for
this queue receiver
due to some internal error.
|
Java EE 5 SDK | ||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved.