org.springframework.web.method.support

Class InvocableHandlerMethod

java.lang.Object

org.springframework.web.method.HandlerMethod

org.springframework.web.method.support.InvocableHandlerMethod

Direct Known Subclasses:

ServletInvocableHandlerMethod

public class InvocableHandlerMethod
extends HandlerMethod

Provides a method for invoking the handler method for a given request after resolving its method argument values through registered HandlerMethodArgumentResolvers.

Argument resolution often requires a WebDataBinder for data binding or for type conversion. Use the setDataBinderFactory(WebDataBinderFactory) property to supply a binder factory to pass to argument resolvers.

Use setHandlerMethodArgumentResolvers(org.springframework.web.method.support.HandlerMethodArgumentResolverComposite) to customize the list of argument resolvers.

Since:

3.1

Author:

Rossen Stoyanchev, Juergen Hoeller

Nested Class Summary

Nested classes/interfaces inherited from class org.springframework.web.method.HandlerMethod

HandlerMethod.HandlerMethodParameter

Field Summary

Fields inherited from class org.springframework.web.method.HandlerMethod

logger

Constructor Summary

Constructors

Constructor and Description
InvocableHandlerMethod(HandlerMethod handlerMethod) Create an instance from a HandlerMethod.
InvocableHandlerMethod(java.lang.Object bean, java.lang.reflect.Method method) Create an instance from a bean instance and a method.
InvocableHandlerMethod(java.lang.Object bean, java.lang.String methodName, java.lang.Class<?>... parameterTypes) Construct a new handler method with the given bean instance, method name and parameters.

Method Summary

Modifier and Type	Method and Description
protected java.lang.Object	doInvoke(java.lang.Object... args) Invoke the handler method with the given argument values.
protected java.lang.Object[]	getMethodArgumentValues(NativeWebRequest request, ModelAndViewContainer mavContainer, java.lang.Object... providedArgs) Get the method argument values for the current request, checking the provided argument values and falling back to the configured argument resolvers.
java.lang.Object	invokeForRequest(NativeWebRequest request, ModelAndViewContainer mavContainer, java.lang.Object... providedArgs) Invoke the method after resolving its argument values in the context of the given request.
void	setDataBinderFactory(WebDataBinderFactory dataBinderFactory) Set the WebDataBinderFactory to be passed to argument resolvers allowing them to create a WebDataBinder for data binding and type conversion purposes.
void	setHandlerMethodArgumentResolvers(HandlerMethodArgumentResolverComposite argumentResolvers) Set HandlerMethodArgumentResolvers to use to use for resolving method argument values.
void	setParameterNameDiscoverer(ParameterNameDiscoverer parameterNameDiscoverer) Set the ParameterNameDiscoverer for resolving parameter names when needed (e.g.

Methods inherited from class org.springframework.web.method.HandlerMethod

createWithResolvedBean, equals, getBean, getBeanType, getBridgedMethod, getMethod, getMethodAnnotation, getMethodParameters, getResolvedFromHandlerMethod, getResponseStatus, getResponseStatusReason, getReturnType, getReturnValueType, getShortLogMessage, hashCode, hasMethodAnnotation, isVoid, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

InvocableHandlerMethod

public InvocableHandlerMethod(HandlerMethod handlerMethod)

Create an instance from a HandlerMethod.

InvocableHandlerMethod

public InvocableHandlerMethod(java.lang.Object bean,
                              java.lang.reflect.Method method)

Create an instance from a bean instance and a method.

InvocableHandlerMethod

public InvocableHandlerMethod(java.lang.Object bean,
                              java.lang.String methodName,
                              java.lang.Class<?>... parameterTypes)
                       throws java.lang.NoSuchMethodException

Construct a new handler method with the given bean instance, method name and parameters.

Parameters:

bean - the object bean

methodName - the method name

parameterTypes - the method parameter types

Throws:

java.lang.NoSuchMethodException - when the method cannot be found

Method Detail

setDataBinderFactory

public void setDataBinderFactory(WebDataBinderFactory dataBinderFactory)

Set the WebDataBinderFactory to be passed to argument resolvers allowing them to create a WebDataBinder for data binding and type conversion purposes.

Parameters:

dataBinderFactory - the data binder factory.

setHandlerMethodArgumentResolvers

public void setHandlerMethodArgumentResolvers(HandlerMethodArgumentResolverComposite argumentResolvers)

Set HandlerMethodArgumentResolvers to use to use for resolving method argument values.

setParameterNameDiscoverer

public void setParameterNameDiscoverer(ParameterNameDiscoverer parameterNameDiscoverer)

Set the ParameterNameDiscoverer for resolving parameter names when needed (e.g. default request attribute name).

Default is a DefaultParameterNameDiscoverer.

invokeForRequest

@Nullable
public java.lang.Object invokeForRequest(NativeWebRequest request,
                                                   @Nullable
                                                   ModelAndViewContainer mavContainer,
                                                   java.lang.Object... providedArgs)
                                            throws java.lang.Exception

Invoke the method after resolving its argument values in the context of the given request.

Argument values are commonly resolved through HandlerMethodArgumentResolvers. The providedArgs parameter however may supply argument values to be used directly, i.e. without argument resolution. Examples of provided argument values include a WebDataBinder, a SessionStatus, or a thrown exception instance. Provided argument values are checked before argument resolvers.

Delegates to getMethodArgumentValues(org.springframework.web.context.request.NativeWebRequest, org.springframework.web.method.support.ModelAndViewContainer, java.lang.Object...) and calls doInvoke(java.lang.Object...) with the resolved arguments.

Parameters:

request - the current request

mavContainer - the ModelAndViewContainer for this request

providedArgs - "given" arguments matched by type, not resolved

Returns:

the raw value returned by the invoked method

Throws:

java.lang.Exception - raised if no suitable argument resolver can be found, or if the method raised an exception

See Also:

getMethodArgumentValues(org.springframework.web.context.request.NativeWebRequest, org.springframework.web.method.support.ModelAndViewContainer, java.lang.Object...), doInvoke(java.lang.Object...)

getMethodArgumentValues

protected java.lang.Object[] getMethodArgumentValues(NativeWebRequest request,
                                                     @Nullable
                                                     ModelAndViewContainer mavContainer,
                                                     java.lang.Object... providedArgs)
                                              throws java.lang.Exception

Get the method argument values for the current request, checking the provided argument values and falling back to the configured argument resolvers.

The resulting array will be passed into doInvoke(java.lang.Object...).

Throws:

java.lang.Exception

Since:

5.1.2

doInvoke

protected java.lang.Object doInvoke(java.lang.Object... args)
                             throws java.lang.Exception

Invoke the handler method with the given argument values.

Throws:

java.lang.Exception