フィールドの詳細

• VALIDATOR_ID

  public static final StringSE VALIDATOR_ID

  Jakarta Server Face 仕様で定義されている、このバリデーターの標準バリデーター ID。

  関連事項:

  定数フィールド値

• MESSAGE_ID

  public static final StringSE MESSAGE_ID

  制約の失敗が見つかった場合に作成される FacesMessage のメッセージ ID。このメッセージのメッセージ形式の文字列には、オプションで次のプレースホルダーを含めることができます。

  • {0} は、Bean 検証からの補間メッセージに置き換えられました。
  • {1} は、値がこのメッセージを生成した入力コンポーネントのラベルである String に置き換えられました。

  デフォルトの実装で提供されるメッセージ形式の文字列は、プレースホルダー {0} である必要があります。これにより、メッセージ処理が Bean 検証に完全に委譲されます。開発者は、このメッセージ形式の文字列をオーバーライドして、他の Jakarta Server Face バリデーターメッセージに準拠させることができます。(つまり、コンポーネントラベルを含めること)

  関連事項:

  定数フィールド値

• VALIDATOR_FACTORY_KEY

  public static final StringSE VALIDATOR_FACTORY_KEY

  Validator インスタンスを取得するために Jakarta Server Faces によって使用されるオブジェクトを保持する Jakarta Servlet コンテキスト属性の名前。Jakarta Servlet コンテキスト属性が欠落しているか、NULL 値が含まれている場合、Jakarta Server Faces はこの Jakarta Servlet コンテキスト属性を自由に使用して、このバリデーターによってブートストラップされた ValidatorFactory を保管できます。

  関連事項:

  定数フィールド値

• VALIDATION_GROUPS_DELIMITER

  public static final StringSE VALIDATION_GROUPS_DELIMITER

  完全修飾グループ名のリストを文字列として区切るために使用される区切り文字。

  関連事項:

  定数フィールド値

• EMPTY_VALIDATION_GROUPS_PATTERN

  public static final StringSE EMPTY_VALIDATION_GROUPS_PATTERN

  検証グループの空のリストを識別する正規表現パターン。

  関連事項:

  定数フィールド値

• DISABLE_DEFAULT_BEAN_VALIDATOR_PARAM_NAME

  public static final StringSE DISABLE_DEFAULT_BEAN_VALIDATOR_PARAM_NAME

  このパラメーターが定義されていて、その値の String 表現で toLowerCase().equals(“true”) を呼び出すと true が返される場合、ランタイムは、シンボリック定数 VALIDATOR_ID の値に等しい validator-id を持つバリデーターをデフォルトのバリデーターのリストに自動的に追加してはなりません。このパラメーターを true に設定すると、アプリケーションのすべてのビューのすべての入力コンポーネントへの Bean 検証の自動インストールが無効になりますが、手動インストールは引き続き可能です。

  関連事項:

  定数フィールド値

• ENABLE_VALIDATE_WHOLE_BEAN_PARAM_NAME

  public static final StringSE ENABLE_VALIDATE_WHOLE_BEAN_PARAM_NAME

  このパラメーターが設定されていて、その値の文字列表現で toLowerCase().equals（"true" ）を呼び出すと、true が返され、validate(javax.faces.context.FacesContext, javax.faces.component.UIComponent, java.lang.Object) で指定された <validateWholeBean /> に関連する追加のアクションが実行されます。

  導入:

  2.3

  関連事項:

  定数フィールド値

コンストラクターの詳細

• BeanValidator

  public 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" （引用符なし）を引数として渡します。このアプリケーションが Java EE6 以降の Unified EL 実装の環境で実行されている場合は、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(javax.validation.MessageInterpolator) を使用して ValidatorContext に保存します。

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

  javax.validation.Validator から javax.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.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 - 検証が失敗した場合