パッケージ jakarta.resource.spi

インターフェース ManagedConnectionFactory

  • すべてのスーパーインターフェース:
    SerializableSE

    public interface ManagedConnectionFactory
    extends SerializableSE
    ManagedConnectionFactory インスタンスは、ManagedConnection と EIS 固有の接続ファクトリインスタンスの両方のファクトリです。このインターフェースは、ManagedConnection インスタンスの照合と作成のためのメソッドを提供することにより、接続プールをサポートします。ManagedConnectionFactory インスタンスは JavaBean である必要があります。
    バージョン:
    0.6
    作成者:
    Rahul Sharma
    関連事項:
    ManagedConnection
    • メソッドの詳細

      • 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 のハッシュコードを返します
        オーバーライド:
        クラス ObjectSEhashCode 
        戻り値:
        ManagedConnectionFactory のハッシュコード
      • equals

        boolean equals​(ObjectSE other)
        この ManagedConnectionFactory が別の ManagedConnectionFactory と等しいかどうかを確認します。
        オーバーライド:
        クラス ObjectSEequalsSE 
        パラメーター:
        other - チェックする
        戻り値:
        2 つのインスタンスが等しい場合は true