クラス LongRangeValidator
- java.lang.ObjectSE
-
- jakarta.faces.validator.LongRangeValidator
- 実装されているすべてのインターフェース:
PartialStateHolder、StateHolder、Validator、EventListenerSE
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がスローされる上記のすべてのケースで、検証パラメーターと一致するパラメーターがメッセージにある場合、これらのパラメーターの値は、コンバーター IDjakarta.faces.Numberでアプリケーションに登録されたConverterを使用して変換する必要があります。これにより、現在のLocaleに従って値をローカライズできます。
フィールドのサマリー
フィールド 修飾子と型 フィールド 説明 static StringSEMAXIMUM_MESSAGE_ID最大値チェックが失敗した場合に作成されるFacesMessageのメッセージ ID。static StringSEMINIMUM_MESSAGE_ID最小値チェックが失敗した場合に作成されるFacesMessageのメッセージ ID。static StringSENOT_IN_RANGE_MESSAGE_ID最大値または最小値のチェックが失敗し、このバリデーターの最大値と最小値の両方が設定されている場合に作成されるFacesMessageのメッセージ識別子。static StringSETYPE_MESSAGE_IDこのコンポーネントの現在の値が正しい型でない場合に作成されるFacesMessageのメッセージ ID。static StringSEVALIDATOR_IDこのコンバーターの標準コンバーター ID。
コンストラクターの概要
コンストラクター コンストラクター 説明 LongRangeValidator()事前構成された制限のないValidatorを構築します。LongRangeValidator(long maximum)指定された事前構成された制限でValidatorを構築します。LongRangeValidator(long maximum, long minimum)指定された事前構成された制限でValidatorを構築します。
メソッドのサマリー
すべてのメソッド インスタンスメソッド 具象メソッド 修飾子と型 メソッド 説明 voidclearInitialState()PartialStateHolder を非デルタ追跡状態にリセットします。booleanequals(ObjectSE otherObj)longgetMaximum()このValidatorによって適用される最大値を返します。longgetMinimum()このValidatorによって適用される最小値を返します。inthashCode()booleaninitialStateMarked()デルタ状態の変更が追跡されている場合はtrueを返し、それ以外の場合はfalseを返します。booleanisTransient()true の場合、このインターフェースを実装するオブジェクトは、状態の保存または復元に参加してはなりません。voidmarkInitialState()ランタイムは、コンポーネントが初期状態であることを示すために、適切な時間にビュー内のこのインターフェースの各インスタンスでPartialStateHolder.markInitialState()メソッドが呼び出されることを確認する必要があります。voidrestoreState(FacesContext context, ObjectSE state)state オブジェクトのエントリから状態を復元するために必要な処理を実行します。ObjectSEsaveState(FacesContext context)インスタンスの状態をSerializableオブジェクトとして取得します。voidsetMaximum(long maximum)このValidatorによって適用される最大値を設定します。voidsetMinimum(long minimum)このValidatorによって適用される最小値を設定します。voidsetTransient(boolean transientValue)このインターフェースを実装するオブジェクトが状態の保存または復元に参加する必要があるかどうかを示します。voidvalidate(FacesContext context, UIComponent component, ObjectSE value)
フィールドの詳細
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に設定する必要があります。- 次で指定:
- インターフェース
Validatorのvalidate - パラメーター:
context- 処理中のリクエストの FacesContextcomponent- 正当性をチェックしている UIComponentvalue- 検証する値- 例外:
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)
インターフェースからコピーされた説明:StateHolderstate オブジェクトのエントリから状態を復元するために必要な処理を実行します。
このインターフェースを実装するクラスが、StateHolder も実装するインスタンスへの参照を持っている場合(イベントハンドラー、バリデーターなどを備えた
UIComponentなど)、このメソッドはそれらすべてのインスタンスでStateHolder.restoreState(jakarta.faces.context.FacesContext, java.lang.Object)メソッドも呼び出す必要があります。state引数がnullの場合、アクションを実行せずに戻ります。- 次で指定:
- インターフェース
StateHolderのrestoreState - パラメーター:
context- Faces コンテキスト。state- 状態。
isTransient
public boolean isTransient()
インターフェースからコピーされた説明:StateHoldertrue の場合、このインターフェースを実装するオブジェクトは、状態の保存または復元に参加してはなりません。
- 次で指定:
- インターフェース
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()
インターフェースからコピーされた説明:PartialStateHolderPartialStateHolder を非デルタ追跡状態にリセットします。
- 次で指定:
- インターフェース
PartialStateHolderのclearInitialState