インターフェース 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
メソッドのサマリー
すべてのメソッド インスタンスメソッド 抽象メソッド 修飾子と型 メソッド 説明 ObjectSE
allocateConnection(ManagedConnectionFactory mcf, ConnectionRequestInfo cxRequestInfo)
メソッド allocateConnection は、リソースアダプターの接続ファクトリインスタンスによって呼び出されます。
メソッドの詳細
allocateConnection
ObjectSE allocateConnection(ManagedConnectionFactory mcf, ConnectionRequestInfo cxRequestInfo) throws ResourceException
メソッド allocateConnection は、リソースアダプターの接続ファクトリインスタンスによって呼び出されます。これにより、接続ファクトリインスタンス (リソースアダプターによって提供される) は、接続リクエストを ConnectionManager インスタンスに渡すことができます。
connectionRequestInfo パラメーターは、接続リクエストを処理するためのリソースアダプター固有の情報を表します。
- パラメーター:
mcf
- 接続の一致 / 作成を委譲するためにアプリケーションサーバーによって使用されますcxRequestInfo
- 接続リクエスト情報- 戻り値:
- EIS 固有の接続インターフェースを備えた接続ハンドル。
- 例外:
ResourceException
- 一般的な例外ApplicationServerInternalException
- アプリケーションサーバー固有の例外SecurityException
- セキュリティ関連のエラーResourceAllocationException
- 接続リクエストにシステムリソースを割り当てることができませんでしたResourceAdapterInternalException
- リソースアダプター関連のエラー状態