DissociatableManagedConnection (Java EE 5)

This is a mix-in interface that may be optionally implemented by a ManagedConnection implementation. An implementation of this interface must support the lazy connection association optimization.

Version:

1.0

Author:

Ram Jeyaraman

public void dissociateConnections() throws ResourceException
此方法由应用服务器（能够进行延时连接关联优化）调用，以便取消 ManagedConnection 实例与其所有连接句柄的关联。

Throws	ResourceException: 如果执行操作失败，则抛出一般异常。
Throws	ResourceAdapterInternalException: 资源适配器内部错误情况
Throws	IllegalStateException: 调用连接清除时处于非法状态。例如，如果正在进行不允许清除连接的 localtransaction 操作。

英文文档：

dissociateConnections

void dissociateConnections()
                           throws ResourceException

This method is called by an application server (that is capable of lazy connection association optimization) in order to dissociate a ManagedConnection instance from all of its connection handles.

Throws:

ResourceException - generic exception if operation fails.

ResourceAdapterInternalException - resource adapter internal error condition

IllegalStateException - Illegal state for calling connection cleanup. Example - if a localtransaction is in progress that doesn't allow connection cleanup.

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