JavaTM Platform, Enterprise Edition, v 5.0
javax.jms
Interface ConnectionConsumer
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.
- Version:
- 1.1 February 8, 2002
- Author:
- Mark Hapner, Rich Burridge
- See Also:
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)
getServerSessionPool
ServerSessionPool getServerSessionPool()
throws JMSException
- Gets the server session pool associated with this connection consumer.
- Returns:
- the server session pool used by this connection consumer
- Throws:
JMSException - if the JMS provider fails to get the server
session pool associated with this consumer due
to some internal error.
close
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.
- Throws:
JMSException - if the JMS provider fails to release resources
on behalf of the connection consumer or fails
to close the connection consumer.
Copyright 2003 Sun Microsystems, Inc. All rights reserved
|