public interface ConnectionConsumer
Connectionobjects provide a special facility for creating a
ConnectionConsumer(optional). The messages it is to consume are specified by a
Destinationand a message selector. In addition, a
ConnectionConsumermust be given a
ServerSessionPoolto 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,
ConnectionConsumer can load each
with more than one
message. This reduces the thread context switches and minimizes resource
use at the expense of some serialization of message processing.
Connection.createConnectionConsumer(javax.jms.Destination, java.lang.String, javax.jms.ServerSessionPool, int),
Connection.createDurableConnectionConsumer(javax.jms.Topic, java.lang.String, java.lang.String, javax.jms.ServerSessionPool, int),
QueueConnection.createConnectionConsumer(javax.jms.Queue, java.lang.String, javax.jms.ServerSessionPool, int),
TopicConnection.createConnectionConsumer(javax.jms.Topic, java.lang.String, javax.jms.ServerSessionPool, int),
TopicConnection.createDurableConnectionConsumer(javax.jms.Topic, java.lang.String, java.lang.String, javax.jms.ServerSessionPool, int)
ServerSessionPool getServerSessionPool() throws JMSException
JMSException- if the JMS provider fails to get the server session pool associated with this consumer due to some internal error.
void close() throws JMSException
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.
JMSException- if the JMS provider fails to release resources on behalf of the connection consumer or fails to close the connection consumer.
Copyright © 1996-2013, Oracle and/or its affiliates. All Rights Reserved. Use is subject to license terms.