Save This Page
Home » glassfish-v2ur2-b04-src » javax.resource.cci » [javadoc | source]
javax.resource.cci
public interface: Connection [javadoc | source] A Connection represents an application-level handle that is used by a client to access the underlying physical connection. The actual physical connection associated with a Connection instance is represented by a ManagedConnection instance.

A client gets a Connection instance by using the getConnection method on a ConnectionFactory instance. A connection can be associated with zero or more Interaction instances.

Method from javax.resource.cci.Connection Summary:
close,   createInteraction,   getLocalTransaction,   getMetaData,   getResultSetInfo
Method from javax.resource.cci.Connection Detail:
 public  void close() throws ResourceException
    Initiates close of the connection handle at the application level. A client should not use a closed connection to interact with an EIS.
 public Interaction createInteraction() throws ResourceException
    Creates an Interaction associated with this Connection. An Interaction enables an application to execute EIS functions.
 public LocalTransaction getLocalTransaction() throws ResourceException
    Returns an LocalTransaction instance that enables a component to demarcate resource manager local transactions on the Connection. If a resource adapter does not allow a component to demarcate local transactions on an Connection using LocalTransaction interface, then the method getLocalTransaction should throw a NotSupportedException.
 public ConnectionMetaData getMetaData() throws ResourceException
    Gets the information on the underlying EIS instance represented through an active connection.
 public ResultSetInfo getResultSetInfo() throws ResourceException
    Gets the information on the ResultSet functionality supported by a connected EIS instance.