All Known Implementing Classes:
QueueReceiver, TopicSubscriber
MessageConsumer
object to receive messages
from a destination. A MessageConsumer
object is created by
passing a Destination
object to a message-consumer creation
method supplied by a session.
MessageConsumer
is the parent interface for all message
consumers.
A message consumer can be created with a message selector. A message selector allows the client to restrict the messages delivered to the message consumer to those that match the selector.
A client may either synchronously receive a message consumer's messages or have the consumer asynchronously deliver them as they arrive.
For synchronous receipt, a client can request the next message from a
message consumer using one of its receive
methods. There are
several variations of receive
that allow a
client to poll or wait for the next message.
For asynchronous delivery, a client can register a
MessageListener
object with a message consumer.
As messages arrive at the message consumer, it delivers them by calling the
MessageListener
's onMessage
method.
It is a client programming error for a MessageListener
to
throw an exception.
Method from javax.jms.MessageConsumer Summary: |
---|
close, getMessageListener, getMessageSelector, receive, receive, receiveNoWait, setMessageListener |
Method from javax.jms.MessageConsumer Detail: |
---|
Since a provider may allocate some resources on behalf of a
This call blocks until a |
MessageListener . |
|
This call blocks indefinitely until a message is produced or until this message consumer is closed. If this |
This call blocks until a message arrives, the
timeout expires, or this message consumer is closed.
A |
|
MessageListener .
Setting the message listener to null is the equivalent of unsetting the message listener for the message consumer. The effect of calling |