パッケージ jakarta.enterprise.event

列挙型クラス TransactionPhase

java.lang.ObjectSE
java.lang.EnumSE<TransactionPhase>
jakarta.enterprise.event.TransactionPhase
実装されたすべてのインターフェース:
SerializableSE、ComparableSE<TransactionPhase>、ConstableSE
public enum TransactionPhase extends EnumSE<TransactionPhase>

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

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

作成者:
Pete Muir, Gavin King

  • ネストされたクラスのサマリー

    クラス java.lang.EnumSE から継承されたネストクラス / インターフェース

    Enum.EnumDescSE<ESE extends EnumSE<ESE>>

  • 列挙定数のサマリー

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

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    static TransactionPhase
    valueOf(StringSE name)
    指定された名前でこのクラスの列挙型定数を返します。
    static TransactionPhase[]
    values()
    この列挙型クラスの定数を含む配列を、宣言されている順序で返します。

    クラス java.lang.EnumSE から継承されたメソッド

    clone, compareToSE, describeConstable, equalsSE, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOfSE

    クラス java.lang.ObjectSE から継承されたメソッド

    getClass, notify, notifyAll, wait, waitSE, waitSE

  • 列挙型定数の詳細

    • 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()
      この列挙型クラスの定数を含む配列を、宣言されている順序で返します。
      戻り値:
      この列挙型クラスの定数を宣言された順序で含む配列

    • valueOf

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