java.lang.Object
- org.springframework.web.method.annotation.ModelAttributeMethodProcessor

所有已实现的接口:
HandlerMethodArgumentResolver, HandlerMethodReturnValueHandler
直接已知子类:
ServletModelAttributeMethodProcessor
```
public class ModelAttributeMethodProcessor
extends Object
implements HandlerMethodArgumentResolver, HandlerMethodReturnValueHandler
```
Resolve @ModelAttribute annotated method arguments and handle return values from @ModelAttribute annotated methods.
Model attributes are obtained from the model or created with a default constructor (and then added to the model). Once created the attribute is populated via data binding to Servlet request parameters. Validation may be applied if the argument is annotated with @javax.validation.Valid. or Spring's own @org.springframework.validation.annotation.Validated.
When this handler is created with annotationNotRequired=true any non-simple type argument and return value is regarded as a model attribute with or without the presence of an @ModelAttribute.
从以下版本开始:
3.1
作者:
Rossen Stoyanchev

字段概要
字段
修饰符和类型字段说明
protected Log logger

构造器概要
构造器
构造器说明
ModelAttributeMethodProcessor(boolean annotationNotRequired)
Class constructor.

方法概要

所有方法实例方法具体方法
修饰符和类型	方法	说明
`protected void`	`bindRequestParameters(WebDataBinder binder, NativeWebRequest request)`	Extension point to bind the request to the target object.
`protected Object`	`createAttribute(String attributeName, MethodParameter parameter, WebDataBinderFactory binderFactory, NativeWebRequest webRequest)`	Extension point to create the model attribute if not found in the model.
`void`	`handleReturnValue(Object returnValue, MethodParameter returnType, ModelAndViewContainer mavContainer, NativeWebRequest webRequest)`	Add non-null return values to the `ModelAndViewContainer`.
`protected boolean`	`isBindExceptionRequired(WebDataBinder binder, MethodParameter parameter)`	Whether to raise a fatal bind exception on validation errors.
`Object`	`resolveArgument(MethodParameter parameter, ModelAndViewContainer mavContainer, NativeWebRequest webRequest, WebDataBinderFactory binderFactory)`	Resolve the argument from the model or if not found instantiate it with its default if it is available.
`boolean`	`supportsParameter(MethodParameter parameter)`	Returns `true` if the parameter is annotated with `ModelAttribute` or, if in default resolution mode, for any method parameter that is not a simple type.
`boolean`	`supportsReturnType(MethodParameter returnType)`	Return `true` if there is a method-level `@ModelAttribute` or, in default resolution mode, for any return value type that is not a simple type.
`protected void`	`validateIfApplicable(WebDataBinder binder, MethodParameter parameter)`	Validate the model attribute if applicable.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - logger
```
protected final Log logger
```
- 构造器详细资料
  - ModelAttributeMethodProcessor
```
public ModelAttributeMethodProcessor(boolean annotationNotRequired)
```
    Class constructor.
    参数:
    annotationNotRequired - if "true", non-simple method arguments and return values are considered model attributes with or without a @ModelAttribute annotation
- 方法详细资料
  - supportsParameter
```
public boolean supportsParameter(MethodParameter parameter)
```
    Returns true if the parameter is annotated with ModelAttribute or, if in default resolution mode, for any method parameter that is not a simple type.
    指定者:
    supportsParameter 在接口中 HandlerMethodArgumentResolver
    参数:
    parameter - the method parameter to check
    返回:
    true if this resolver supports the supplied parameter; false otherwise
  - resolveArgument
```
public final Object resolveArgument(MethodParameter parameter,
                                    ModelAndViewContainer mavContainer,
                                    NativeWebRequest webRequest,
                                    WebDataBinderFactory binderFactory)
                             throws Exception
```
    Resolve the argument from the model or if not found instantiate it with its default if it is available. The model attribute is then populated with request values via data binding and optionally validated if @java.validation.Valid is present on the argument.
    指定者:
    resolveArgument 在接口中 HandlerMethodArgumentResolver
    参数:
    parameter - the method parameter to resolve. This parameter must have previously been passed to HandlerMethodArgumentResolver.supportsParameter(org.springframework.core.MethodParameter) which must have returned true.
    mavContainer - the ModelAndViewContainer for the current request
    webRequest - the current request
    binderFactory - a factory for creating WebDataBinder instances
    返回:
    the resolved argument value, or null
    抛出:
    BindException - if data binding and validation result in an error and the next method parameter is not of type Errors
    Exception - if WebDataBinder initialization fails
  - createAttribute
```
protected Object createAttribute(String attributeName,
                                 MethodParameter parameter,
                                 WebDataBinderFactory binderFactory,
                                 NativeWebRequest webRequest)
                          throws Exception
```
    Extension point to create the model attribute if not found in the model. The default implementation uses the default constructor.
    参数:
    attributeName - the name of the attribute (never null)
    parameter - the method parameter
    binderFactory - for creating WebDataBinder instance
    webRequest - the current request
    返回:
    the created model attribute (never null)
    抛出:
    Exception
  - bindRequestParameters
```
protected void bindRequestParameters(WebDataBinder binder,
                                     NativeWebRequest request)
```
    Extension point to bind the request to the target object.
    参数:
    binder - the data binder instance to use for the binding
    request - the current request
  - validateIfApplicable
```
protected void validateIfApplicable(WebDataBinder binder,
                                    MethodParameter parameter)
```
    Validate the model attribute if applicable.
    The default implementation checks for @javax.validation.Valid, Spring's Validated, and custom annotations whose name starts with "Valid".
    参数:
    binder - the DataBinder to be used
    parameter - the method parameter declaration
  - isBindExceptionRequired
```
protected boolean isBindExceptionRequired(WebDataBinder binder,
                                          MethodParameter parameter)
```
    Whether to raise a fatal bind exception on validation errors.
    参数:
    binder - the data binder used to perform data binding
    parameter - the method parameter declaration
    返回:
    true if the next method parameter is not of type Errors
  - supportsReturnType
```
public boolean supportsReturnType(MethodParameter returnType)
```
    Return true if there is a method-level @ModelAttribute or, in default resolution mode, for any return value type that is not a simple type.
    指定者:
    supportsReturnType 在接口中 HandlerMethodReturnValueHandler
    参数:
    returnType - the method return type to check
    返回:
    true if this handler supports the supplied return type; false otherwise
  - handleReturnValue
```
public void handleReturnValue(Object returnValue,
                              MethodParameter returnType,
                              ModelAndViewContainer mavContainer,
                              NativeWebRequest webRequest)
                       throws Exception
```
    Add non-null return values to the ModelAndViewContainer.
    指定者:
    handleReturnValue 在接口中 HandlerMethodReturnValueHandler
    参数:
    returnValue - the value returned from the handler method
    returnType - the type of the return value. This type must have previously been passed to HandlerMethodReturnValueHandler.supportsReturnType(org.springframework.core.MethodParameter) which must have returned true.
    mavContainer - the ModelAndViewContainer for the current request
    webRequest - the current request
    抛出:
    Exception - if the return value handling results in an error

类 ModelAttributeMethodProcessor

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

logger

构造器详细资料

ModelAttributeMethodProcessor

方法详细资料

supportsParameter

resolveArgument

createAttribute

bindRequestParameters

validateIfApplicable

isBindExceptionRequired

supportsReturnType

handleReturnValue