org.springframework.web.servlet.mvc.method.annotation

Class AbstractMessageConverterMethodArgumentResolver

java.lang.Object

org.springframework.web.servlet.mvc.method.annotation.AbstractMessageConverterMethodArgumentResolver

All Implemented Interfaces:

HandlerMethodArgumentResolver

Direct Known Subclasses:

AbstractMessageConverterMethodProcessor, RequestPartMethodArgumentResolver

public abstract class AbstractMessageConverterMethodArgumentResolver
extends Object
implements HandlerMethodArgumentResolver

A base class for resolving method argument values by reading from the body of a request with HttpMessageConverters.

Since:

3.1

Author:

Arjen Poutsma, Rossen Stoyanchev

Field Summary

Fields

Modifier and Type	Field and Description
protected List<MediaType>	allSupportedMediaTypes
protected Log	logger
protected List<HttpMessageConverter<?>>	messageConverters

Constructor Summary

Constructors

Constructor and Description
AbstractMessageConverterMethodArgumentResolver(List<HttpMessageConverter<?>> converters) Basic constructor with converters only.
AbstractMessageConverterMethodArgumentResolver(List<HttpMessageConverter<?>> converters, List<Object> requestResponseBodyAdvice) Constructor with converters and Request~ and ResponseBodyAdvice.

Method Summary

Modifier and Type	Method and Description
protected ServletServerHttpRequest	createInputMessage(NativeWebRequest webRequest) Create a new HttpInputMessage from the given NativeWebRequest.
protected org.springframework.web.servlet.mvc.method.annotation.RequestResponseBodyAdviceChain	getAdvice() Return the configured RequestBodyAdvice and RequestBodyAdvice where each instance may be wrapped as a ControllerAdviceBean.
protected boolean	isBindExceptionRequired(WebDataBinder binder, MethodParameter methodParam) Whether to raise a fatal bind exception on validation errors.
protected <T> Object	readWithMessageConverters(HttpInputMessage inputMessage, MethodParameter param, Type targetType) Create the method argument value of the expected parameter type by reading from the given HttpInputMessage.
protected <T> Object	readWithMessageConverters(NativeWebRequest webRequest, MethodParameter methodParam, Type paramType) Create the method argument value of the expected parameter type by reading from the given request.
protected void	validateIfApplicable(WebDataBinder binder, MethodParameter methodParam) Validate the request part if applicable.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.springframework.web.method.support.HandlerMethodArgumentResolver

resolveArgument, supportsParameter

Field Detail

logger

protected final Log logger

messageConverters

protected final List<HttpMessageConverter<?>> messageConverters

allSupportedMediaTypes

protected final List<MediaType> allSupportedMediaTypes

Constructor Detail

AbstractMessageConverterMethodArgumentResolver

public AbstractMessageConverterMethodArgumentResolver(List<HttpMessageConverter<?>> converters)

Basic constructor with converters only.

AbstractMessageConverterMethodArgumentResolver

public AbstractMessageConverterMethodArgumentResolver(List<HttpMessageConverter<?>> converters,
                                                      List<Object> requestResponseBodyAdvice)

Constructor with converters and Request~ and ResponseBodyAdvice.

Since:

4.2

Method Detail

getAdvice

protected org.springframework.web.servlet.mvc.method.annotation.RequestResponseBodyAdviceChain getAdvice()

Return the configured RequestBodyAdvice and RequestBodyAdvice where each instance may be wrapped as a ControllerAdviceBean.

readWithMessageConverters

protected <T> Object readWithMessageConverters(NativeWebRequest webRequest,
                                               MethodParameter methodParam,
                                               Type paramType)
                                        throws IOException,
                                               HttpMediaTypeNotSupportedException,
                                               HttpMessageNotReadableException

Create the method argument value of the expected parameter type by reading from the given request.

Type Parameters:

T - the expected type of the argument value to be created

Parameters:

webRequest - the current request

methodParam - the method argument

paramType - the type of the argument value to be created

Returns:

the created method argument value

Throws:

IOException - if the reading from the request fails

HttpMediaTypeNotSupportedException - if no suitable message converter is found

HttpMessageNotReadableException

readWithMessageConverters

protected <T> Object readWithMessageConverters(HttpInputMessage inputMessage,
                                               MethodParameter param,
                                               Type targetType)
                                        throws IOException,
                                               HttpMediaTypeNotSupportedException,
                                               HttpMessageNotReadableException

Create the method argument value of the expected parameter type by reading from the given HttpInputMessage.

Type Parameters:

T - the expected type of the argument value to be created

Parameters:

inputMessage - the HTTP input message representing the current request

param - the method parameter descriptor (may be null)

targetType - the target type, not necessarily the same as the method parameter type, e.g. for HttpEntity<String>.

Returns:

the created method argument value

Throws:

IOException - if the reading from the request fails

HttpMediaTypeNotSupportedException - if no suitable message converter is found

HttpMessageNotReadableException

createInputMessage

protected ServletServerHttpRequest createInputMessage(NativeWebRequest webRequest)

Create a new HttpInputMessage from the given NativeWebRequest.

Parameters:

webRequest - the web request to create an input message from

Returns:

the input message

validateIfApplicable

protected void validateIfApplicable(WebDataBinder binder,
                                    MethodParameter methodParam)

Validate the request part if applicable.

The default implementation checks for @javax.validation.Valid, Spring's Validated, and custom annotations whose name starts with "Valid".

Parameters:

binder - the DataBinder to be used

methodParam - the method parameter

Since:

4.1.5

See Also:

isBindExceptionRequired(org.springframework.web.bind.WebDataBinder, org.springframework.core.MethodParameter)

isBindExceptionRequired

protected boolean isBindExceptionRequired(WebDataBinder binder,
                                          MethodParameter methodParam)

Whether to raise a fatal bind exception on validation errors.

Parameters:

binder - the data binder used to perform data binding

methodParam - the method argument

Returns:

true if the next method argument is not of type Errors

Since:

4.1.5