インターフェース ManagedConnectionFactory
- すべてのスーパーインターフェース:
SerializableSE
public interface ManagedConnectionFactory extends SerializableSE
ManagedConnectionFactory インスタンスは、ManagedConnection と EIS 固有の接続ファクトリインスタンスの両方のファクトリです。このインターフェースは、ManagedConnection インスタンスの照合と作成のためのメソッドを提供することにより、接続プールをサポートします。ManagedConnectionFactory インスタンスは JavaBean である必要があります。- バージョン:
- 0.6
- 作成者:
- Rahul Sharma
- 関連事項:
ManagedConnection
メソッドのサマリー
すべてのメソッド インスタンスメソッド 抽象メソッド 修飾子と型 メソッド 説明 ObjectSE
createConnectionFactory()
ConnectionFactory インスタンスを作成します。ObjectSE
createConnectionFactory(ConnectionManager cxManager)
ConnectionFactory インスタンスを作成します。ManagedConnection
createManagedConnection(SubjectSE subject, ConnectionRequestInfo cxRequestInfo)
基礎となる EIS リソースマネージャーへの新しい物理接続を作成します。boolean
equals(ObjectSE other)
この ManagedConnectionFactory が別の ManagedConnectionFactory と等しいかどうかを確認します。PrintWriterSE
getLogWriter()
この ManagedConnectionFactory インスタンスのログライターを取得します。int
hashCode()
ManagedConnectionFactory のハッシュコードを返しますManagedConnection
matchManagedConnections(SetSE connectionSet, SubjectSE subject, ConnectionRequestInfo cxRequestInfo)
接続の候補セットから一致する接続を返します。void
setLogWriter(PrintWriterSE out)
この ManagedConnectionFactory インスタンスのログライターを設定します。
メソッドの詳細
createConnectionFactory
ObjectSE createConnectionFactory(ConnectionManager cxManager) throws ResourceException
ConnectionFactory インスタンスを作成します。Connection Factory インスタンスは、渡された ConnectionManager で初期化されます。管理シナリオでは、ConnectionManager はアプリケーションサーバーによって提供されます。- パラメーター:
cxManager
- 作成された EIS 接続ファクトリインスタンスに関連付けられる ConnectionManager- 戻り値:
- EIS 固有の接続ファクトリインスタンスまたは jakarta.resource.cci.ConnectionFactory インスタンス
- 例外:
ResourceException
- 一般的な例外ResourceAdapterInternalException
- リソースアダプター関連のエラー状態
createConnectionFactory
ObjectSE createConnectionFactory() throws ResourceException
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
void setLogWriter(PrintWriterSE out) throws ResourceException
この ManagedConnectionFactory インスタンスのログライターを設定します。
ログライターは、この ManagedConnectionfactory インスタンスのすべてのロギングおよびトレースメッセージが出力される文字出力ストリームです。
ApplicationServer は、出力ストリームと ManagedConnectionFactory の関連付けを管理します。ManagedConnectionFactory オブジェクトが作成されると、ログライターは最初は null になります。つまり、ログは無効になります。ログライターが ManagedConnectionFactory に関連付けられると、ManagedConnectionFactory インスタンスのログ記録とトレースが有効になります。
ManagedConnectionFactory によって作成された ManagedConnection インスタンスは、ログライターを「継承」します。ログライターは、ManagedConnection.setLogWriter を使用して ApplicationServer によってオーバーライドされ、ManagedConnection 固有のログとトレースを設定できます。
- パラメーター:
out
- PrintWriter - エラーログとトレースのアウトストリーム- 例外:
ResourceException
- 一般的な例外ResourceAdapterInternalException
- リソースアダプター関連のエラー状態
getLogWriter
PrintWriterSE getLogWriter() throws ResourceException
この ManagedConnectionFactory インスタンスのログライターを取得します。ログライターは、この ManagedConnectionFactory インスタンスのすべてのロギングおよびトレースメッセージが出力される文字出力ストリームです。
ApplicationServer は、出力ストリームと ManagedConnectionFactory の関連付けを管理します。ManagedConnectionFactory オブジェクトが作成されると、ログライターは最初は null になります。つまり、ログは無効になります。
- 戻り値:
- PrintWriter
- 例外:
ResourceException
- 一般的な例外
hashCode
int hashCode()
ManagedConnectionFactory のハッシュコードを返します