パッケージ jakarta.faces.validator

クラス LongRangeValidator

  • 実装されたすべてのインターフェース:
    PartialStateHolderStateHolderValidatorEventListenerSE

    public class LongRangeValidator
    extends ObjectSE
    implements Validator, PartialStateHolder

    LongRangeValidator は、指定された最小値と最大値に対して対応するコンポーネントの値をチェックする Validator です。次のアルゴリズムが実装されています。

    • 渡された値が null の場合、すぐに終了します。
    • 現在のコンポーネントの値が浮動小数点型でない場合、または long に変換可能な文字列でない場合は、TYPE_MESSAGE_ID メッセージを含む ValidatorException をスローします。
    • この Validator で maximum プロパティと minimum プロパティの両方が構成されている場合は、両方の制限に対してコンポーネントの値を確認してください。コンポーネントの値がこの指定された範囲内にない場合は、NOT_IN_RANGE_MESSAGE_ID メッセージを含む ValidatorException をスローします。
    • この Validator で maximum プロパティが構成されている場合は、この制限に対してコンポーネントの値を確認してください。コンポーネントの値が指定された最大値より大きい場合は、MAXIMUM_MESSAGE_ID メッセージを含む ValidatorException をスローします。
    • この Validator で minimum プロパティが構成されている場合は、この制限に対してコンポーネントの値を確認してください。コンポーネントの値が指定された最小値より小さい場合は、MINIMUM_MESSAGE_ID メッセージを含む ValidatorException をスローします。

    ValidatorException がスローされる上記のすべてのケースで、検証パラメーターと一致するパラメーターがメッセージにある場合、これらのパラメーターの値は、コンバーター ID jakarta.faces.Number でアプリケーションに登録された Converter を使用して変換する必要があります。これにより、現在の Locale に従って値をローカライズできます。

    • フィールドの詳細

      • MAXIMUM_MESSAGE_ID

        public static final StringSE MAXIMUM_MESSAGE_ID

        最大値チェックが失敗した場合に作成される FacesMessage のメッセージ ID。このメッセージのメッセージフォーマット文字列には、オプションで次のプレースホルダーを含めることができます。

        • {0} は構成された最大値に置き換えられます。
        • {1} は、値がこのメッセージを生成した入力コンポーネントのラベルである String に置き換えられました。
        関連事項:
        定数フィールド値
      • MINIMUM_MESSAGE_ID

        public static final StringSE MINIMUM_MESSAGE_ID

        最小値チェックが失敗した場合に作成される FacesMessage のメッセージ ID。このメッセージのメッセージフォーマット文字列には、オプションで次のプレースホルダーを含めることができます。

        • {0} は、構成された最小値に置き換えられます。
        • {1} は、値がこのメッセージを生成した入力コンポーネントのラベルである String に置き換えられました。
        関連事項:
        定数フィールド値
      • NOT_IN_RANGE_MESSAGE_ID

        public static final StringSE NOT_IN_RANGE_MESSAGE_ID

        最大値または最小値のチェックが失敗し、このバリデーターの最大値と最小値の両方が設定されている場合に作成される FacesMessage のメッセージ識別子。このメッセージのメッセージフォーマット文字列には、オプションで次のプレースホルダーを含めることができます。

        • {0} は、構成された最小値に置き換えられます。
        • {1} は構成された最大値に置き換えられます。
        • {2} は、値がこのメッセージを生成した入力コンポーネントのラベルである String に置き換えられました。
        関連事項:
        定数フィールド値
      • TYPE_MESSAGE_ID

        public static final StringSE TYPE_MESSAGE_ID

        このコンポーネントの現在の値が正しい型でない場合に作成される FacesMessage のメッセージ ID。このメッセージのメッセージフォーマット文字列には、オプションで {0} プレースホルダーを含めることができます。このプレースホルダーは、このメッセージを生成した入力コンポーネントのラベルが値である String に置き換えられます。

        関連事項:
        定数フィールド値
    • コンストラクターの詳細

      • LongRangeValidator

        public LongRangeValidator()

        事前構成された制限のない Validator を構築します。

      • LongRangeValidator

        public LongRangeValidator​(long maximum)

        指定された事前構成された制限で Validator を構築します。

        パラメーター:
        maximum - 許可する最大値
      • LongRangeValidator

        public LongRangeValidator​(long maximum,
                                  long minimum)

        指定された事前構成された制限で Validator を構築します。

        パラメーター:
        maximum - 許可する最大値
        minimum - 許可する最小値
    • メソッドの詳細

      • getMaximum

        public long getMaximum()

        この Validator によって適用される最大値を返します。

        戻り値:
        最大
      • setMaximum

        public void setMaximum​(long maximum)

        この Validator によって適用される最大値を設定します。

        パラメーター:
        maximum - 新しい最大値
      • getMinimum

        public long getMinimum()

        この Validator によって適用される最小値を返します。

        戻り値:
        最小値
      • setMinimum

        public void setMinimum​(long minimum)

        この Validator によって適用される最小値を設定します。

        パラメーター:
        minimum - 新しい最小値
      • validate

        public void validate​(FacesContext context,
                             UIComponent component,
                             ObjectSE value)
                      throws ValidatorException
        インターフェースからコピーされた説明: Validator

        指定された UIComponent に対してこの Validator によって実装正しさのチェックを行います。違反が見つかった場合は、障害を説明する FacesMessage を含む ValidatorException がスローされます。

        バリデーターがバージョン 2 以降の仕様に完全に準拠するためには、null または空の値に対処することを特に意図していない限り、null または空の値の検証に失敗してはなりません。アプリケーション全体の <context-param> は、Jakarta Faces 1.2 用に設計されたバリデーターが Jakarta Faces 2 以降で動作できるようにするために提供されています。この下位互換性の動作を有効にするには、jakarta.faces.VALIDATE_EMPTY_FIELDS <context-param> を false に設定する必要があります。

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

        public int hashCode()
        オーバーライド:
        クラス ObjectSEhashCode 
      • saveState

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

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

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

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

         
         Object state = component.saveState(facesContext);
         
         

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

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

        次で指定:
        インターフェース StateHoldersaveState 
        パラメーター:
        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 の場合、アクションを実行せずに戻ります。

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

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

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

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

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

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

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

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

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

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

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

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

        次で指定:
        インターフェース PartialStateHolderclearInitialState