Java Enterprise in a Nutshell, Second Edition

Name

ManagedConnection

Synopsis

A ManagedConnection represents a physical connection to a resource. Every client-side Connection has a corresponding ManagedConnection within the resource adapter implementation.

public interface ManagedConnection {
// Event Registration Methods (by event name)
   public abstract void addConnectionEventListener(
        javax.resource.spi.ConnectionEventListener listener);  
   public abstract void removeConnectionEventListener(
        javax.resource.spi.ConnectionEventListener listener);  
// Public Instance Methods
   public abstract void associateConnection(
        Object connection) throws ResourceException;  
   public abstract void cleanup() throws ResourceException;  
   public abstract void destroy() throws ResourceException;  
   public abstract Object getConnection(
        javax.security.auth.Subject subject, 
        ConnectionRequestInfo cxRequestInfo) throws ResourceException;  
   public abstract javax.resource.spi.LocalTransaction getLocalTransaction(
        ) throws ResourceException;  
   public abstract PrintWriter getLogWriter(
        ) throws ResourceException;  
   public abstract ManagedConnectionMetaData getMetaData(
        ) throws ResourceException;  
   public abstract javax.transaction.xa.XAResource getXAResource(
        ) throws ResourceException;  
   public abstract void setLogWriter(
        PrintWriter out) throws ResourceException;  
}

Passed To

javax.resource.spi.ConnectionEvent.ConnectionEvent()

Returned By

ManagedConnectionFactory.{createManagedConnection(), matchManagedConnections()}