パッケージ jakarta.faces.validator

クラス RegexValidator

java.lang.ObjectSE
jakarta.faces.validator.RegexValidator
実装されているすべてのインターフェース:
PartialStateHolder、StateHolder、Validator、EventListenerSE
public class RegexValidator extends ObjectSE implements Validator, PartialStateHolder

正規表現（パターンプロパティ）をチェックするバリデーター。パターンは、java.util.regex 標準に準拠する文字列に解決される必要があります。

導入:
2.0

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    static final StringSE
    MATCH_EXCEPTION_MESSAGE_ID
    PatternSyntaxException のために、getPattern() から返されたパターンと値を照合する動作が失敗した場合に作成される FacesMessage のメッセージ識別子。
    static final StringSE
    NOT_MATCHED_MESSAGE_ID
    値がパターンと一致しないために、getPattern() から返されたパターンと値を照合する動作が失敗した場合に作成される FacesMessage のメッセージ識別子。
    static final StringSE
    PATTERN_NOT_SET_MESSAGE_ID
    getPattern() から返された値が null または空の文字列の場合に作成される FacesMessage のメッセージ識別子。
    static final StringSE
    VALIDATOR_ID
    このコンバーターの標準コンバーター ID。

  • コンストラクターの概要

    コンストラクター
    コンストラクター
    説明
    RegexValidator()

  • 方法の概要

    修飾子と型
    メソッド
    説明
    void
    clearInitialState()
    PartialStateHolder を非デルタ追跡状態にリセットします。
    StringSE
    getPattern()
    評価時に正規表現パターンを生成する ValueExpression を返します。
    boolean
    initialStateMarked()
    デルタ状態の変更が追跡されている場合は true を返し、それ以外の場合は false を返します。
    boolean
    isTransient()
    true の場合、このインターフェースを実装するオブジェクトは、状態の保存または復元に参加してはなりません。
    void
    markInitialState()
    ランタイムは、コンポーネントが初期状態であることを示すために、適切な時間にビュー内のこのインターフェースの各インスタンスで PartialStateHolder.markInitialState() メソッドが呼び出されることを確認する必要があります。
    void
    restoreState(FacesContext context, ObjectSE state)
    state オブジェクトのエントリから状態を復元するために必要な処理を実行します。
    ObjectSE
    saveState(FacesContext context)
    インスタンスの状態を Serializable オブジェクトとして取得します。
    void
    setPattern(StringSE pattern)
    検証する正規表現プロパティ。
    void
    setTransient(boolean transientValue)
    このインターフェースを実装するオブジェクトが状態の保存または復元に参加する必要があるかどうかを示します。
    void
    validate(FacesContext context, UIComponent component, ObjectSE value)
    正規表現パターンに対して文字列を検証します。

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

    clone, equalsSE, finalize, getClass, hashCode, notify, notifyAll, toString, wait, waitSE, waitSE

  • フィールドの詳細

    • VALIDATOR_ID

      public static final StringSE VALIDATOR_ID

      このコンバーターの標準コンバーター ID。

      関連事項:

    • PATTERN_NOT_SET_MESSAGE_ID

      public static final StringSE PATTERN_NOT_SET_MESSAGE_ID

      getPattern() から返された値が null または空の文字列の場合に作成される FacesMessage のメッセージ識別子。

      関連事項:

    • NOT_MATCHED_MESSAGE_ID

      public static final StringSE NOT_MATCHED_MESSAGE_ID

      値がパターンと一致しないために、getPattern() から返されたパターンと値を照合する動作が失敗した場合に作成される FacesMessage のメッセージ識別子。

      関連事項:

    • MATCH_EXCEPTION_MESSAGE_ID

      public static final StringSE MATCH_EXCEPTION_MESSAGE_ID

      PatternSyntaxException のために、getPattern() から返されたパターンと値を照合する動作が失敗した場合に作成される FacesMessage のメッセージ識別子。

      関連事項:

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

    • RegexValidator

      public RegexValidator()

  • メソッドの詳細

    • setPattern

      public void setPattern(StringSE pattern)

      検証する正規表現プロパティ。

      パラメーター:
      pattern - 正規表現パターン

    • getPattern

      public StringSE getPattern()

      評価時に正規表現パターンを生成する ValueExpression を返します。

      戻り値:
      パターン

    • validate

      public void validate(FacesContext context, UIComponent component, ObjectSE value)

      正規表現パターンに対して文字列を検証します。検証に合格するには、完全な正規表現パターンに一致する必要があります。

      次で指定:
      インターフェース Validator の validate 
      パラメーター:
      context - 処理中のリクエストの FacesContext
      component - 正当性をチェックしている UIComponent
      value - 検証する値
      例外:
      NullPointerExceptionSE - context または component が null の場合
      ValidatorException - 検証が失敗した場合

    • saveState

      public ObjectSE saveState(FacesContext context)
      インターフェースからコピーされた説明: StateHolder

      インスタンスの状態を Serializable オブジェクトとして取得します。

      このインターフェースを実装するクラスが、StateHolder を実装するインスタンス（イベントハンドラー、バリデーターなどを含む UIComponent など）への参照を持っている場合、このメソッドはそれらすべてのインスタンスで StateHolder.saveState(jakarta.faces.context.FacesContext) メソッドも呼び出す必要があります。このメソッドは、子とファセットの状態を保存してはなりませんそれは StateManager を介して行われます

      このメソッドは、実装オブジェクトの状態を変更してはなりません。つまり、このコードを実行した後:

       
 Object state = component.saveState(facesContext);

      component は、実行前と同じでなければなりません。

      このメソッドからの戻り値は Serializable でなければなりません

      次で指定:
      インターフェース StateHolder の saveState 
      パラメーター:
      context - Faces コンテキスト。
      戻り値:
      保存された状態。

    • restoreState

      public void restoreState(FacesContext context, ObjectSE state)
      インターフェースからコピーされた説明: StateHolder

      state オブジェクトのエントリから状態を復元するために必要な処理を実行します。

      このインターフェースを実装するクラスが、StateHolder も実装するインスタンスへの参照を持っている場合（イベントハンドラー、バリデーターなどを備えた UIComponent など）、このメソッドはそれらすべてのインスタンスで StateHolder.restoreState(jakarta.faces.context.FacesContext, java.lang.Object) メソッドも呼び出す必要があります。

      state 引数が null の場合、アクションを実行せずに戻ります。

      次で指定:
      インターフェース StateHolder の restoreState 
      パラメーター:
      context - Faces コンテキスト。
      state - 状態。

    • isTransient

      public boolean isTransient()
      インターフェースからコピーされた説明: StateHolder

      true の場合、このインターフェースを実装するオブジェクトは、状態の保存または復元に参加してはなりません。

      次で指定:
      インターフェース StateHolder の isTransient 
      戻り値:
      一時的な場合は true、それ以外の場合は false。

    • setTransient

      public void setTransient(boolean transientValue)
      インターフェースからコピーされた説明: StateHolder

      このインターフェースを実装するオブジェクトが状態の保存または復元に参加する必要があるかどうかを示します。

      次で指定:
      インターフェース StateHolder の setTransient 
      パラメーター:
      transientValue - このオブジェクトが 状態の保存または復元に参加しない場合はブール値 true を渡し、それ以外の場合は false を渡します。

    • markInitialState

      public void markInitialState()
      インターフェースからコピーされた説明: PartialStateHolder

      ランタイムは、コンポーネントが初期状態であることを示すために、適切な時間にビュー内のこのインターフェースの各インスタンスで PartialStateHolder.markInitialState() メソッドが呼び出されることを確認する必要があります。インターフェースの実装者は、markInitialState() が呼び出されてから PartialStateHolder.clearInitialState() が呼び出されるまで PartialStateHolder.initialStateMarked() が true を返すことを確認する必要があります。その後、initialStateMarked() は false を返す必要があります。また、インスタンスが initialStateMarked() から true を返す間、実装は StateHolder.saveState(jakarta.faces.context.FacesContext) の実装で変更された状態のみを返す必要があります。

      次で指定:
      インターフェース PartialStateHolder の markInitialState 

    • initialStateMarked

      public boolean initialStateMarked()
      インターフェースからコピーされた説明: PartialStateHolder

      デルタ状態の変更が追跡されている場合は true を返し、それ以外の場合は false を返します。

      次で指定:
      インターフェース PartialStateHolder の initialStateMarked 
      戻り値:
      初期状態がマークされている場合は true、それ以外の場合は false。

    • clearInitialState

      public void clearInitialState()
      インターフェースからコピーされた説明: PartialStateHolder

      PartialStateHolder を非デルタ追跡状態にリセットします。

      次で指定:
      インターフェース PartialStateHolder の clearInitialState