org.springframework.web.method.annotation

Class ModelFactory

java.lang.Object

org.springframework.web.method.annotation.ModelFactory

public final class ModelFactory
extends java.lang.Object

Assist with initialization of the Model before controller method invocation and with updates to it after the invocation.

On initialization the model is populated with attributes temporarily stored in the session and through the invocation of @ModelAttribute methods.

On update model attributes are synchronized with the session and also BindingResult attributes are added if missing.

Since:

3.1

Author:

Rossen Stoyanchev

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	ModelFactory.ModelMethod

Field Summary

Fields

Modifier and Type	Field and Description
private WebDataBinderFactory	dataBinderFactory
private static Log	logger
private java.util.List<ModelFactory.ModelMethod>	modelMethods
private SessionAttributesHandler	sessionAttributesHandler

Constructor Summary

Constructors

Constructor and Description
ModelFactory(java.util.List<InvocableHandlerMethod> handlerMethods, WebDataBinderFactory binderFactory, SessionAttributesHandler attributeHandler) Create a new instance with the given @ModelAttribute methods.

Method Summary

Modifier and Type	Method and Description
private java.util.List<java.lang.String>	findSessionAttributeArguments(HandlerMethod handlerMethod) Find @ModelAttribute arguments also listed as @SessionAttributes.
static java.lang.String	getNameForParameter(MethodParameter parameter) Derive the model attribute name for a method parameter based on: the parameter @ModelAttribute annotation value the parameter type
static java.lang.String	getNameForReturnValue(java.lang.Object returnValue, MethodParameter returnType) Derive the model attribute name for the given return value based on: the method ModelAttribute annotation value the declared return type if it is more specific than Object the actual return value type
private ModelFactory.ModelMethod	getNextModelMethod(ModelAndViewContainer container)
void	initModel(NativeWebRequest request, ModelAndViewContainer container, HandlerMethod handlerMethod) Populate the model in the following order: Retrieve "known" session attributes listed as @SessionAttributes.
private void	invokeModelAttributeMethods(NativeWebRequest request, ModelAndViewContainer container) Invoke model attribute methods to populate the model.
private boolean	isBindingCandidate(java.lang.String attributeName, java.lang.Object value) Whether the given attribute requires a BindingResult in the model.
private void	updateBindingResult(NativeWebRequest request, ModelMap model) Add BindingResult attributes to the model for attributes that require it.
void	updateModel(NativeWebRequest request, ModelAndViewContainer container) Promote model attributes listed as @SessionAttributes to the session.

Methods inherited from class java.lang.Object

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

Field Detail

logger

private static final Log logger

modelMethods

private final java.util.List<ModelFactory.ModelMethod> modelMethods

dataBinderFactory

private final WebDataBinderFactory dataBinderFactory

sessionAttributesHandler

private final SessionAttributesHandler sessionAttributesHandler

Constructor Detail

ModelFactory

public ModelFactory(java.util.List<InvocableHandlerMethod> handlerMethods,
                    WebDataBinderFactory binderFactory,
                    SessionAttributesHandler attributeHandler)

Create a new instance with the given @ModelAttribute methods.

Parameters:

handlerMethods - the @ModelAttribute methods to invoke

binderFactory - for preparation of BindingResult attributes

attributeHandler - for access to session attributes

Method Detail

initModel

public void initModel(NativeWebRequest request,
                      ModelAndViewContainer container,
                      HandlerMethod handlerMethod)
               throws java.lang.Exception

Populate the model in the following order:

1. Retrieve "known" session attributes listed as @SessionAttributes.
2. Invoke @ModelAttribute methods
3. Find @ModelAttribute method arguments also listed as @SessionAttributes and ensure they're present in the model raising an exception if necessary.

Parameters:

request - the current request

container - a container with the model to be initialized

handlerMethod - the method for which the model is initialized

Throws:

java.lang.Exception - may arise from @ModelAttribute methods

invokeModelAttributeMethods

private void invokeModelAttributeMethods(NativeWebRequest request,
                                         ModelAndViewContainer container)
                                  throws java.lang.Exception

Invoke model attribute methods to populate the model. Attributes are added only if not already present in the model.

Throws:

java.lang.Exception

getNextModelMethod

private ModelFactory.ModelMethod getNextModelMethod(ModelAndViewContainer container)

findSessionAttributeArguments

private java.util.List<java.lang.String> findSessionAttributeArguments(HandlerMethod handlerMethod)

Find @ModelAttribute arguments also listed as @SessionAttributes.

updateModel

public void updateModel(NativeWebRequest request,
                        ModelAndViewContainer container)
                 throws java.lang.Exception

Promote model attributes listed as @SessionAttributes to the session. Add BindingResult attributes where necessary.

Parameters:

request - the current request

container - contains the model to update

Throws:

java.lang.Exception - if creating BindingResult attributes fails

updateBindingResult

private void updateBindingResult(NativeWebRequest request,
                                 ModelMap model)
                          throws java.lang.Exception

Add BindingResult attributes to the model for attributes that require it.

Throws:

java.lang.Exception

isBindingCandidate

private boolean isBindingCandidate(java.lang.String attributeName,
                                   java.lang.Object value)

Whether the given attribute requires a BindingResult in the model.

getNameForParameter

public static java.lang.String getNameForParameter(MethodParameter parameter)

Derive the model attribute name for a method parameter based on:

1. the parameter @ModelAttribute annotation value
2. the parameter type

Parameters:

parameter - a descriptor for the method parameter

Returns:

the derived name (never null or empty String)

getNameForReturnValue

public static java.lang.String getNameForReturnValue(java.lang.Object returnValue,
                                                     MethodParameter returnType)

Derive the model attribute name for the given return value based on:

1. the method ModelAttribute annotation value
2. the declared return type if it is more specific than Object
3. the actual return value type

Parameters:

returnValue - the value returned from a method invocation

returnType - a descriptor for the return type of the method

Returns:

the derived name (never null or empty String)