javax.resource.spi
Interface ConnectionManager

All Superinterfaces:

java.io.Serializable

All Known Implementing Classes:

BaseConnectionManager2.ConnectionManagerProxy (src) , JmsConnectionManager (src)

public interface ConnectionManager

extends java.io.Serializable

The ConnectionManager interface provides the hook which allows a resource adapter to pass a connection to the Application Server. The Application Server implements this interface in order to control QoS services to the resource adapter for connection pools.

allocateConnection

public java.lang.Object allocateConnection(ManagedConnectionFactory (src)  mcf,
                                           ConnectionRequestInfo (src)  cxRequestInfo)
                                    throws ResourceException (src) 

Gets called by the resource adapter's connection factory. The resource adapter uses this method to pass its managed connection factory to the connection manager.

Parameters:

mcf - the managed connection factory

cxRequestInfo - the connection request info

Returns:

the connection handle

Throws:

ResourceException (src) - for an generic error

ApplicationServerInternalException (src) - for problems in the application server

SecurityException (src) - for security problems

ResourceAllocationException (src) - for problems allocating resources

ResourceAdapterInternalException (src) - for errors from the resource adapter