org.springframework.web.portlet.handler
Class AbstractHandlerMapping

java.lang.Object
  org.springframework.context.support.ApplicationObjectSupport
      org.springframework.web.portlet.handler.AbstractHandlerMapping

All Implemented Interfaces:

ApplicationContextAware, Ordered, HandlerMapping

Direct Known Subclasses:

AbstractMapBasedHandlerMapping

public abstract class AbstractHandlerMapping
extends ApplicationObjectSupport
implements HandlerMapping, Ordered

Abstract base class for HandlerMapping implementations. Supports ordering, a default handler, and handler interceptors.

Since:

2.0

Author:

Juergen Hoeller, John A. Lewis

See Also:

getHandlerInternal(javax.portlet.PortletRequest), HandlerInterceptor

Field Summary

Fields inherited from class org.springframework.context.support.ApplicationObjectSupport

logger

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

AbstractHandlerMapping()

Method Summary

protected HandlerInterceptor	adaptInterceptor(Object interceptor) Adapt the given interceptor object to the HandlerInterceptor interface.
protected Object	getDefaultHandler() Return the default handler for this handler mapping, or null if none.
HandlerExecutionChain	getHandler(PortletRequest request) Look up a handler for the given request, falling back to the default handler if no specific one is found.
protected abstract Object	getHandlerInternal(PortletRequest request) Look up a handler for the given request, returning null if no specific one is found.
int	getOrder() Return the order value of this object, with a higher value meaning greater in terms of sorting.
protected void	initApplicationContext() Calls the initInterceptors() method.
protected void	initInterceptors() Initialize the specified interceptors, adapting them where necessary.
void	setApplyWebRequestInterceptorsToRenderPhaseOnly(boolean applyWebRequestInterceptorsToRenderPhaseOnly) Specify whether to apply WebRequestInterceptors to the Portlet render phase only ("true", or whether to apply them to the Portlet action phase as well ("false").
void	setDefaultHandler(Object defaultHandler) Set the default handler for this handler mapping.
void	setInterceptors(Object[] interceptors) Set the interceptors to apply for all handlers mapped by this handler mapping.
void	setOrder(int order)

Methods inherited from class org.springframework.context.support.ApplicationObjectSupport

getApplicationContext, getMessageSourceAccessor, isContextRequired, requiredContextClass, setApplicationContext

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractHandlerMapping

public AbstractHandlerMapping()

Method Detail

setOrder

public final void setOrder(int order)

getOrder

public final int getOrder()

Description copied from interface: Ordered

Return the order value of this object, with a higher value meaning greater in terms of sorting.

Normally starting with 0 or 1, with Ordered.LOWEST_PRECEDENCE indicating greatest. Same order values will result in arbitrary positions for the affected objects.

Higher value can be interpreted as lower priority, consequently the first object has highest priority (somewhat analogous to Servlet "load-on-startup" values).

Note that order values below 0 are reserved for framework purposes. Application-specified values should always be 0 or greater, with only framework components (internal or third-party) supposed to use lower values.

Specified by:

getOrder in interface Ordered

Returns:

the order value

See Also:

Ordered.LOWEST_PRECEDENCE

setDefaultHandler

public final void setDefaultHandler(Object defaultHandler)

Set the default handler for this handler mapping. This handler will be returned if no specific mapping was found.

Default is null, indicating no default handler.

getDefaultHandler

protected final Object getDefaultHandler()

Return the default handler for this handler mapping, or null if none.

setInterceptors

public final void setInterceptors(Object[] interceptors)

Set the interceptors to apply for all handlers mapped by this handler mapping.

Supported interceptor types are HandlerInterceptor and WebRequestInterceptor. Each given WebRequestInterceptor will be wrapped in a WebRequestHandlerInterceptorAdapter.

Parameters:

interceptors - array of handler interceptors, or null if none

See Also:

adaptInterceptor(java.lang.Object), HandlerInterceptor, WebRequestInterceptor

setApplyWebRequestInterceptorsToRenderPhaseOnly

public void setApplyWebRequestInterceptorsToRenderPhaseOnly(boolean applyWebRequestInterceptorsToRenderPhaseOnly)

Specify whether to apply WebRequestInterceptors to the Portlet render phase only ("true", or whether to apply them to the Portlet action phase as well ("false").

Default is "true", since WebRequestInterceptors are usually built for MVC-style handler execution plus rendering process (which is, for example, the primary target scenario for "Open Session in View" interceptors, offering lazy loading of persistent objects during view rendering). Set this to "false" to have WebRequestInterceptors apply to the action phase as well (for example, in case of an "Open Session in View" interceptor, to allow for lazy loading outside of a transaction during the action phase).

See Also:

setInterceptors(java.lang.Object[]), WebRequestInterceptor, WebRequestHandlerInterceptorAdapter.WebRequestHandlerInterceptorAdapter(WebRequestInterceptor, boolean), OpenSessionInViewInterceptor

initApplicationContext

protected void initApplicationContext()
                               throws BeansException

Calls the initInterceptors() method.

Overrides:

initApplicationContext in class ApplicationObjectSupport

Throws:

ApplicationContextException - in case of initialization errors

BeansException - if thrown by ApplicationContext methods

See Also:

initInterceptors()

initInterceptors

protected void initInterceptors()

Initialize the specified interceptors, adapting them where necessary.

See Also:

setInterceptors(java.lang.Object[]), adaptInterceptor(java.lang.Object)

adaptInterceptor

protected HandlerInterceptor adaptInterceptor(Object interceptor)

Adapt the given interceptor object to the HandlerInterceptor interface.

Supported interceptor types are HandlerInterceptor and WebRequestInterceptor. Each given WebRequestInterceptor will be wrapped in a WebRequestHandlerInterceptorAdapter. Can be overridden in subclasses.

Parameters:

interceptor - the specified interceptor object

Returns:

the interceptor wrapped as HandlerInterceptor

See Also:

setApplyWebRequestInterceptorsToRenderPhaseOnly(boolean), HandlerInterceptor, WebRequestInterceptor, WebRequestHandlerInterceptorAdapter

getHandler

public final HandlerExecutionChain getHandler(PortletRequest request)
                                       throws Exception

Look up a handler for the given request, falling back to the default handler if no specific one is found.

Specified by:

getHandler in interface HandlerMapping

Parameters:

request - current HTTP request

Returns:

the corresponding handler instance, or the default handler

Throws:

Exception - if there is an internal error

See Also:

getHandlerInternal(javax.portlet.PortletRequest)

getHandlerInternal

protected abstract Object getHandlerInternal(PortletRequest request)
                                      throws Exception

Look up a handler for the given request, returning null if no specific one is found. This method is called by getHandler; a null return value will lead to the default handler, if one is set.

Parameters:

request - current portlet request

Returns:

the corresponding handler instance, or null if none found

Throws:

Exception - if there is an internal error

See Also:

getHandler(javax.portlet.PortletRequest)