/*
 * Copyright 2002-2018 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.springframework.validation;

import java.beans.PropertyEditor;
import java.util.Map;

import org.springframework.beans.PropertyEditorRegistry;
import org.springframework.lang.Nullable;

General interface that represents binding results. Extends the interface for error registration capabilities, allowing for a Validator to be applied, and adds binding-specific analysis and model building.

Serves as result holder for a DataBinder, obtained via the DataBinder.getBindingResult() method. BindingResult implementations can also be used directly, for example to invoke a Validator on it (e.g. as part of a unit test).

Author:Juergen Hoeller
See Also:
Since:2.0
/** * General interface that represents binding results. Extends the * {@link Errors interface} for error registration capabilities, * allowing for a {@link Validator} to be applied, and adds * binding-specific analysis and model building. * * <p>Serves as result holder for a {@link DataBinder}, obtained via * the {@link DataBinder#getBindingResult()} method. BindingResult * implementations can also be used directly, for example to invoke * a {@link Validator} on it (e.g. as part of a unit test). * * @author Juergen Hoeller * @since 2.0 * @see DataBinder * @see Errors * @see Validator * @see BeanPropertyBindingResult * @see DirectFieldBindingResult * @see MapBindingResult */
public interface BindingResult extends Errors {
Prefix for the name of the BindingResult instance in a model, followed by the object name.
/** * Prefix for the name of the BindingResult instance in a model, * followed by the object name. */
String MODEL_KEY_PREFIX = BindingResult.class.getName() + ".";
Return the wrapped target object, which may be a bean, an object with public fields, a Map - depending on the concrete binding strategy.
/** * Return the wrapped target object, which may be a bean, an object with * public fields, a Map - depending on the concrete binding strategy. */
@Nullable Object getTarget();
Return a model Map for the obtained state, exposing a BindingResult instance as 'MODEL_KEY_PREFIX + objectName' and the object itself as 'objectName'.

Note that the Map is constructed every time you're calling this method. Adding things to the map and then re-calling this method will not work.

The attributes in the model Map returned by this method are usually included in the ModelAndView for a form view that uses Spring's bind tag in a JSP, which needs access to the BindingResult instance. Spring's pre-built form controllers will do this for you when rendering a form view. When building the ModelAndView instance yourself, you need to include the attributes from the model Map returned by this method.

See Also:
/** * Return a model Map for the obtained state, exposing a BindingResult * instance as '{@link #MODEL_KEY_PREFIX MODEL_KEY_PREFIX} + objectName' * and the object itself as 'objectName'. * <p>Note that the Map is constructed every time you're calling this method. * Adding things to the map and then re-calling this method will not work. * <p>The attributes in the model Map returned by this method are usually * included in the {@link org.springframework.web.servlet.ModelAndView} * for a form view that uses Spring's {@code bind} tag in a JSP, * which needs access to the BindingResult instance. Spring's pre-built * form controllers will do this for you when rendering a form view. * When building the ModelAndView instance yourself, you need to include * the attributes from the model Map returned by this method. * @see #getObjectName() * @see #MODEL_KEY_PREFIX * @see org.springframework.web.servlet.ModelAndView * @see org.springframework.web.servlet.tags.BindTag */
Map<String, Object> getModel();
Extract the raw field value for the given field. Typically used for comparison purposes.
Params:
  • field – the field to check
Returns:the current value of the field in its raw form, or null if not known
/** * Extract the raw field value for the given field. * Typically used for comparison purposes. * @param field the field to check * @return the current value of the field in its raw form, or {@code null} if not known */
@Nullable Object getRawFieldValue(String field);
Find a custom property editor for the given type and property.
Params:
  • field – the path of the property (name or nested path), or null if looking for an editor for all properties of the given type
  • valueType – the type of the property (can be null if a property is given but should be specified in any case for consistency checking)
Returns:the registered editor, or null if none
/** * Find a custom property editor for the given type and property. * @param field the path of the property (name or nested path), or * {@code null} if looking for an editor for all properties of the given type * @param valueType the type of the property (can be {@code null} if a property * is given but should be specified in any case for consistency checking) * @return the registered editor, or {@code null} if none */
@Nullable PropertyEditor findEditor(@Nullable String field, @Nullable Class<?> valueType);
Return the underlying PropertyEditorRegistry.
Returns:the PropertyEditorRegistry, or null if none available for this BindingResult
/** * Return the underlying PropertyEditorRegistry. * @return the PropertyEditorRegistry, or {@code null} if none * available for this BindingResult */
@Nullable PropertyEditorRegistry getPropertyEditorRegistry();
Resolve the given error code into message codes.

Calls the configured MessageCodesResolver with appropriate parameters.

Params:
  • errorCode – the error code to resolve into message codes
Returns:the resolved message codes
/** * Resolve the given error code into message codes. * <p>Calls the configured {@link MessageCodesResolver} with appropriate parameters. * @param errorCode the error code to resolve into message codes * @return the resolved message codes */
String[] resolveMessageCodes(String errorCode);
Resolve the given error code into message codes for the given field.

Calls the configured MessageCodesResolver with appropriate parameters.

Params:
  • errorCode – the error code to resolve into message codes
  • field – the field to resolve message codes for
Returns:the resolved message codes
/** * Resolve the given error code into message codes for the given field. * <p>Calls the configured {@link MessageCodesResolver} with appropriate parameters. * @param errorCode the error code to resolve into message codes * @param field the field to resolve message codes for * @return the resolved message codes */
String[] resolveMessageCodes(String errorCode, String field);
Add a custom ObjectError or FieldError to the errors list.

Intended to be used by cooperating strategies such as BindingErrorProcessor.

See Also:
/** * Add a custom {@link ObjectError} or {@link FieldError} to the errors list. * <p>Intended to be used by cooperating strategies such as {@link BindingErrorProcessor}. * @see ObjectError * @see FieldError * @see BindingErrorProcessor */
void addError(ObjectError error);
Record the given value for the specified field.

To be used when a target object cannot be constructed, making the original field values available through Errors.getFieldValue. In case of a registered error, the rejected value will be exposed for each affected field.

Params:
  • field – the field to record the value for
  • type – the type of the field
  • value – the original value
Since:5.0.4
/** * Record the given value for the specified field. * <p>To be used when a target object cannot be constructed, making * the original field values available through {@link #getFieldValue}. * In case of a registered error, the rejected value will be exposed * for each affected field. * @param field the field to record the value for * @param type the type of the field * @param value the original value * @since 5.0.4 */
default void recordFieldValue(String field, Class<?> type, @Nullable Object value) { }
Mark the specified disallowed field as suppressed.

The data binder invokes this for each field value that was detected to target a disallowed field.

See Also:
  • setAllowedFields.setAllowedFields
/** * Mark the specified disallowed field as suppressed. * <p>The data binder invokes this for each field value that was * detected to target a disallowed field. * @see DataBinder#setAllowedFields */
default void recordSuppressedField(String field) { }
Return the list of fields that were suppressed during the bind process.

Can be used to determine whether any field values were targeting disallowed fields.

See Also:
  • setAllowedFields.setAllowedFields
/** * Return the list of fields that were suppressed during the bind process. * <p>Can be used to determine whether any field values were targeting * disallowed fields. * @see DataBinder#setAllowedFields */
default String[] getSuppressedFields() { return new String[0]; } }