Interface Connection

Method Detail

• createInteraction

  Interaction createInteraction()
                         throws ResourceException

  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

  LocalTransaction getLocalTransaction()
                                throws ResourceException

  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

  ConnectionMetaData getMetaData()
                          throws ResourceException

  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

  ResultSetInfo getResultSetInfo()
                          throws ResourceException

  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

  void close()
      throws ResourceException

  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.