Top Description Methods
javax.jms

public Interface ConnectionConsumer


For application servers, Connection objects provide a special facility for creating a ConnectionConsumer (optional). The messages it is to consume are specified by a Destination and a message selector. In addition, a ConnectionConsumer must be given a ServerSessionPool to use for processing its messages.

Normally, when traffic is light, a ConnectionConsumer gets a ServerSession from its pool, loads it with a single message, and starts it. As traffic picks up, messages can back up. If this happens, a ConnectionConsumer can load each ServerSession with more than one message. This reduces the thread context switches and minimizes resource use at the expense of some serialization of message processing.

Since
JMS 1.0
Version
JMS 2.0
See Also
javax.jms.Connection#createConnectionConsumer, javax.jms.Connection#createDurableConnectionConsumer, javax.jms.QueueConnection#createConnectionConsumer, javax.jms.TopicConnection#createConnectionConsumer, javax.jms.TopicConnection#createDurableConnectionConsumer

Method Summary

Modifier and TypeMethod and Description
public void
close()

Closes the connection consumer.

public ServerSessionPool

Returns:

the server session pool used by this connection consumer
getServerSessionPool
()

Gets the server session pool associated with this connection consumer.

Method Detail

closeback to summary
public void close() throws JMSException

Closes the connection consumer.

Since a provider may allocate some resources on behalf of a connection consumer outside the Java virtual machine, clients should close these resources when they are not needed. Relying on garbage collection to eventually reclaim these resources may not be timely enough.

Exceptions
JMSException:
if the JMS provider fails to release resources on behalf of the connection consumer or fails to close the connection consumer.
getServerSessionPoolback to summary
public ServerSessionPool getServerSessionPool() throws JMSException

Gets the server session pool associated with this connection consumer.

Returns:ServerSessionPool

the server session pool used by this connection consumer

Exceptions
JMSException:
if the JMS provider fails to get the server session pool associated with this consumer due to some internal error.