Package org.springframework.web.bind

Class MethodArgumentNotValidException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.springframework.validation.BindException

org.springframework.web.bind.MethodArgumentNotValidException

All Implemented Interfaces:

Serializable, BindingResult, Errors, ErrorResponse

public class MethodArgumentNotValidException
extends BindException
implements ErrorResponse

Exception to be thrown when validation on an argument annotated with @Valid fails. Extends BindException as of 5.3.

Since:

3.1

Author:

Rossen Stoyanchev, Juergen Hoeller, Sebastien Deleuze

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface org.springframework.web.ErrorResponse

ErrorResponse.Builder

Field Summary

Fields inherited from interface org.springframework.validation.BindingResult

MODEL_KEY_PREFIX

Fields inherited from interface org.springframework.validation.Errors

NESTED_PATH_SEPARATOR

Constructor Summary

Constructors

Constructor	Description
MethodArgumentNotValidException(Executable executable, BindingResult bindingResult)	Deprecated, for removal: This API element is subject to removal in a future version. in favor of MethodArgumentNotValidException(MethodParameter, BindingResult)
MethodArgumentNotValidException(MethodParameter parameter, BindingResult bindingResult)	Constructor for MethodArgumentNotValidException.

Method Summary

Modifier and Type	Method	Description
static List<String>	errorsToStringList(List<? extends ObjectError> errors)	Convert each given ObjectError to a String in single quotes, taking either the error's default message, or its error code.
static List<String>	errorsToStringList(List<? extends ObjectError> errors, MessageSource source, Locale locale)	Variant of errorsToStringList(List) that uses a MessageSource to resolve the message code of the error, or fall back on the error's default message.
ProblemDetail	getBody()	Return the body for the response, formatted as an RFC 7807 ProblemDetail whose status should match the response status.
Object[]	getDetailMessageArguments()	Return arguments to use along with a message code to resolve the problem "detail" for this exception through a MessageSource.
Object[]	getDetailMessageArguments(MessageSource messageSource, Locale locale)	Variant of ErrorResponse.getDetailMessageArguments() that uses the given MessageSource for resolving the message argument values.
String	getMessage()	Returns diagnostic information about the errors held in this object.
final MethodParameter	getParameter()	Return the method parameter that failed validation.
HttpStatusCode	getStatusCode()	Return the HTTP status code to use for the response.
Map<ObjectError,String>	resolveErrorMessages(MessageSource messageSource, Locale locale)	Resolve global and field errors to messages with the given MessageSource and Locale.

Methods inherited from class org.springframework.validation.BindException

addAllErrors, addError, equals, findEditor, getAllErrors, getBindingResult, getErrorCount, getFieldError, getFieldError, getFieldErrorCount, getFieldErrorCount, getFieldErrors, getFieldErrors, getFieldType, getFieldValue, getGlobalError, getGlobalErrorCount, getGlobalErrors, getModel, getNestedPath, getObjectName, getPropertyEditorRegistry, getRawFieldValue, getSuppressedFields, getTarget, hasErrors, hasFieldErrors, hasFieldErrors, hasGlobalErrors, hashCode, popNestedPath, pushNestedPath, recordFieldValue, recordSuppressedField, reject, reject, reject, rejectValue, rejectValue, rejectValue, resolveMessageCodes, resolveMessageCodes, setNestedPath

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.springframework.web.ErrorResponse

getDetailMessageCode, getHeaders, getTitleMessageCode, updateAndGetBody

Constructor Details

MethodArgumentNotValidException

public MethodArgumentNotValidException(MethodParameter parameter,
 BindingResult bindingResult)

Constructor for MethodArgumentNotValidException.

Parameters:

parameter - the parameter that failed validation

bindingResult - the results of the validation

MethodArgumentNotValidException

@Deprecated(since="6.0.10",
            forRemoval=true)
public MethodArgumentNotValidException(Executable executable,
 BindingResult bindingResult)

Deprecated, for removal: This API element is subject to removal in a future version.

in favor of MethodArgumentNotValidException(MethodParameter, BindingResult)

Constructor for MethodArgumentNotValidException.

Parameters:

executable - the executable that failed validation

bindingResult - the results of the validation

Since:

6.0.5

Method Details

getStatusCode

public HttpStatusCode getStatusCode()

Description copied from interface: ErrorResponse

Return the HTTP status code to use for the response.

Specified by:

getStatusCode in interface ErrorResponse

getBody

public ProblemDetail getBody()

Description copied from interface: ErrorResponse

Return the body for the response, formatted as an RFC 7807 ProblemDetail whose status should match the response status.

Note: The returned ProblemDetail may be updated before the response is rendered, e.g. via ErrorResponse.updateAndGetBody(MessageSource, Locale). Therefore, implementing methods should use an instance field, and should not re-create the ProblemDetail on every call, nor use a static variable.

Specified by:

getBody in interface ErrorResponse

getParameter

public final MethodParameter getParameter()

Return the method parameter that failed validation.

getMessage

public String getMessage()

Description copied from class: BindException

Returns diagnostic information about the errors held in this object.

Overrides:

getMessage in class BindException

getDetailMessageArguments

public Object[] getDetailMessageArguments()

Description copied from interface: ErrorResponse

Return arguments to use along with a message code to resolve the problem "detail" for this exception through a MessageSource. The arguments are expanded into placeholders of the message value, e.g. "Invalid content type {0}".

Specified by:

getDetailMessageArguments in interface ErrorResponse

getDetailMessageArguments

public Object[] getDetailMessageArguments(MessageSource messageSource,
 Locale locale)

Description copied from interface: ErrorResponse

Variant of ErrorResponse.getDetailMessageArguments() that uses the given MessageSource for resolving the message argument values.

This is useful for example to expand message codes from validation errors.

The default implementation delegates to ErrorResponse.getDetailMessageArguments(), ignoring the supplied MessageSource and Locale.

Specified by:

getDetailMessageArguments in interface ErrorResponse

Parameters:

messageSource - the MessageSource to use for the lookup

locale - the Locale to use for the lookup

resolveErrorMessages

public Map<ObjectError,String> resolveErrorMessages(MessageSource messageSource,
 Locale locale)

Resolve global and field errors to messages with the given MessageSource and Locale.

Returns:

a Map with errors as key and resolved messages as value

Since:

6.0.3

errorsToStringList

public static List<String> errorsToStringList(List<? extends ObjectError> errors)

Convert each given ObjectError to a String in single quotes, taking either the error's default message, or its error code.

Since:

6.0

errorsToStringList

public static List<String> errorsToStringList(List<? extends ObjectError> errors,
 @Nullable
 MessageSource source,
 Locale locale)

Variant of errorsToStringList(List) that uses a MessageSource to resolve the message code of the error, or fall back on the error's default message.

Since:

6.0