|
DRAFT | ||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
public interface Connection
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 |
|---|
Interaction createInteraction()
throws ResourceException
ResourceException - Failed to create an Interaction
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
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.
ResultSetInfo getResultSetInfo()
throws ResourceException
ResourceException - Failed to get ResultSet related
information
NotSupportedException - ResultSet functionality is not
supported
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.
|
DRAFT | ||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright © 2009 Sun Microsystems, Inc. All Rights Reserved. Use is subject to license terms.
Generated on 24-November-2009 03:24