クラス BeanValidator

メソッドの詳細

• setValidationGroups

  public void setValidationGroups(StringSE validationGroups)

  この検証によってチェックされる検証をフィルタリングするために使用される検証グループのコンマ区切りリスト。validationGroupsArray 属性が省略されているか空の場合、検証グループは ブランチデフォルトから継承されます。ブランチデフォルトがない場合は、Default グループが使用されます。

  パラメーター:

  validationGroups - 検証グループのコンマ区切りリスト (スペースとコンマのみが null として扱われる文字列)

• getValidationGroups

  public StringSE getValidationGroups()

  制約をチェックするときに検証 API に渡される検証グループを返します。validationGroupsArray 属性が省略されているか空の場合、検証グループは ブランチデフォルトから継承されます。ブランチデフォルトがない場合は、Default グループが使用されます。

  戻り値:

  validatinGroups 属性の値。

• validate

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

  Bean 検証制約に従って値が有効であることを確認します。

  Validation.buildDefaultValidatorFactory() を呼び出して、ValidatorFactory インスタンスを取得します。

  validationGroupsArray を、このバリデーターのタグハンドラーによってコンポーネントに設定されたバリデーターグループを表す Class[] とします。最初の検索コンポーネントは、検証グループ値の検索を終了します。そのような値が見つからない場合は、検証グループの値として Default のクラス名を使用します。

  valueExpression は、引数コンポーネントで UIComponent.getValueExpression(java.lang.String) を呼び出して、リテラル文字列 "value" （引用符なし）を引数として渡したときの戻り値とします。このアプリケーションが Jakarta Expression Language のある環境で実行されている場合は、valueExpression から ValueReference を取得し、valueBaseClase は ValueReference.getBase() を呼び出して返された値、valueProperty は ValueReference.getProperty() を呼び出して返された値とします。Jakarta Expression Language の以前のバージョンが存在する場合は、適切な方法を使用して valueExpression をインスペクションし、valueBaseClass と valueProperty の値を導出します。

  ValueReference を取得できない場合は、何もせずに戻ってください。

  ValueReference.getBase() が null を返す場合は、何もせずに戻ります。

  ValidatorFactory から ValidatorContext を取得します。

  ValidatorFactory.getMessageInterpolator() から返された MessageInterpolator を、UIViewRoot.getLocale() から返された Locale を活用するもので装飾し、ValidatorContext.messageInterpolator(jakarta.validation.MessageInterpolator) を使用して ValidatorContext に保存します。

  validatorContext から Validator インスタンスを取得します。

  jakarta.validation.Validator から jakarta.validation.BeanDescriptor を取得します。BeanDescriptor の hasConstraints() が false を返す場合は、何もせずに戻ります。それ以外の場合は続行します。

  Validator.validateValue(java.lang.Class<T>, java.lang.String, java.lang.Object, java.lang.Class<?>...) を呼び出し、valueBaseClass、valueProperty、値引数、validatorGroupsArray を引数として渡します。

  返された Set<ConstraintViolation> が空でない場合は、Set の各要素について、FacesMessage を作成します。ここで、要約と詳細は ConstraintViolation.getMessage() の呼び出しからの戻り値です。そのようなすべての FacesMessage インスタンスを Collection にキャプチャーし、ValidatorException(java.util.Collection) に渡します。ENABLE_VALIDATE_WHOLE_BEAN_PARAM_NAME アプリケーションパラメーターが有効で、この Validator インスタンスに Default グループ以外の、または Default グループに加えて検証グループがある場合は、このフィールドが検証に失敗したことを記録して、ツリーの後半にある <f:validateWholeBean /> コンポーネントがクラスレベルの検証をスキップできるようにします。この特定のフィールドがプロパティである Bean。ENABLE_VALIDATE_WHOLE_BEAN_PARAM_NAME が設定されているかどうかに関係なく、新しい例外をスローします。

  返された Set が空の場合、ENABLE_VALIDATE_WHOLE_BEAN_PARAM_NAME アプリケーションパラメーターが有効であり、この Validator インスタンスには Default グループ以外の、または Default グループに加えて検証グループがあります。このフィールドが検証に合格したことを記録して、ツリーの後半にある <f:validateWholeBean /> コンポーネントが検証できるようにします。この特定のフィールドがプロパティである Bean のクラスレベルの検証を許可します。

  次で指定:

  インターフェース Validator の validate 

  パラメーター:

  context - 処理中のリクエストの FacesContext

  component - 正当性をチェックしている UIComponent

  value - 検証する値

  例外:

  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 - 状態。

• 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 

• isTransient

  public boolean isTransient()

  インターフェースからコピーされた説明: StateHolder

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

  次で指定:

  インターフェース StateHolder の isTransient 

  戻り値:

  一時的な場合は true、それ以外の場合は false。

• setTransient

  public void setTransient(boolean transientValue)

  インターフェースからコピーされた説明: StateHolder

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

  次で指定:

  インターフェース StateHolder の setTransient 

  パラメーター:

  transientValue - このオブジェクトが 状態の保存または復元に参加しない場合はブール値 true を渡し、それ以外の場合は false を渡します。