Class MessageConsumer

A client uses a 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 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 the receive method.

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.


Constructor Summary
MessageConsumer()
            A client uses a MessageConsumer object to receive messages from a destination.
 
Method Summary
 VoidFuture close(callback)
           Closes the message consumer.
 MessageListener getMessageListener()
           Gets the message consumer's MessageListener.
 String getMessageSelector()
           Gets this message consumer's message selector expression.
 Message receiveNoWait()
           Receives the next message if one is immediately available.
 void setMessageListener(listener)
           Sets the message consumer's MessageListener.
 
Constructor Detail

MessageConsumer

MessageConsumer()

Method Detail

close

VoidFuture close(callback)

getMessageListener

MessageListener getMessageListener()

getMessageSelector

String getMessageSelector()

receiveNoWait

Message receiveNoWait()

setMessageListener

void setMessageListener(listener)