| 
 | J2EE1.4 SDK | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
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.
ConnectionFactory, 
Interaction| Method Summary | |
|  void | close()Initiates close of the connection handle at the application level. | 
|  Interaction | createInteraction()Creates an Interaction associated with this Connection. | 
|  LocalTransaction | getLocalTransaction()Returns an LocalTransaction instance that enables a component to demarcate resource manager local transactions on the Connection. | 
|  ConnectionMetaData | getMetaData()Gets the information on the underlying EIS instance represented through an active connection. | 
|  ResultSetInfo | getResultSetInfo()Gets the information on the ResultSet functionality supported by a connected EIS instance. | 
| Method Detail | 
public Interaction createInteraction()
                              throws ResourceException
ResourceException - Failed to create an Interaction
public LocalTransaction getLocalTransaction()
                                     throws ResourceException
ResourceException - Failed to return a LocalTransaction
                                instance because of a resource
                                adapter error
NotSupportedException - Demarcation of Resource manager 
                                local transactions is not supported
                                on this ConnectionLocalTransaction
public ConnectionMetaData getMetaData()
                               throws ResourceException
ResourceException - Failed to get information about the 
                        connected EIS instance. Error can be
                        resource adapter-internal, EIS-specific
                        or communication related.
public ResultSetInfo getResultSetInfo()
                               throws ResourceException
ResourceException - Failed to get ResultSet related 
                                  information
NotSupportedException - ResultSet functionality is not
                                  supported
public void close()
           throws ResourceException
ResourceException - Exception thrown if close
                              on a connection handle fails.
           Any invalid connection close invocation--example, calling close on a connection handle that is already closed--should also throw this exception.
| 
 | J2EE1.4 SDK | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright 2003 Sun Microsystems, Inc. All rights reserved.