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

フィールドのサマリー
フィールド
修飾子と型
フィールド
説明
static final StringSE
MAXIMUM_MESSAGE_ID
最大値チェックが失敗した場合に作成される FacesMessage のメッセージ ID。
static final StringSE
MINIMUM_MESSAGE_ID
最小値チェックが失敗した場合に作成される FacesMessage のメッセージ ID。
static final StringSE
NOT_IN_RANGE_MESSAGE_ID
最大値または最小値のチェックが失敗し、このバリデーターの最大値と最小値の両方が設定されている場合に作成される FacesMessage のメッセージ識別子。
static final StringSE
TYPE_MESSAGE_ID
このコンポーネントの現在の値が正しい型でない場合に作成される FacesMessage のメッセージ ID。
static final StringSE
VALIDATOR_ID
このコンバーターの標準コンバーター ID。
コンストラクターの概要
コンストラクター
コンストラクター
説明
LongRangeValidator()
事前構成された制限のない Validator を構築します。
LongRangeValidator(long maximum)
指定された事前構成された制限で Validator を構築します。
LongRangeValidator(long maximum, long minimum)
指定された事前構成された制限で Validator を構築します。
メソッドのサマリー
修飾子と型
メソッド
説明
void
clearInitialState()
PartialStateHolder を非デルタ追跡状態にリセットします。
boolean
equals(ObjectSE otherObj)
long
getMaximum()
この Validator によって適用される最大値を返します。
long
getMinimum()
この Validator によって適用される最小値を返します。
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(long maximum)
この Validator によって適用される最大値を設定します。
void
setMinimum(long minimum)
この Validator によって適用される最小値を設定します。
void
setTransient(boolean transientValue)
このインターフェースを実装するオブジェクトが状態の保存または復元に参加する必要があるかどうかを示します。
void
validate(FacesContext context, UIComponent component, ObjectSE value)
指定された UIComponent に対してこの Validator によって実装正しさのチェックを行います。
クラス java.lang.ObjectSE から継承されたメソッド
clone, finalize, getClass, notify, notifyAll, toString, wait, 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 に置き換えられます。
  関連事項:
  定数フィールド値
コンストラクターの詳細
- 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 - 処理中のリクエストの FacesContext
  component - 正当性をチェックしている UIComponent
  value - 検証する値
  例外:
  NullPointerExceptionSE - context または component が null の場合
  ValidatorException - 検証が失敗した場合
- equals
  public boolean equals(ObjectSE otherObj)
  オーバーライド:
  クラス ObjectSE の equalsSE
- hashCode
  public int hashCode()
  オーバーライド:
  クラス ObjectSE の hashCode
- 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

クラス LongRangeValidator

フィールドのサマリー

コンストラクターの概要

メソッドのサマリー

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

フィールドの詳細

VALIDATOR_ID

MAXIMUM_MESSAGE_ID

MINIMUM_MESSAGE_ID

NOT_IN_RANGE_MESSAGE_ID

TYPE_MESSAGE_ID

コンストラクターの詳細

LongRangeValidator

LongRangeValidator

LongRangeValidator

メソッドの詳細

getMaximum

setMaximum

getMinimum

setMinimum

validate

equals

hashCode

saveState

restoreState

isTransient

setTransient

markInitialState

initialStateMarked

clearInitialState