インターフェース Errors

方法の詳細

• getObjectName

  StringSE getObjectName()

  バインドされたルートオブジェクトの名前を返します。

• setNestedPath

  void setNestedPath(StringSE nestedPath)

  標準バリデーターがサブツリーを検証できるように、コンテキストの変更を許可します。呼び出しを拒否すると、指定されたパスがフィールド名の前に追加されます。

  例: 住所検証ツールは、顧客オブジェクトのサブオブジェクト「住所」を検証できます。

  パラメーター:

  nestedPath - このオブジェクト内のネストされたパス。「アドレス」（デフォルトは ""、null も使用可能）。「アドレス」と「アドレス」の両方で終わることができます。有効です。

• getNestedPath

  StringSE getNestedPath()

  この Errors オブジェクトの現在のネストされたパスを返します。

  連結されたパスを簡単に構築するために、ドット付きのネストされたパス、つまり「アドレス」を返します。デフォルトは空の文字列です。

• pushNestedPath

  void pushNestedPath(StringSE subPath)

  指定されたサブパスをネストされたパススタックにプッシュします。

  popNestedPath() 呼び出しは、対応する pushNestedPath(String) 呼び出しの前に元のネストされたパスをリセットします。

  ネストパススタックを使用すると、一時パスホルダーを気にすることなく、サブオブジェクトの一時ネストパスを設定できます。

  次に例を示します: 現在のパスは "spouse."、pushNestedPath("child" ) → 結果パスは "spouse.child."、popNestedPath() → 再び "spouse."

  パラメーター:

  subPath - ネストされたパススタックにプッシュするサブパス

  関連事項:

  • popNestedPath()

• popNestedPath

  void popNestedPath() throws IllegalStateExceptionSE

  ネストされたパススタックから以前のネストされたパスをポップします。

  例外:

  IllegalStateExceptionSE - スタックに元のネストされたパスがない場合

  関連事項:

  • pushNestedPath(java.lang.String)

• reject

  void reject(StringSE errorCode)

  指定されたエラーの説明を使用して、ターゲットオブジェクト全体のグローバルエラーを登録します。

  パラメーター:

  errorCode - エラーコード、メッセージキーとして解釈可能

• reject

  void reject(StringSE errorCode, StringSE defaultMessage)

  指定されたエラーの説明を使用して、ターゲットオブジェクト全体のグローバルエラーを登録します。

  パラメーター:

  errorCode - エラーコード、メッセージキーとして解釈可能

  defaultMessage - フォールバックのデフォルトメッセージ

• reject

  void reject(StringSE errorCode, @Nullable ObjectSE[] errorArgs, @Nullable StringSE defaultMessage)

  指定されたエラーの説明を使用して、ターゲットオブジェクト全体のグローバルエラーを登録します。

  パラメーター:

  errorCode - エラーコード、メッセージキーとして解釈可能

  errorArgs - エラー引数、MessageFormat を介した引数バインディング用 (null にすることができます)

  defaultMessage - フォールバックのデフォルトメッセージ

• rejectValue

  void rejectValue(@Nullable StringSE field, StringSE errorCode)

  指定されたエラーの説明を使用して、現在のオブジェクトの指定されたフィールドのフィールドエラーを登録します（存在する場合、現在のネストされたパスを考慮します）。

  フィールド名は null または空の文字列で、フィールドではなく現在のオブジェクト自体を示します。これにより、ネストされたオブジェクトグラフ内で対応するフィールドエラーが発生するか、現在のオブジェクトが最上位オブジェクトである場合にグローバルエラーが発生する可能性があります。

  パラメーター:

  field - フィールド名 (null または空の文字列です)

  errorCode - エラーコード、メッセージキーとして解釈可能

  関連事項:

  • getNestedPath()

• rejectValue

  void rejectValue(@Nullable StringSE field, StringSE errorCode, StringSE defaultMessage)

  指定されたエラーの説明を使用して、現在のオブジェクトの指定されたフィールドのフィールドエラーを登録します（存在する場合、現在のネストされたパスを考慮します）。

  フィールド名は null または空の文字列で、フィールドではなく現在のオブジェクト自体を示します。これにより、ネストされたオブジェクトグラフ内で対応するフィールドエラーが発生するか、現在のオブジェクトが最上位オブジェクトである場合にグローバルエラーが発生する可能性があります。

  パラメーター:

  field - フィールド名 (null または空の文字列です)

  errorCode - エラーコード、メッセージキーとして解釈可能

  defaultMessage - フォールバックのデフォルトメッセージ

  関連事項:

  • getNestedPath()

• rejectValue

  void rejectValue(@Nullable StringSE field, StringSE errorCode, @Nullable ObjectSE[] errorArgs, @Nullable StringSE defaultMessage)

  指定されたエラーの説明を使用して、現在のオブジェクトの指定されたフィールドのフィールドエラーを登録します（存在する場合、現在のネストされたパスを考慮します）。

  フィールド名は null または空の文字列で、フィールドではなく現在のオブジェクト自体を示します。これにより、ネストされたオブジェクトグラフ内で対応するフィールドエラーが発生するか、現在のオブジェクトが最上位オブジェクトである場合にグローバルエラーが発生する可能性があります。

  パラメーター:

  field - フィールド名 (null または空の文字列です)

  errorCode - エラーコード、メッセージキーとして解釈可能

  errorArgs - エラー引数、MessageFormat を介した引数バインディング用 (null にすることができます)

  defaultMessage - フォールバックのデフォルトメッセージ

  関連事項:

  • getNestedPath()

• addAllErrors

  void addAllErrors(Errors errors)

  指定された Errors インスタンスからのすべてのエラーをこの Errors インスタンスに追加します。

  これは、Errors インスタンスを別の Errors インスタンスにマージするために繰り返される reject(..) 呼び出しを避けるための便利なメソッドです。

  渡された Errors インスタンスは同じターゲットオブジェクトを参照するか、少なくともこの Errors インスタンスのターゲットオブジェクトに適用される互換性のあるエラーを含むことに注意してください。

  パラメーター:

  errors - マージする Errors インスタンス

• hasErrors

  boolean hasErrors()

  エラーがあった場合に戻ります。

• getErrorCount

  int getErrorCount()

  エラーの総数を返します。

• getAllErrors

  ListSE<ObjectError> getAllErrors()

  グローバルエラーとフィールドエラーの両方のすべてのエラーを取得します。

  戻り値:

  ObjectError インスタンスのリスト

• hasGlobalErrors

  boolean hasGlobalErrors()

  グローバルエラーはありますか？

  戻り値:

  グローバルエラーがある場合は true 

  関連事項:

  • hasFieldErrors()

• getGlobalErrorCount

  int getGlobalErrorCount()

  グローバルエラーの数を返します。

  戻り値:

  グローバルエラーの数

  関連事項:

  • getFieldErrorCount()

• getGlobalErrors

  ListSE<ObjectError> getGlobalErrors()

  すべてのグローバルエラーを取得します。

  戻り値:

  ObjectError インスタンスのリスト

• getGlobalError

  @Nullable ObjectError getGlobalError()

  もしあれば、 最初のグローバルエラーを取得します。

  戻り値:

  グローバルエラー、または null

• hasFieldErrors

  boolean hasFieldErrors()

  フィールドエラーはありますか？

  戻り値:

  フィールドに関連するエラーがある場合は true 

  関連事項:

  • hasGlobalErrors()

• getFieldErrorCount

  int getFieldErrorCount()

  フィールドに関連付けられているエラーの数を返します。

  戻り値:

  フィールドに関連付けられたエラーの数

  関連事項:

  • getGlobalErrorCount()

• getFieldErrors

  ListSE<FieldError> getFieldErrors()

  フィールドに関連付けられているすべてのエラーを取得します。

  戻り値:

  FieldError インスタンスのリスト

• getFieldError

  @Nullable FieldError getFieldError()

  フィールドに関連付けられている最初のエラーがあれば、それを取得します。

  戻り値:

  フィールド固有のエラー、または null

• hasFieldErrors

  boolean hasFieldErrors(StringSE field)

  特定のフィールドに関連するエラーはありますか？

  パラメーター:

  field - フィールド名

  戻り値:

  指定されたフィールドに関連するエラーがある場合は、true 

• getFieldErrorCount

  int getFieldErrorCount(StringSE field)

  指定されたフィールドに関連付けられているエラーの数を返します。

  パラメーター:

  field - フィールド名

  戻り値:

  指定されたフィールドに関連付けられたエラーの数

• getFieldErrors

  ListSE<FieldError> getFieldErrors(StringSE field)

  指定されたフィールドに関連するすべてのエラーを取得します。

  実装では、"name" などの完全なフィールド名だけでなく、"na *" や "address.*" などのパターン一致もサポートする必要があります。

  パラメーター:

  field - フィールド名

  戻り値:

  FieldError インスタンスのリスト

• getFieldError

  @Nullable FieldError getFieldError(StringSE field)

  指定されたフィールドに関連付けられている最初のエラーがあれば、それを取得します。

  パラメーター:

  field - フィールド名

  戻り値:

  フィールド固有のエラー、または null

• getFieldValue

  @Nullable ObjectSE getFieldValue(StringSE field)

  指定されたフィールドの現在の値、現在の Bean プロパティ値、最後のバインディングからの拒否された更新を返します。

  型の不一致があった場合でも、ユーザー指定のフィールド値に簡単にアクセスできます。

  パラメーター:

  field - フィールド名

  戻り値:

  指定されたフィールドの現在の値

• getFieldType

  @Nullable ClassSE<?> getFieldType(StringSE field)

  指定されたフィールドの型を返します。

  実装は、フィールド値が null の場合でも、たとえば関連する記述子から型を判別できる必要があります。

  パラメーター:

  field - フィールド名

  戻り値:

  フィールドの型、または判別できない場合は null