パッケージ jakarta.resource.spi

インターフェース ConnectionEventListener

  • すべてのスーパーインターフェース:
    EventListenerSE
    public interface ConnectionEventListener
extends EventListenerSE
    ConnectionEventListener インターフェースは、アプリケーションサーバーが ManagedConnection インスタンスから通知を受信できるようにするイベントコールバックメカニズムを提供します。

    アプリケーションサーバーは、これらのイベント通知を使用して、接続プールを管理し、無効または終了した接続をクリーンアップし、ローカルトランザクションを管理します。

    アプリケーションサーバーは ConnectionEventListener インターフェースを実装します。ManagedConnection.addConnectionEventListener メソッドを使用して、接続リスナーを ManagedConnection インスタンスに登録します。

    バージョン:
    0.5
    作成者:
    Rahul Sharma
    関連事項:
    ConnectionEvent

    • メソッドの詳細

      • connectionClosed

        void connectionClosed​(ConnectionEvent event)
        アプリケーションコンポーネントが接続を閉じたことを通知します。

        ManagedConnection インスタンスは、アプリケーションコンポーネントが接続ハンドルを閉じるときに、ConnectionEventListener.connectionClosed メソッドを呼び出すことにより、登録されているリスナーのセットに通知します。アプリケーションサーバーは、この接続クローズイベントを使用して、ManagedConnection インスタンスを接続プールに戻します。

        パラメーター:
        event - イベントのソースを説明するイベントオブジェクト

      • localTransactionStarted

        void localTransactionStarted​(ConnectionEvent event)
        ResourceManager ローカルトランザクションが ManagedConnection インスタンスで開始されたことを通知します。
        パラメーター:
        event - イベントのソースを説明するイベントオブジェクト

      • localTransactionCommitted

        void localTransactionCommitted​(ConnectionEvent event)
        ResourceManager ローカルトランザクションが ManagedConnection インスタンスでコミットされたことを通知します。
        パラメーター:
        event - イベントのソースを説明するイベントオブジェクト

      • localTransactionRolledback

        void localTransactionRolledback​(ConnectionEvent event)
        ResourceManager ローカルトランザクションが ManagedConnection インスタンスでロールバックされたことを通知します。
        パラメーター:
        event - イベントのソースを説明するイベントオブジェクト

      • connectionErrorOccurred

        void connectionErrorOccurred​(ConnectionEvent event)
        接続関連のエラーを通知します。ManagedConnection インスタンスは、登録されているリスナーに物理接続関連のエラーの発生を通知するために、メソッド ConnectionEventListener.connectionErrorOccurred を呼び出します。イベント通知は、リソースアダプターが接続ハンドルを使用してアプリケーションコンポーネントに例外をスローする直前に発生します。connectionErrorOccurred メソッドは、関連付けられている ManagedConnection インスタンスが無効で使用できないことを示します。アプリケーションサーバーは、アプリケーションサーバー固有のクリーンアップ (たとえば、接続プールから ManagedConnection インスタンスを削除する) を開始し、次に ManagedConnection.destroy メソッドを呼び出して物理接続を破棄することで、接続エラーイベント通知を処理します。
        パラメーター:
        event - イベントのソースを説明するイベントオブジェクト