Java Doc for ConnectionConsumer.java in  » 6.0-JDK-Modules » JMS » javax » jms » Java Source Code / Java DocumentationJava Source Code and Java Documentation

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.
version:
   1.1 February 8, 2002
author:
   Mark Hapner
author:
   Rich Burridge
See Also:   javax.jms.Connection.createConnectionConsumer
See Also:   javax.jms.Connection.createDurableConnectionConsumer
See Also:   javax.jms.QueueConnection.createConnectionConsumer
See Also:   javax.jms.TopicConnection.createConnectionConsumer
See Also:   javax.jms.TopicConnection.createDurableConnectionConsumer

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.

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.
exception:
  JMSException - if the JMS provider fails to release resources on behalf of the connection consumer or failsto close the connection consumer.