| 
 | J2EE1.4 SDK | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
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 Queueassociated with this queue receiver. | 
| Methods inherited from interface javax.jms.MessageConsumer | 
| close, getMessageListener, getMessageSelector, receive, receive, receiveNoWait, setMessageListener | 
| Method Detail | 
public 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.| 
 | J2EE1.4 SDK | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright 2003 Sun Microsystems, Inc. All rights reserved.