DoubleRangeValidator (Jakarta EE Platform API)

java.lang.ObjectSE
- jakarta.faces.validator.DoubleRangeValidator

実装されているすべてのインターフェース:
PartialStateHolder, StateHolder, Validator, EventListenerSE
```
public class DoubleRangeValidator
extends ObjectSE
implements Validator, PartialStateHolder
```
DoubleRangeValidator は、対応するコンポーネントの値を指定された最小値と最大値に対してチェックする Validator です。次のアルゴリズムが実装されています。
- 渡された値が null の場合、すぐに終了します。
- 現在のコンポーネントの値が浮動小数点型または double に変換可能な文字列でない場合は、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 に従って値をローカライズできます。

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static StringSE`	`MAXIMUM_MESSAGE_ID` 最大値チェックが失敗した場合に作成される `FacesMessage` のメッセージ ID。
`static StringSE`	`MINIMUM_MESSAGE_ID` 最小値チェックが失敗した場合に作成される `FacesMessage` のメッセージ ID。
`static StringSE`	`NOT_IN_RANGE_MESSAGE_ID` 最大値または最小値のチェックが失敗し、このバリデーターの最大値と最小値の両方が設定されている場合に作成される `FacesMessage` のメッセージ識別子。
`static StringSE`	`TYPE_MESSAGE_ID` このコンポーネントの現在の値が正しい型でない場合に作成される `FacesMessage` のメッセージ ID。
`static StringSE`	`VALIDATOR_ID` このコンバーターの標準コンバーター ID。

コンストラクターの概要

コンストラクター
コンストラクターと説明
`DoubleRangeValidator()` 事前構成された制限のない `Validator` を構築します。
`DoubleRangeValidator(double maximum)` 指定された事前構成された制限で `Validator` を構築します。
`DoubleRangeValidator(double maximum, double minimum)` 指定された事前構成された制限で `Validator` を構築します。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`clearInitialState()` PartialStateHolder を非デルタ追跡状態にリセットします。
`boolean`	`equals(ObjectSE otherObj)` デフォルトの equals メソッドをオーバーライドして、DoubleRangeValidator インスタンスを比較するときに最小値と最大値を考慮に入れます。
`double`	`getMaximum()` この `Validator` または `Double.MAX_VALUE` が設定されていない場合に適用される最大値を返します。
`double`	`getMinimum()` この `Validator` によって適用される最小値を返します。設定されていない場合は `Double.MIN_VALUE` を返します。
`int`	`hashCode()` デフォルトのハッシュコードメソッドをオーバーライドして、ハッシュコードを生成するときに最小値と最大値を考慮します。
`boolean`	`initialStateMarked()` デルタ状態の変更が追跡されている場合は `true` を返し、それ以外の場合は `false` を返します。
`boolean`	`isTransient()` true の場合、このインターフェースを実装するオブジェクトは、状態の保存または復元に参加してはなりません。
`void`	`markInitialState()` ランタイムは、コンポーネントが初期状態であることを示すために、適切な時間にビュー内のこのインターフェースの各インスタンスで `PartialStateHolder.markInitialState()` メソッドが呼び出されることを確認する必要があります。
`void`	`restoreState(FacesContext context, ObjectSE state)` state オブジェクトのエントリから状態を復元するために必要な処理を実行します。
`ObjectSE`	`saveState(FacesContext context)` インスタンスの状態を `Serializable` オブジェクトとして取得します。
`void`	`setMaximum(double maximum)` この `Validator` によって適用される最大値を設定します。
`void`	`setMinimum(double minimum)` この `Validator` によって適用される最小値を設定します。
`void`	`setTransient(boolean transientValue)` このインターフェースを実装するオブジェクトが状態の保存または復元に参加する必要があるかどうかを示します。
`void`	`validate(FacesContext context, UIComponent component, ObjectSE value)` 指定された `UIComponent` に対してこの `Validator` によって実装正しさのチェックを行います。

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, finalizeSE, getClassSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- フィールドの詳細
  - VALIDATOR_ID
```
public static final StringSE VALIDATOR_ID
```
    このコンバーターの標準コンバーター ID。
    関連事項:
    定数フィールド値
  - 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 に置き換えられます。
    関連事項:
    定数フィールド値
- コンストラクターの詳細
  - DoubleRangeValidator
```
public DoubleRangeValidator()
```
    事前構成された制限のない Validator を構築します。
  - DoubleRangeValidator
```
public DoubleRangeValidator(double maximum)
```
    指定された事前構成された制限で Validator を構築します。
    パラメーター:
    maximum - 許可する最大値
  - DoubleRangeValidator
```
public DoubleRangeValidator(double maximum,
                            double minimum)
```
    指定された事前構成された制限で Validator を構築します。
    パラメーター:
    maximum - 許可する最大値
    minimum - 許可する最小値
- メソッドの詳細
  - getMaximum
```
public double getMaximum()
```
    この Validator または Double.MAX_VALUE が設定されていない場合に適用される最大値を返します。
    戻り値:
    最大
  - setMaximum
```
public void setMaximum(double maximum)
```
    この Validator によって適用される最大値を設定します。
    パラメーター:
    maximum - 新しい最大値
  - getMinimum
```
public double getMinimum()
```
    この Validator によって適用される最小値を返します。設定されていない場合は Double.MIN_VALUE を返します。
    戻り値:
    最小値
  - setMinimum
```
public void setMinimum(double 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 Server Faces 1.2 用に設計されたバリデーターが Jakarta Server Faces 2 以降で動作できるようにするために提供されています。この下位互換性の動作を有効にするには、jakarta.faces.VALIDATE_EMPTY_FIELDS <context-param> を false に設定する必要があります。
    次で指定:
    インターフェース Validator の validate
    パラメーター:
    context - 処理中のリクエストの FacesContext
    component - 正当性をチェックしている UIComponent
    value - 検証する値
    例外:
    NullPointerExceptionSE - context または component が null の場合
    ValidatorException - 検証が失敗した場合
  - equals
```
public boolean equals(ObjectSE otherObj)
```
    デフォルトの equals メソッドをオーバーライドして、DoubleRangeValidator インスタンスを比較するときに最小値と最大値を考慮に入れます。
    オーバーライド:
    クラス ObjectSE の equalsSE
    パラメーター:
    otherObj - 比較するオブジェクト。
    戻り値:
    等しい場合は true、そうでない場合は false。
  - hashCode
```
public int hashCode()
```
    デフォルトのハッシュコードメソッドをオーバーライドして、ハッシュコードを生成するときに最小値と最大値を考慮します。
    オーバーライド:
    クラス ObjectSE の hashCodeSE
    戻り値:
    ハッシュコード。
  - 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

クラス DoubleRangeValidator

フィールドのサマリー

コンストラクターの概要

メソッドのサマリー

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

フィールドの詳細

VALIDATOR_ID

MAXIMUM_MESSAGE_ID

MINIMUM_MESSAGE_ID

NOT_IN_RANGE_MESSAGE_ID

TYPE_MESSAGE_ID

コンストラクターの詳細

DoubleRangeValidator

DoubleRangeValidator

DoubleRangeValidator

メソッドの詳細

getMaximum

setMaximum

getMinimum

setMinimum

validate

equals

hashCode

saveState

restoreState

isTransient

setTransient

markInitialState

initialStateMarked

clearInitialState