LazyAssociatableConnectionManager (Java EE 5)

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.

Version:

1.0

Author:

Ram Jeyaraman

public void associateConnection(Object connection, ManagedConnectionFactory mcf, ConnectionRequestInfo cxReqInfo) throws ResourceException
此方法由资源适配器（能够进行延时连接关联优化）调用，以便延时将连接对象与 ManagedConnection 实例关联。

connection	要关联的连接对象。
mcf	最初用于创建连接对象的 ManagedConnectionFactory 实例。
cxReqInfo	连接请求信息。该信息必须与最初用来创建连接对象的信息相同。
Throws	ResourceException: 一般异常。
Throws	ApplicationServerInternalException: 特定于应用服务器的异常。
Throws	SecurityException: 与安全有关的错误。
Throws	ResourceAllocationException: 无法为连接请求分配系统资源。
Throws	ResourceAdapterInternalException: 与资源适配器有关的错误情况。

英文文档：

associateConnection

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 - the connection object that is to be associated.

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

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

Throws:

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.

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.