org.springframework.web.servlet

Class HandlerExecutionChain

java.lang.Object

org.springframework.web.servlet.HandlerExecutionChain

public class HandlerExecutionChain
extends java.lang.Object

Handler execution chain, consisting of handler object and any handler interceptors. Returned by HandlerMapping's HandlerMapping.getHandler(HttpServletRequest) method.

Since:

20.06.2003

Author:

Juergen Hoeller

See Also:

HandlerInterceptor

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.Object	handler
private int	interceptorIndex
private java.util.List<HandlerInterceptor>	interceptorList
private HandlerInterceptor[]	interceptors
private static Log	logger

Constructor Summary

Constructors

Constructor and Description
HandlerExecutionChain(java.lang.Object handler) Create a new HandlerExecutionChain.
HandlerExecutionChain(java.lang.Object handler, HandlerInterceptor... interceptors) Create a new HandlerExecutionChain.

Method Summary

Modifier and Type	Method and Description
void	addInterceptor(HandlerInterceptor interceptor)
void	addInterceptors(HandlerInterceptor... interceptors)
(package private) void	applyAfterConcurrentHandlingStarted(HttpServletRequest request, HttpServletResponse response) Apply afterConcurrentHandlerStarted callback on mapped AsyncHandlerInterceptors.
(package private) void	applyPostHandle(HttpServletRequest request, HttpServletResponse response, ModelAndView mv) Apply postHandle methods of registered interceptors.
(package private) boolean	applyPreHandle(HttpServletRequest request, HttpServletResponse response) Apply preHandle methods of registered interceptors.
java.lang.Object	getHandler() Return the handler object to execute.
HandlerInterceptor[]	getInterceptors() Return the array of interceptors to apply (in the given order).
private java.util.List<HandlerInterceptor>	initInterceptorList()
java.lang.String	toString() Delegates to the handler's toString().
(package private) void	triggerAfterCompletion(HttpServletRequest request, HttpServletResponse response, java.lang.Exception ex) Trigger afterCompletion callbacks on the mapped HandlerInterceptors.

Methods inherited from class java.lang.Object

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

Field Detail

logger

private static final Log logger

handler

private final java.lang.Object handler

interceptors

private HandlerInterceptor[] interceptors

interceptorList

private java.util.List<HandlerInterceptor> interceptorList

interceptorIndex

private int interceptorIndex

Constructor Detail

HandlerExecutionChain

public HandlerExecutionChain(java.lang.Object handler)

Create a new HandlerExecutionChain.

Parameters:

handler - the handler object to execute

HandlerExecutionChain

public HandlerExecutionChain(java.lang.Object handler,
                             HandlerInterceptor... interceptors)

Create a new HandlerExecutionChain.

Parameters:

handler - the handler object to execute

interceptors - the array of interceptors to apply (in the given order) before the handler itself executes

Method Detail

getHandler

public java.lang.Object getHandler()

Return the handler object to execute.

Returns:

the handler object

addInterceptor

public void addInterceptor(HandlerInterceptor interceptor)

addInterceptors

public void addInterceptors(HandlerInterceptor... interceptors)

initInterceptorList

private java.util.List<HandlerInterceptor> initInterceptorList()

getInterceptors

public HandlerInterceptor[] getInterceptors()

Return the array of interceptors to apply (in the given order).

Returns:

the array of HandlerInterceptors instances (may be null)

applyPreHandle

boolean applyPreHandle(HttpServletRequest request,
                       HttpServletResponse response)
                throws java.lang.Exception

Apply preHandle methods of registered interceptors.

Returns:

true if the execution chain should proceed with the next interceptor or the handler itself. Else, DispatcherServlet assumes that this interceptor has already dealt with the response itself.

Throws:

java.lang.Exception

applyPostHandle

void applyPostHandle(HttpServletRequest request,
                     HttpServletResponse response,
                     ModelAndView mv)
              throws java.lang.Exception

Apply postHandle methods of registered interceptors.

Throws:

java.lang.Exception

triggerAfterCompletion

void triggerAfterCompletion(HttpServletRequest request,
                            HttpServletResponse response,
                            java.lang.Exception ex)
                     throws java.lang.Exception

Trigger afterCompletion callbacks on the mapped HandlerInterceptors. Will just invoke afterCompletion for all interceptors whose preHandle invocation has successfully completed and returned true.

Throws:

java.lang.Exception

applyAfterConcurrentHandlingStarted

void applyAfterConcurrentHandlingStarted(HttpServletRequest request,
                                         HttpServletResponse response)

Apply afterConcurrentHandlerStarted callback on mapped AsyncHandlerInterceptors.

toString

public java.lang.String toString()

Delegates to the handler's toString().

Overrides:

toString in class java.lang.Object