public interface BindingResult extends Errors
interface
を拡張し、Validator
を適用できるようにし、バインディング固有の分析とモデル構築を追加します。DataBinder.getBindingResult()
メソッドを介して取得された DataBinder
の結果ホルダーとして機能します。BindingResult の実装を直接使用して、たとえば Validator
を(ユニットテストの一部として)呼び出すこともできます。
DataBinder
, Errors
, Validator
, BeanPropertyBindingResult
, DirectFieldBindingResult
, MapBindingResult
修飾子と型 | フィールドと説明 |
---|---|
static StringSE | MODEL_KEY_PREFIX モデル内の BindingResult インスタンスの名前の接頭辞と、それに続くオブジェクト名。 |
NESTED_PATH_SEPARATOR
修飾子と型 | メソッドと説明 |
---|---|
void | addError(ObjectError error) カスタム ObjectError または FieldError をエラーリストに追加します。 |
PropertyEditorSE | findEditor(StringSE field, ClassSE<?> valueType) 指定された型とプロパティのカスタムプロパティエディターを見つけます。 |
MapSE<StringSE, ObjectSE> | getModel() 取得した状態のモデルマップを返し、BindingResult インスタンスを " MODEL_KEY_PREFIX + objectName" として公開し、オブジェクト自体を "objectName" として公開します。 |
PropertyEditorRegistry | getPropertyEditorRegistry() 基になる PropertyEditorRegistry を返します。 |
ObjectSE | getRawFieldValue(StringSE field) 指定されたフィールドの未加工フィールド値を抽出します。 |
default StringSE[] | getSuppressedFields() バインドプロセス中に抑制されたフィールドのリストを返します。 |
ObjectSE | getTarget() 具体的なバインディング戦略に応じて、Bean、パブリックフィールドを持つオブジェクト、マップなどのラップされたターゲットオブジェクトを返します。 |
default void | recordFieldValue(StringSE field, ClassSE<?> type, ObjectSE value) 指定されたフィールドに指定された値を記録します。 |
default void | recordSuppressedField(StringSE field) 指定された許可されていないフィールドを非表示としてマークします。 |
StringSE[] | resolveMessageCodes(StringSE errorCode) 指定されたエラーコードをメッセージコードに解決します。 |
StringSE[] | resolveMessageCodes(StringSE errorCode, StringSE field) 指定されたエラーコードを、指定されたフィールドのメッセージコードに解決します。 |
addAllErrors, getAllErrors, getErrorCount, getFieldError, getFieldError, getFieldErrorCount, getFieldErrorCount, getFieldErrors, getFieldErrors, getFieldType, getFieldValue, getGlobalError, getGlobalErrorCount, getGlobalErrors, getNestedPath, getObjectName, hasErrors, hasFieldErrors, hasFieldErrors, hasGlobalErrors, popNestedPath, pushNestedPath, reject, reject, reject, rejectValue, rejectValue, rejectValue, setNestedPath
static final StringSE MODEL_KEY_PREFIX
@Nullable ObjectSE getTarget()
MapSE<StringSE,ObjectSE> getModel()
MODEL_KEY_PREFIX
+ objectName" として公開し、オブジェクト自体を "objectName" として公開します。このメソッドを呼び出すたびにマップが作成されることに注意してください。マップに物事を追加してからこのメソッドを再度呼び出しても機能しません。
このメソッドによって返されるモデル Map の属性は、通常、BindingResult インスタンスへのアクセスが必要な JSP で Spring の bind
タグを使用するフォームビューの ModelAndView
に含まれます。Spring の事前に構築されたフォームコントローラーは、フォームビューをレンダリングするときにこれを行います。ModelAndView インスタンスを自分で構築する場合、このメソッドによって返されるモデル Map の属性を含める必要があります。
@Nullable ObjectSE getRawFieldValue(StringSE field)
field
- チェックするフィールド null
@Nullable PropertyEditorSE findEditor(@Nullable StringSE field, @Nullable ClassSE<?> valueType)
field
- プロパティのパス(名前またはネストされたパス)、または特定の型のすべてのプロパティのエディターを探している場合は null
valueType
- プロパティの型 (プロパティが指定されている場合は null
にすることができますが、一貫性チェックのためにいずれにしても指定する必要があります)null
@Nullable PropertyEditorRegistry getPropertyEditorRegistry()
null
StringSE[] resolveMessageCodes(StringSE errorCode)
適切なパラメーターを使用して、構成された MessageCodesResolver
を呼び出します。
errorCode
- メッセージコードに解決するエラーコード StringSE[] resolveMessageCodes(StringSE errorCode, StringSE field)
適切なパラメーターを使用して、構成された MessageCodesResolver
を呼び出します。
errorCode
- メッセージコードに解決するエラーコード field
- メッセージコードを解決するフィールド void addError(ObjectError error)
default void recordFieldValue(StringSE field, ClassSE<?> type, @Nullable ObjectSE value)
ターゲットオブジェクトを構築できない場合に使用し、元のフィールド値を Errors.getFieldValue(java.lang.String)
で使用できるようにします。登録されたエラーの場合、拒否された値は影響を受けるフィールドごとに公開されます。
field
- 値を記録するフィールド type
- フィールドの型 value
- 元の値 default void recordSuppressedField(StringSE field)
データバインダーは、許可されていないフィールドを対象として検出された各フィールド値に対してこれを呼び出します。
default StringSE[] getSuppressedFields()
フィールド値が許可されていないフィールドをターゲットとしていたかどうかを判断するために使用できます。