パッケージ jakarta.resource.cci

インターフェース Connection

  • public interface Connection
    接続は、基盤となる物理接続にアクセスするためにクライアントが使用するアプリケーションレベルのハンドルを表します。Connection インスタンスに関連付けられている実際の物理接続は、ManagedConnection インスタンスで表されます。

    クライアントは、ConnectionFactory インスタンスで getConnection メソッドを使用して Connection インスタンスを取得します。接続は、0 個以上のインタラクションインスタンスに関連付けることができます。

    バージョン:
    0.8
    作成者:
    Rahul Sharma
    関連事項:
    ConnectionFactory, Interaction

    • 方法の概要

      すべてのメソッド   インスタンスメソッド   抽象メソッド  
      修飾子と型 メソッド 説明
      voidclose()
      アプリケーションレベルで接続ハンドルのクローズを開始します。
      InteractioncreateInteraction()
      この接続に関連付けられたインタラクションを作成します。
      LocalTransactiongetLocalTransaction()
      コンポーネントが接続上のリソースマネージャーのローカルトランザクションを区別できるようにする LocalTransaction インスタンスを返します。
      ConnectionMetaDatagetMetaData()
      アクティブな接続を介して表される、基になる EIS インスタンスに関する情報を取得します。
      ResultSetInfogetResultSetInfo()
      接続された EIS インスタンスでサポートされている ResultSet 機能に関する情報を取得します。

    • メソッドの詳細

      • 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 を呼び出す）も、この例外をスローする必要があります。