Top Description Methods
javax.resource.spi

public Interface LazyAssociatableConnectionManager

Imports
javax.resource.ResourceException

This is a mix-in interface that may be optionally implemented by a ConnectionManager implementation. An implementation of this interface must support the lazy connection association optimization.
Author
Ram Jeyaraman
Version
1.0

Method Summary

Modifier and TypeMethod and Description
public void
associateConnection(Object
the connection object that is to be associated.
connection
,
ManagedConnectionFactory
The ManagedConnectionFactory instance that was originally used to create the connection object.
mcf
,
ConnectionRequestInfo
connection request information. This information must be the same as that used to originally create the connection object.
cxReqInfo
)

This method is called by a resource adapter (that is capable of lazy connection association optimization) in order to lazily associate a connection object with a ManagedConnection instance.

public void
inactiveConnectionClosed(Object
the disassociated connection object handle that has been closed
connection
,
ManagedConnectionFactory
The ManagedConnectionFactory instance that was originally used to create the connection object.
mcf
)

This method is called by the resource adapter (that is capable of lazy connection association optimization) in order to notify the application server that a disassociated connection handle is closed.

Method Detail

associateConnectionback to summary
public void associateConnection(Object connection, ManagedConnectionFactory mcf, ConnectionRequestInfo cxReqInfo) throws ResourceException

This method is called by a resource adapter (that is capable of lazy connection association optimization) in order to lazily associate a connection object with a ManagedConnection instance.

Parameters
connection:Object

the connection object that is to be associated.

mcf:ManagedConnectionFactory

The ManagedConnectionFactory instance that was originally used to create the connection object.

cxReqInfo:ConnectionRequestInfo

connection request information. This information must be the same as that used to originally create the connection object.

Exceptions
ResourceException:
Generic exception.
ApplicationServerInternalException:
Application server specific exception.
SecurityException:
Security related error.
ResourceAllocationException:
Failed to allocate system resources for connection request.
ResourceAdapterInternalException:
Resource adapter related error condition.
inactiveConnectionClosedback to summary
public void inactiveConnectionClosed(Object connection, ManagedConnectionFactory mcf)

This method is called by the resource adapter (that is capable of lazy connection association optimization) in order to notify the application server that a disassociated connection handle is closed.

The application server can then perform any cleanup operations related to the disassociated connection handle in its connection pool.

Parameters
connection:Object

the disassociated connection object handle that has been closed

mcf:ManagedConnectionFactory

The ManagedConnectionFactory instance that was originally used to create the connection object.

Since
1.6