public interface Connection
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
Modifier and Type | Method and Description |
---|---|
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.
|
Interaction createInteraction() throws ResourceException
ResourceException
- Failed to create an InteractionLocalTransaction getLocalTransaction() throws ResourceException
ResourceException
- Failed to return a LocalTransaction
instance because of a resource
adapter errorNotSupportedException
- 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
informationNotSupportedException
- ResultSet functionality is not
supportedvoid 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.
Copyright © 2017 JBoss by Red Hat. All rights reserved.