org.springframework.web.servlet.view.tiles
Class TilesView

java.lang.Object
  org.springframework.context.support.ApplicationObjectSupport
      org.springframework.web.context.support.WebApplicationObjectSupport
          org.springframework.web.servlet.view.AbstractView
              org.springframework.web.servlet.view.AbstractUrlBasedView
                  org.springframework.web.servlet.view.InternalResourceView
                      org.springframework.web.servlet.view.tiles.TilesView

All Implemented Interfaces:

BeanNameAware, InitializingBean, ApplicationContextAware, ServletContextAware, View

Direct Known Subclasses:

TilesJstlView

public class TilesView
extends InternalResourceView

View implementation that retrieves a Tiles definition. The "url" property is interpreted as name of a Tiles definition.

TilesJstlView with JSTL support is a separate class, mainly to avoid JSTL dependencies in this class.

NOTE: This TilesView class supports Tiles 1.x, a.k.a. "Struts Tiles", which comes as part of Struts 1.x. For Tiles 2.x support, check out TilesView.

Depends on a Tiles DefinitionsFactory which must be available in the ServletContext. This factory is typically set up via a TilesConfigurer bean definition in the application context.

Check out ComponentControllerSupport which provides a convenient base class for Spring-aware component controllers, allowing convenient access to the Spring ApplicationContext.

Author:

Alef Arendsen, Juergen Hoeller

See Also:

AbstractUrlBasedView.setUrl(java.lang.String), TilesJstlView, TilesConfigurer, ComponentControllerSupport

Field Summary

static String

PATH_ATTRIBUTE Name of the attribute that will override the path of the layout page to render.

Fields inherited from class org.springframework.web.servlet.view.AbstractView

DEFAULT_CONTENT_TYPE

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

logger

Constructor Summary

TilesView()

Method Summary

protected void	executeController(Controller controller, ComponentContext context, HttpServletRequest request, HttpServletResponse response) Execute the given Tiles controller.
protected ComponentContext	getComponentContext(ComponentDefinition definition, HttpServletRequest request) Determine the Tiles component context for the given Tiles definition.
protected ComponentDefinition	getComponentDefinition(DefinitionsFactory factory, HttpServletRequest request) Determine the Tiles component definition for the given Tiles definitions factory.
protected Controller	getController(ComponentDefinition definition, HttpServletRequest request) Determine and initialize the Tiles component controller for the given Tiles definition, if any.
protected String	getDispatcherPath(ComponentDefinition definition, HttpServletRequest request) Determine the dispatcher path for the given Tiles definition, i.e. the request dispatcher path of the layout page.
protected void	initApplicationContext() Subclasses can override this for custom initialization behavior.
protected String	prepareForRendering(HttpServletRequest request, HttpServletResponse response) Prepare for rendering the Tiles definition: Execute the associated component controller if any, and determine the request dispatcher path.
static void	setPath(HttpServletRequest request, String path) Set the path of the layout page to render.

Methods inherited from class org.springframework.web.servlet.view.InternalResourceView

exposeForwardRequestAttributes, exposeHelpers, getRequestToExpose, initServletContext, isContextRequired, renderMergedOutputModel, setAlwaysInclude, setExposeContextBeansAsAttributes, setExposedContextBeanNames, setExposeForwardAttributes, setPreventDispatchLoop, useInclude

Methods inherited from class org.springframework.web.servlet.view.AbstractUrlBasedView

afterPropertiesSet, getUrl, isUrlRequired, setUrl, toString

Methods inherited from class org.springframework.web.servlet.view.AbstractView

addStaticAttribute, createRequestContext, exposeModelAsRequestAttributes, generatesDownloadContent, getAttributesMap, getBeanName, getContentType, getRequestContextAttribute, getStaticAttributes, prepareResponse, render, setAttributes, setAttributesCSV, setAttributesMap, setBeanName, setContentType, setRequestContextAttribute

Methods inherited from class org.springframework.web.context.support.WebApplicationObjectSupport

getServletContext, getTempDir, getWebApplicationContext, initApplicationContext, setServletContext

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

getApplicationContext, getMessageSourceAccessor, requiredContextClass, setApplicationContext

Methods inherited from class java.lang.Object

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

Field Detail

PATH_ATTRIBUTE

public static final String PATH_ATTRIBUTE

Name of the attribute that will override the path of the layout page to render. A Tiles component controller can set such an attribute to dynamically switch the look and feel of a Tiles page.

See Also:

setPath(javax.servlet.http.HttpServletRequest, java.lang.String)

Constructor Detail

TilesView

public TilesView()

Method Detail

setPath

public static void setPath(HttpServletRequest request,
                           String path)

Set the path of the layout page to render.

Parameters:

request - current HTTP request

path - the path of the layout page

See Also:

PATH_ATTRIBUTE

initApplicationContext

protected void initApplicationContext()
                               throws ApplicationContextException

Description copied from class: ApplicationObjectSupport

Subclasses can override this for custom initialization behavior.

The default implementation is empty. Called by ApplicationObjectSupport.initApplicationContext(org.springframework.context.ApplicationContext).

Overrides:

initApplicationContext in class ApplicationObjectSupport

Throws:

ApplicationContextException - in case of initialization errors

See Also:

ApplicationObjectSupport.setApplicationContext(org.springframework.context.ApplicationContext)

prepareForRendering

protected String prepareForRendering(HttpServletRequest request,
                                     HttpServletResponse response)
                              throws Exception

Prepare for rendering the Tiles definition: Execute the associated component controller if any, and determine the request dispatcher path.

Overrides:

prepareForRendering in class InternalResourceView

Parameters:

request - current HTTP request

response - current HTTP response

Returns:

the request dispatcher path to use

Throws:

Exception - if preparations failed

See Also:

AbstractUrlBasedView.getUrl(), prepareForRendering(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse)

getComponentDefinition

protected ComponentDefinition getComponentDefinition(DefinitionsFactory factory,
                                                     HttpServletRequest request)
                                              throws Exception

Determine the Tiles component definition for the given Tiles definitions factory.

Parameters:

factory - the Tiles definitions factory

request - current HTTP request

Returns:

the component definition

Throws:

Exception

getComponentContext

protected ComponentContext getComponentContext(ComponentDefinition definition,
                                               HttpServletRequest request)
                                        throws Exception

Determine the Tiles component context for the given Tiles definition.

Parameters:

definition - the Tiles definition to render

request - current HTTP request

Returns:

the component context

Throws:

Exception - if preparations failed

getController

protected Controller getController(ComponentDefinition definition,
                                   HttpServletRequest request)
                            throws Exception

Determine and initialize the Tiles component controller for the given Tiles definition, if any.

Parameters:

definition - the Tiles definition to render

request - current HTTP request

Returns:

the component controller to execute, or null if none

Throws:

Exception - if preparations failed

executeController

protected void executeController(Controller controller,
                                 ComponentContext context,
                                 HttpServletRequest request,
                                 HttpServletResponse response)
                          throws Exception

Execute the given Tiles controller.

Parameters:

controller - the component controller to execute

context - the component context

request - current HTTP request

response - current HTTP response

Throws:

Exception - if controller execution failed

getDispatcherPath

protected String getDispatcherPath(ComponentDefinition definition,
                                   HttpServletRequest request)
                            throws Exception

Determine the dispatcher path for the given Tiles definition, i.e. the request dispatcher path of the layout page.

Parameters:

definition - the Tiles definition to render

request - current HTTP request

Returns:

the path of the layout page to render

Throws:

Exception - if preparations failed