javax.jms
Interface ServerSessionPool

public interface ServerSessionPool

A ServerSessionPool is an object implemented by an application server to provide a pool of ServerSessions for processing the messages of a ConnectionConsumer (optional).

Its only method is getServerSession. JMS does not architect how the pool is implemented. It could be a static pool of ServerSessions or it could use a sophisticated algorithm to dynamically create ServerSessions as needed.

If the ServerSessionPool is out of ServerSessions, the getServerSession call may block. If a ConnectionConsumer is blocked, it cannot deliver new messages until a ServerSession is eventually returned.

Version:

1.0 - 9 March 1998

Author:

Mark Hapner, Rich Burridge

See Also:

ServerSession

Method Summary

ServerSession

getServerSession() Return a server session from the pool.

Method Detail

getServerSession

public ServerSession getServerSession()
                               throws JMSException

Return a server session from the pool.

Returns:

a server session from the pool.

Throws:

JMSException - if an application server fails to return a Server Session out of its server session pool.