インターフェース Connection

メソッドの詳細

• createInteraction

  Interaction createInteraction() throws ResourceException

  この接続に関連付けられたインタラクションを作成します。インタラクションにより、アプリケーションは EIS 機能を実行できます。

  戻り値:

  インタラクションインスタンス

  例外:

  ResourceException - インタラクションの作成に失敗しました

• getLocalTransaction

  LocalTransaction getLocalTransaction() throws ResourceException

  コンポーネントが接続上でリソースマネージャーのローカルトランザクションを区別できるようにする LocalTransaction インスタンスを返します。リソースアダプターがコンポーネントに LocalTransaction インターフェースを使用した接続上のローカルトランザクションの区別を許可しない場合は、メソッド getLocalTransaction は NotSupportedException をスローする必要があります。

  戻り値:

  LocalTransaction インスタンス

  例外:

  ResourceException - リソースアダプターエラーのため、LocalTransaction インスタンスを返すことができませんでした

  NotSupportedException - リソースマネージャーのローカルトランザクションの境界は、この接続ではサポートされていません

  関連事項:

  • LocalTransaction

• getMetaData

  ConnectionMetaData getMetaData() throws ResourceException

  アクティブな接続を介して表される、基になる EIS インスタンスに関する情報を取得します。

  戻り値:

  EIS インスタンスに関する情報を表す ConnectionMetaData インスタンス

  例外:

  ResourceException - 接続された EIS インスタンスに関する情報を取得できませんでした。エラーは、リソースアダプター内部、EIS 固有、通信関連である可能性があります。

• getResultSetInfo

  ResultSetInfo getResultSetInfo() throws ResourceException

  接続された EIS インスタンスでサポートされている ResultSet 機能に関する情報を取得します。

  戻り値:

  ResultSetInfo インスタンス

  例外:

  ResourceException - ResultSet 関連情報の取得に失敗しました

  NotSupportedException - ResultSet 機能はサポートされていません

• close

  void close() throws ResourceException

  アプリケーションレベルで接続ハンドルのクローズを開始します。クライアントは、閉じた接続を使用して EIS と対話しないでください。

  例外:

  ResourceException - 接続ハンドルのクローズに失敗すると例外がスローされます。

  無効な接続クローズ呼び出し（たとえば、すでに閉じられている接続ハンドルで close を呼び出す）も、この例外をスローする必要があります。