インターフェース ManagedConnectionFactory
- すべてのスーパーインターフェース:
SerializableSE
- バージョン:
- 0.6
- 作成者:
- Rahul Sharma
- 関連事項:
方法の概要
修飾子と型メソッド説明ConnectionFactory インスタンスを作成します。createConnectionFactory(ConnectionManager cxManager) ConnectionFactory インスタンスを作成します。createManagedConnection(SubjectSE subject, ConnectionRequestInfo cxRequestInfo) 基礎となる EIS リソースマネージャーへの新しい物理接続を作成します。booleanこの ManagedConnectionFactory が別の ManagedConnectionFactory と等しいかどうかを確認します。この ManagedConnectionFactory インスタンスのログライターを取得します。inthashCode()ManagedConnectionFactory のハッシュコードを返しますmatchManagedConnections(SetSE connectionSet, SubjectSE subject, ConnectionRequestInfo cxRequestInfo) 接続の候補セットから一致する接続を返します。voidこの ManagedConnectionFactory インスタンスのログライターを設定します。
メソッドの詳細
createConnectionFactory
ConnectionFactory インスタンスを作成します。Connection Factory インスタンスは、渡された ConnectionManager で初期化されます。管理シナリオでは、ConnectionManager はアプリケーションサーバーによって提供されます。- パラメーター:
cxManager- 作成された EIS 接続ファクトリインスタンスに関連付けられる ConnectionManager- 戻り値:
- EIS 固有の接続ファクトリインスタンスまたは jakarta.resource.cci.ConnectionFactory インスタンス
- 例外:
ResourceException- 一般的な例外ResourceAdapterInternalException- リソースアダプター関連のエラー状態
createConnectionFactory
ConnectionFactory インスタンスを作成します。Connection Factory インスタンスは、リソースアダプターによって提供されるデフォルトの ConnectionManager で初期化されます。- 戻り値:
- EIS 固有の接続ファクトリインスタンスまたは jakarta.resource.cci.ConnectionFactory インスタンス
- 例外:
ResourceException- 一般的な例外ResourceAdapterInternalException- リソースアダプター関連のエラー状態
createManagedConnection
ManagedConnection createManagedConnection(SubjectSE subject, ConnectionRequestInfo cxRequestInfo) throws ResourceException 基礎となる EIS リソースマネージャーへの新しい物理接続を作成します。ManagedConnectionFactory は、セキュリティ情報（サブジェクトとして渡される）と追加の ConnectionRequestInfo（ResourceAdapter に固有で、アプリケーションサーバーに対して不透明）を使用して、この新しい接続を作成します。
- パラメーター:
subject- 呼び出し元のセキュリティ情報cxRequestInfo- 追加のリソースアダプター固有の接続リクエスト情報- 戻り値:
- ManagedConnection インスタンス
- 例外:
ResourceException- 一般的な例外SecurityException- セキュリティ関連のエラーResourceAllocationException- 接続リクエストにシステムリソースを割り当てることができませんでしたResourceAdapterInternalException- リソースアダプター関連のエラー状態EISSystemException- EIS インスタンスの内部エラー状態
matchManagedConnections
ManagedConnection matchManagedConnections(SetSE connectionSet, SubjectSE subject, ConnectionRequestInfo cxRequestInfo) throws ResourceException 接続の候補セットから一致する接続を返します。ManagedConnectionFactory は、（サブジェクトのように）セキュリティ情報と、ConnectionRequestInfo および追加のリソースアダプター固有の条件を通じて提供される情報を使用して、照合を行います。照合に使用される条件はリソースアダプターに固有であり、コネクター仕様では規定されていないことに注意してください。
このメソッドは、接続割り当てリクエストの処理に最適な ManagedConnection インスタンスを返します。
- パラメーター:
connectionSet- 候補接続セットsubject- 呼び出し元のセキュリティ情報cxRequestInfo- 追加のリソースアダプター固有の接続リクエスト情報- 戻り値:
- リソースアダプターが許容可能な一致を検出した場合は ManagedConnection、それ以外の場合は null
- 例外:
ResourceException- 一般的な例外SecurityException- セキュリティ関連のエラーResourceAdapterInternalException- リソースアダプター関連のエラー状態NotSupportedException- 操作がサポートされていない場合
setLogWriter
この ManagedConnectionFactory インスタンスのログライターを設定します。
ログライターは、この ManagedConnectionfactory インスタンスのすべてのロギングおよびトレースメッセージが出力される文字出力ストリームです。
ApplicationServer は、出力ストリームと ManagedConnectionFactory の関連付けを管理します。ManagedConnectionFactory オブジェクトが作成されると、ログライターは最初は null になります。つまり、ログは無効になります。ログライターが ManagedConnectionFactory に関連付けられると、ManagedConnectionFactory インスタンスのログ記録とトレースが有効になります。
ManagedConnectionFactory によって作成された ManagedConnection インスタンスは、ログライターを「継承」します。ログライターは、ManagedConnection.setLogWriter を使用して ApplicationServer によってオーバーライドされ、ManagedConnection 固有のログとトレースを設定できます。
- パラメーター:
out- PrintWriter - エラーログとトレースのアウトストリーム- 例外:
ResourceException- 一般的な例外ResourceAdapterInternalException- リソースアダプター関連のエラー状態
getLogWriter
この ManagedConnectionFactory インスタンスのログライターを取得します。ログライターは、この ManagedConnectionFactory インスタンスのすべてのロギングおよびトレースメッセージが出力される文字出力ストリームです。
ApplicationServer は、出力ストリームと ManagedConnectionFactory の関連付けを管理します。ManagedConnectionFactory オブジェクトが作成されると、ログライターは最初は null になります。つまり、ログは無効になります。
- 戻り値:
- PrintWriter
- 例外:
ResourceException- 一般的な例外
hashCode
int hashCode()ManagedConnectionFactory のハッシュコードを返しますequals
この ManagedConnectionFactory が別の ManagedConnectionFactory と等しいかどうかを確認します。