1. /*

  2.  * Copyright 2002 Sun Microsystems, Inc. All rights reserved.

  3.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  4.  */

  5. 

  6. package javax.jms;

  7. 

  8. 

  9. /** A client uses a <CODE>QueueReceiver</CODE> object to receive messages that 

  10.   * have been delivered to a queue.

  11.   *

  12.   * <P>Although it is possible to have multiple <CODE>QueueReceiver</CODE>s 

  13.   * for the same queue, the JMS API does not define how messages are 

  14.   * distributed between the <CODE>QueueReceiver</CODE>s.

  15.   *

  16.   * <P>If a <CODE>QueueReceiver</CODE> specifies a message selector, the 

  17.   * messages that are not selected remain on the queue. By definition, a message

  18.   * selector allows a <CODE>QueueReceiver</CODE> to skip messages. This 

  19.   * means that when the skipped messages are eventually read, the total ordering

  20.   * of the reads does not retain the partial order defined by each message 

  21.   * producer. Only <CODE>QueueReceiver</CODE>s without a message selector

  22.   * will read messages in message producer order.

  23.   *

  24.   * @version     1.0 - 9 March 1998

  25.   * @author      Mark Hapner

  26.   * @author      Rich Burridge

  27.   *

  28.   * @see         javax.jms.QueueSession#createReceiver(Queue, String)

  29.   * @see         javax.jms.QueueSession#createReceiver(Queue)

  30.   * @see         javax.jms.MessageConsumer

  31.   */

  32. 

  33. public interface QueueReceiver extends MessageConsumer {

  34. 

  35.     /** Gets the <CODE>Queue</CODE> associated with this queue receiver.

  36.       *  

  37.       * @return this receiver's <CODE>Queue</CODE> 

  38.       *  

  39.       * @exception JMSException if the JMS provider fails to get the queue for

  40.       *                         this queue receiver

  41.       *                         due to some internal error.

  42.       */ 

  43.  

  44.     Queue

  45.     getQueue() throws JMSException;

  46. }