Movatterモバイル変換

Interface Connection

public interfaceConnection

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 thegetConnection method on aConnectionFactory instance. A connection can be associated with zero or more Interaction instances.

See Also:

ConnectionFactory,Interaction

createInteraction

publicInteractioncreateInteraction()                              throwsResourceException

Creates an Interaction associated with this Connection. An Interaction enables an application to execute EIS functions.

Returns:

Interaction instance

Throws:

ResourceException - Failed to create an Interaction

getLocalTransaction

publicLocalTransactiongetLocalTransaction()                                     throwsResourceException

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.

Returns:

LocalTransaction instance

Throws:

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 Connection

See Also:

LocalTransaction

getMetaData

publicConnectionMetaDatagetMetaData()                               throwsResourceException

Gets the information on the underlying EIS instance represented through an active connection.

Returns:

ConnectionMetaData instance representing information about the EIS instance

Throws:

ResourceException - Failed to get information about the connected EIS instance. Error can be resource adapter-internal, EIS-specific or communication related.

getResultSetInfo

publicResultSetInfogetResultSetInfo()                               throwsResourceException

Gets the information on the ResultSet functionality supported by a connected EIS instance.

Returns:

ResultSetInfo instance

Throws:

ResourceException - Failed to get ResultSet related information

NotSupportedException - ResultSet functionality is not supported

close

public voidclose()           throwsResourceException

Initiates close of the connection handle at the application level. A client should not use a closed connection to interact with an EIS.

Throws:

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.