ManagedConnectionFactory (Jakarta EE 8 Specification API)

すべてのスーパーインターフェース:
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 固有の接続ファクトリインスタンスまたは javax.resource.cci.ConnectionFactory インスタンス
    例外:
    ResourceException - 一般的な例外
    ResourceAdapterInternalException - リソースアダプター関連のエラー状態
  - createConnectionFactory
```
ObjectSE createConnectionFactory()
                        throws ResourceException
```
    ConnectionFactory インスタンスを作成します。Connection Factory インスタンスは、リソースアダプターによって提供されるデフォルトの ConnectionManager で初期化されます。
    戻り値:
    EIS 固有の接続ファクトリインスタンスまたは javax.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 のハッシュコードを返します
    オーバーライド:
    クラス ObjectSE の hashCodeSE
    戻り値:
    ManagedConnectionFactory のハッシュコード
  - equals
```
boolean equals(ObjectSE other)
```
    この ManagedConnectionFactory が別の ManagedConnectionFactory と等しいかどうかを確認します。
    オーバーライド:
    クラス ObjectSE の equalsSE
    戻り値:
    2 つのインスタンスが等しい場合は true

インターフェース ManagedConnectionFactory

メソッドのサマリー

メソッドの詳細

createConnectionFactory

createConnectionFactory

createManagedConnection

matchManagedConnections

setLogWriter

getLogWriter

hashCode

equals