javax.resource.spi
Interface ConnectionManager

All Superinterfaces:

Serializable

public interface ConnectionManager
extends 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.

Method Summary

Object

allocateConnection(ManagedConnectionFactory mcf, ConnectionRequestInfo cxRequestInfo) Gets called by the resource adapter's connection factory.

Method Detail

allocateConnection

Object allocateConnection(ManagedConnectionFactory mcf,
                          ConnectionRequestInfo cxRequestInfo)
                          throws ResourceException

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 - for an generic error

ApplicationServerInternalException - for problems in the application server

SecurityException - for security problems

ResourceAllocationException - for problems allocating resources

ResourceAdapterInternalException - for errors from the resource adapter