パッケージ jakarta.enterprise.event

列挙型 TransactionPhase

  • 実装されたすべてのインターフェース:
    SerializableSE, ComparableSE<TransactionPhase>
    public enum TransactionPhase
extends EnumSE<TransactionPhase>

    さまざまな種類のトランザクションオブザーバーメソッドを、すぐに通知される通常のオブザーバーメソッドと区別します。

    トランザクションオブザーバーメソッドは、イベントが発生したトランザクションの完了前または完了フェーズ中にイベント通知を受け取るオブザーバーメソッドです。イベントの発生時に進行中のトランザクションがない場合は、他のオブザーバーと同時に通知されます。トランザクションが進行中であるが、トランザクションがすでにロールバック対象としてマークされているか、jakarta.transaction.Synchronization コールバックを登録できない状態にあるため、jakarta.transaction.Synchronization コールバックを登録できない場合、BEFORE_COMPLETION、AFTER_COMPLETION、AFTER_FAILURE オブザーバーメソッドは他のオブザーバーと同時に通知されます。ただし、AFTER_SUCCESS オブザーバーメソッドはスキップされます。

    作成者:
    Pete Muir, Gavin King

    • 列挙定数のサマリー

      列挙型定数  
      列挙定数 説明
      AFTER_COMPLETION
      トランザクションの完了後フェーズ中に呼び出される、完了後オブザーバーメソッドを識別します。
      AFTER_FAILURE
      トランザクションが失敗した場合にのみ、トランザクションの完了後フェーズ中に呼び出される失敗後オブザーバーメソッドを識別します。
      AFTER_SUCCESS
      トランザクションが正常に完了した場合にのみ、トランザクションの完了後フェーズ中に呼び出される成功後オブザーバーメソッドを識別します。
      BEFORE_COMPLETION
      トランザクションの完了前フェーズ中に呼び出される、完了前オブザーバーメソッドを識別します。
      IN_PROGRESS
      イベントが発生したときに呼び出される通常のオブザーバーメソッドを識別します。

    • 列挙定数の詳細

      • IN_PROGRESS

        public static final TransactionPhase IN_PROGRESS

        イベントが発生したときに呼び出される通常のオブザーバーメソッドを識別します。

      • BEFORE_COMPLETION

        public static final TransactionPhase BEFORE_COMPLETION

        トランザクションの完了前フェーズ中に呼び出される、完了前オブザーバーメソッドを識別します。

        進行中のトランザクションがない場合、またはトランザクションは進行中であるが、トランザクションがすでにロールバック対象としてマークされているか、jakarta.transaction.Synchronization コールバックを登録できない状態にあるために、jakarta.transaction.Synchronization コールバックを登録できない場合は、トランザクションオブザーバーに通知されます。

      • AFTER_COMPLETION

        public static final TransactionPhase AFTER_COMPLETION

        トランザクションの完了後フェーズ中に呼び出される、完了後オブザーバーメソッドを識別します。

        進行中のトランザクションがない場合、またはトランザクションは進行中であるが、トランザクションがすでにロールバック対象としてマークされているか、jakarta.transaction.Synchronization コールバックを登録できない状態にあるために、jakarta.transaction.Synchronization コールバックを登録できない場合は、トランザクションオブザーバーに通知されます。

      • AFTER_FAILURE

        public static final TransactionPhase AFTER_FAILURE

        トランザクションが失敗した場合にのみ、トランザクションの完了後フェーズ中に呼び出される失敗後オブザーバーメソッドを識別します。

        進行中のトランザクションがない場合、またはトランザクションは進行中であるが、トランザクションがすでにロールバック対象としてマークされているか、jakarta.transaction.Synchronization コールバックを登録できない状態にあるために、jakarta.transaction.Synchronization コールバックを登録できない場合にも、トランザクションオブザーバーが呼び出されることが通知されます。

      • AFTER_SUCCESS

        public static final TransactionPhase AFTER_SUCCESS

        トランザクションが正常に完了した場合にのみ、トランザクションの完了後フェーズ中に呼び出される成功後オブザーバーメソッドを識別します。

    • メソッドの詳細

      • values

        public static TransactionPhase[] values()
        この列挙型の定数を含む配列を、宣言されている順序で返します。このメソッドは、次のように定数を反復するために使用できます。
        for (TransactionPhase c : TransactionPhase.values())
    System.out.println(c);
        戻り値:
        この列挙型の定数を宣言されている順序で含む配列

      • valueOf

        public static TransactionPhase valueOf​(StringSE name)
        指定された名前を持つこの型の列挙定数を返します。文字列は、この型の列挙定数を宣言するために使用される識別子と正確に一致する必要があります。(余分な空白文字は許可されません。)
        パラメーター:
        name - 返される列挙定数の名前。
        戻り値:
        指定された名前の列挙定数
        例外:
        IllegalArgumentExceptionSE - この列挙型に指定された名前の定数がない場合
        NullPointerExceptionSE - 引数が null の場合