パッケージ 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
関連事項:
  • 方法の概要

    修飾子と型
    メソッド
    説明
    メソッド allocateConnection は、リソースアダプターの接続ファクトリインスタンスによって呼び出されます。
  • メソッドの詳細

    • allocateConnection

      ObjectSE allocateConnection(ManagedConnectionFactory mcf, ConnectionRequestInfo cxRequestInfo) throws ResourceException

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

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

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