パッケージ jakarta.faces.event

クラス ValueChangeEvent

java.lang.ObjectSE
java.util.EventObjectSE
jakarta.faces.event.FacesEvent
jakarta.faces.event.ValueChangeEvent
実装されたすべてのインターフェース:
SerializableSE
public class ValueChangeEvent extends FacesEvent

ValueChangeEvent は、ユーザーインターフェースアクティビティの結果として、ソースコンポーネントのローカル値が変更されたという通知です。新しい値の検証が正常に完了しない限り、これは発生しません。

関連事項:

  • コンストラクターの詳細

    • ValueChangeEvent

      public ValueChangeEvent(UIComponent component, ObjectSE oldValue, ObjectSE newValue)

      指定されたソースコンポーネント、古い値、新しい値から新しいイベントオブジェクトを構築します。

      このイベントのデフォルトの PhaseId は PhaseId.ANY_PHASE です。

      パラメーター:
      component - このイベントのソース UIComponent
      oldValue - この UIComponent の以前のローカル値
      newValue - UIComponent の新しいローカル値
      例外:
      IllegalArgumentExceptionSE - component が null の場合

    • ValueChangeEvent

      public ValueChangeEvent(FacesContext facesContext, UIComponent component, ObjectSE oldValue, ObjectSE newValue)

      Faces コンテキスト、指定されたソースコンポーネント、古い値と新しい値から新しいイベントオブジェクトを構築します。

      このイベントのデフォルトの PhaseId は PhaseId.ANY_PHASE です。

      パラメーター:
      facesContext - Faces コンテキスト。
      component - このイベントのソース UIComponent
      oldValue - この UIComponent の以前のローカル値
      newValue - UIComponent の新しいローカル値
      例外:
      IllegalArgumentExceptionSE - component が null の場合

  • メソッドの詳細

    • getOldValue

      public ObjectSE getOldValue()

      ソース UIComponent の前のローカル値を返します。

      戻り値:
      以前のローカル値

    • getNewValue

      public ObjectSE getNewValue()

      ソース UIComponent の現在のローカル値を返します。

      戻り値:
      現在のローカル値

    • isAppropriateListener

      public boolean isAppropriateListener(FacesListener listener)
      クラスからコピーされた説明: FacesEvent

      この FacesListener がこのイベントがサポートするリスナークラスのインスタンスである場合、true を返します。通常、これは、リスナークラスの "instanceof" チェックによって実現されます。

      次で指定:
      クラス FacesEvent の isAppropriateListener 
      パラメーター:
      listener - 評価する FacesListener
      戻り値:
      適切なインスタンスである場合は true、そうでない場合は false。

    • processListener

      public void processListener(FacesListener listener)
      クラスからコピーされた説明: FacesEvent

      適切なメカニズムにより、この FacesEvent を指定された FacesListener にブロードキャストします。通常、これはイベント処理メソッドを呼び出し、この FacesEvent をパラメーターとして渡すことで実現されます。

      次で指定:
      クラス FacesEvent の processListener 
      パラメーター:
      listener - この FacesEvent を送信する FacesListener
      例外:
      AbortProcessingException - Jakarta Faces 実装に、現在のイベントでこれ以上の処理を実行しないことを通知します