パッケージ jakarta.resource.spi

インターフェース ConnectionManager

  • すべてのスーパーインターフェース:
    SerializableSE

    public interface ConnectionManager
    extends SerializableSE

    ConnectionManager インターフェースは、リソースアダプターがアプリケーションサーバーに接続リクエストを渡すためのフックを提供します。

    アプリケーションサーバーは、ConnectionManager インターフェースの実装を提供します。この実装は、特定の型のリソースアダプターまたは接続ファクトリインターフェースに固有のものではありません。

    ConnectionManager 実装は、アプリケーションサーバーに委譲して、アプリケーションサーバーがサービス品質(QoS)(セキュリティ、接続プール管理、トランザクション管理、エラーログ / トレース)を提供できるようにします。

    アプリケーションサーバーは、リソースアダプターや EIS 固有のメカニズムに関係なく、これらのサービスを一般的な方法で実装します。コネクターアーキテクチャは、アプリケーションサーバーがこれらのサービスを実装する方法を指定していません。実装はアプリケーションサーバーに固有です。

    アプリケーションサーバーがそのサービスをフックインした後、接続リクエストは、新しい物理接続の作成または既存の物理接続の照合のために ManagedConnectionFactory インスタンスに委譲されます。

    java.io.Serializable インターフェースを実装するには、ConnectionManager インターフェースの実装クラスが必要です。

    非管理対象アプリケーションのシナリオでは、ConnectionManager 実装クラスは、リソースアダプター(デフォルトの ConnectionManager 実装として)またはアプリケーション開発者のいずれかによって提供されます。どちらの場合も、QOS はサードパーティベンダーによってコンポーネントとして提供できます。

    導入:
    0.6
    作成者:
    Rahul Sharma
    関連事項:
    ManagedConnectionFactory
    • メソッドの詳細

      • allocateConnection

        ObjectSE allocateConnection​(ManagedConnectionFactory mcf,
                                  ConnectionRequestInfo cxRequestInfo)
                           throws ResourceException

        メソッド allocateConnection は、リソースアダプターの接続ファクトリインスタンスによって呼び出されます。これにより、接続ファクトリインスタンス (リソースアダプターによって提供される) は、接続リクエストを ConnectionManager インスタンスに渡すことができます。

        connectionRequestInfo パラメーターは、接続リクエストを処理するためのリソースアダプター固有の情報を表します。

        パラメーター:
        mcf - 接続の一致 / 作成を委譲するためにアプリケーションサーバーによって使用されます
        cxRequestInfo - 接続リクエスト情報
        戻り値:
        EIS 固有の接続インターフェースを備えた接続ハンドル。
        例外:
        ResourceException - 一般的な例外
        ApplicationServerInternalException - アプリケーションサーバー固有の例外
        SecurityException - セキュリティ関連のエラー
        ResourceAllocationException - 接続リクエストにシステムリソースを割り当てることができませんでした
        ResourceAdapterInternalException - リソースアダプター関連のエラー状態