|
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.