public class GSQueueReceiverImpl extends GSMessageConsumerImpl
javax.jms.QueueReceiver
interface.
A client uses a 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. The
GigaSpaces API does not support multiple QueueReceivers for the same queue.
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.
Session.createConsumer(Destination, String)
,
Session.createConsumer(Destination)
,
QueueSession.createReceiver(Queue, String)
,
QueueSession.createReceiver(Queue)
,
MessageConsumer
m_closed, m_dest, m_destName, m_durableSubscriptionName, m_isQueue, m_session
Constructor and Description |
---|
GSQueueReceiverImpl(GSSessionImpl sess,
GSQueueImpl queue,
String consumerKey,
String selector) |
close, getConsumerID, getDestination, getMessageListener, getMessageSelector, getName, getNoLocal, getQueue, getSession, getTopic, isClosed, isDurableSubscriber, receive, receive, receiveNoWait, setMessageListener, toString
public GSQueueReceiverImpl(GSSessionImpl sess, GSQueueImpl queue, String consumerKey, String selector) throws javax.jms.JMSException
sess
- queue
- consumerKey
- selector
- javax.jms.JMSException
Copyright © GigaSpaces.