インターフェース Errors

すべての既知のサブインターフェース:
BindingResult
すべての既知の実装クラス:
AbstractBindingResultAbstractErrorsAbstractPropertyBindingResultBeanPropertyBindingResultBindExceptionDirectFieldBindingResultEscapedErrorsMapBindingResultMethodArgumentNotValidExceptionWebExchangeBindException

public interface Errors
特定のオブジェクトのデータバインディングおよび検証エラーに関する情報を格納および公開します。

フィールド名は通常、ターゲットオブジェクトのプロパティです (顧客オブジェクトにバインドする場合の「名前」など)。実装では、ネストされたオブジェクト ("address.street" など) の場合、setNestedPath(java.lang.String) によるサブツリーナビゲーションと組み合わせて、ネストされたフィールドもサポートする場合があります。たとえば、AddressValidator は、これがトップレベルの顧客のネストされたオブジェクトであることを認識せずに、「住所」を検証する可能性があります。物体。

メモ: Errors オブジェクトはシングルスレッドです。

作成者:
Rod Johnson, Juergen Hoeller
関連事項:
  • フィールドサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    static final StringSE
    ネストされたパス(たとえば、"customer.name" または "customer.address.street" )内のパス要素間の区切り文字。
  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    指定された Errors インスタンスからのすべてのエラーをこの Errors インスタンスに追加します。
    グローバルエラーとフィールドエラーの両方のすべてのエラーを取得します。
    int
    エラーの合計数を確認します。
    フィールドに関連付けられている最初のエラーがあれば、それを取得します。
    指定されたフィールドに関連付けられている最初のエラーがあれば、それを取得します。
    int
    フィールドに関連付けられたエラーの数を確認します。
    int
    指定されたフィールドに関連付けられたエラーの数を確認します。
    フィールドに関連付けられているすべてのエラーを取得します。
    指定されたフィールドに関連するすべてのエラーを取得します。
    指定されたフィールドの型を可能な限り特定します。
    指定されたフィールドの現在の値、現在の Bean プロパティ値、最後のバインディングからの拒否された更新を返します。
    もしあれば、 最初のグローバルエラーを取得します。
    int
    グローバルエラーの数を確認します。
    すべてのグローバルエラーを取得します。
    この Errors オブジェクトの現在のネストされたパスを返します。
    バインドされたルートオブジェクトの名前を返します。
    boolean
    エラーがあったかどうかを確認します。
    boolean
    フィールドに関連するエラーがあったかどうかを確認します。
    boolean
    指定されたフィールドに関連するエラーがあったかどうかを確認します。
    boolean
    グローバルエラーがあったかどうかを確認します。
    void
    ネストされたパススタックから以前のネストされたパスをポップします。
    void
    指定されたサブパスをネストされたパススタックにプッシュします。
    void
    reject(StringSE errorCode)
    指定されたエラーの説明を使用して、ターゲットオブジェクト全体のグローバルエラーを登録します。
    void
    reject(StringSE errorCode, ObjectSE[] errorArgs, StringSE defaultMessage)
    指定されたエラーの説明を使用して、ターゲットオブジェクト全体のグローバルエラーを登録します。
    void
    reject(StringSE errorCode, StringSE defaultMessage)
    指定されたエラーの説明を使用して、ターゲットオブジェクト全体のグローバルエラーを登録します。
    void
    rejectValue(StringSE field, StringSE errorCode)
    指定されたエラーの説明を使用して、現在のオブジェクトの指定されたフィールドのフィールドエラーを登録します(存在する場合、現在のネストされたパスを考慮します)。
    void
    rejectValue(StringSE field, StringSE errorCode, ObjectSE[] errorArgs, StringSE defaultMessage)
    指定されたエラーの説明を使用して、現在のオブジェクトの指定されたフィールドのフィールドエラーを登録します(存在する場合、現在のネストされたパスを考慮します)。
    void
    rejectValue(StringSE field, StringSE errorCode, StringSE defaultMessage)
    指定されたエラーの説明を使用して、現在のオブジェクトの指定されたフィールドのフィールドエラーを登録します(存在する場合、現在のネストされたパスを考慮します)。
    void
    標準バリデーターがサブツリーを検証できるように、コンテキストの変更を許可します。
  • フィールドの詳細

    • NESTED_PATH_SEPARATOR

      static final StringSE NESTED_PATH_SEPARATOR
      ネストされたパス(たとえば、"customer.name" または "customer.address.street" )内のパス要素間の区切り文字。

      "" = Bean パッケージの nested property separator と同じ。

      関連事項:
  • メソッドの詳細

    • 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()→ " 配偶者。" また。

      パラメーター:
      subPath - ネストされたパススタックにプッシュするサブパス
      関連事項:
    • popNestedPath

      void popNestedPath() throws IllegalStateExceptionSE
      ネストされたパススタックから以前のネストされたパスをポップします。
      例外:
      IllegalStateExceptionSE - スタックに元のネストされたパスがない場合
      関連事項:
    • 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 - エラーコード、メッセージキーとして解釈可能
      関連事項:
    • rejectValue

      void rejectValue(@Nullable StringSE field, StringSE errorCode, StringSE defaultMessage)
      指定されたエラーの説明を使用して、現在のオブジェクトの指定されたフィールドのフィールドエラーを登録します(存在する場合、現在のネストされたパスを考慮します)。

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

      パラメーター:
      field - フィールド名 (null または空の文字列です)
      errorCode - エラーコード、メッセージキーとして解釈可能
      defaultMessage - フォールバックのデフォルトメッセージ
      関連事項:
    • rejectValue

      void rejectValue(@Nullable StringSE field, StringSE errorCode, @Nullable ObjectSE[] errorArgs, @Nullable StringSE defaultMessage)
      指定されたエラーの説明を使用して、現在のオブジェクトの指定されたフィールドのフィールドエラーを登録します(存在する場合、現在のネストされたパスを考慮します)。

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

      パラメーター:
      field - フィールド名 (null または空の文字列です)
      errorCode - エラーコード、メッセージキーとして解釈可能
      errorArgs - エラー引数、MessageFormat を介した引数バインディング用 (null にすることができます)
      defaultMessage - フォールバックのデフォルトメッセージ
      関連事項:
    • 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/FieldError インスタンスのリスト
      関連事項:
    • hasGlobalErrors

      boolean hasGlobalErrors()
      グローバルエラーがあったかどうかを確認します。
      関連事項:
    • getGlobalErrorCount

      int getGlobalErrorCount()
      グローバルエラーの数を確認します。
      関連事項:
    • getGlobalErrors

      ListSE<ObjectError> getGlobalErrors()
      すべてのグローバルエラーを取得します。
      戻り値:
      ObjectError インスタンスのリスト
      関連事項:
    • getGlobalError

      @Nullable ObjectError getGlobalError()
      もしあれば、 最初のグローバルエラーを取得します。
      戻り値:
      グローバルエラー、または null
      関連事項:
    • hasFieldErrors

      boolean hasFieldErrors()
      フィールドに関連するエラーがあったかどうかを確認します。
      関連事項:
    • getFieldErrorCount

      int getFieldErrorCount()
      フィールドに関連付けられたエラーの数を確認します。
      関連事項:
    • getFieldErrors

      ListSE<FieldError> getFieldErrors()
      フィールドに関連付けられているすべてのエラーを取得します。
      戻り値:
      FieldError インスタンスのリスト
      関連事項:
    • getFieldError

      @Nullable FieldError getFieldError()
      フィールドに関連付けられている最初のエラーがあれば、それを取得します。
      戻り値:
      フィールド固有のエラー、または null
      関連事項:
    • hasFieldErrors

      boolean hasFieldErrors(StringSE field)
      指定されたフィールドに関連するエラーがあったかどうかを確認します。
      パラメーター:
      field - フィールド名
      関連事項:
    • getFieldErrorCount

      int getFieldErrorCount(StringSE field)
      指定されたフィールドに関連付けられたエラーの数を確認します。
      パラメーター:
      field - フィールド名
      関連事項:
    • getFieldErrors

      ListSE<FieldError> getFieldErrors(StringSE field)
      指定されたフィールドに関連するすべてのエラーを取得します。

      実装では、"address.street" のような完全なフィールド名だけでなく、"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 
      関連事項: