java.lang.Object | |
↳ | org.springframework.web.servlet.view.tiles2.TilesConfigurer |
Helper class to configure Tiles 2.x for the Spring Framework. See http://tiles.apache.org for more information about Tiles, which basically is a templating mechanism for JSP-based web applications. Note: Spring 3.0 requires Tiles 2.1.2 or above, with explicit support for Tiles 2.2. Tiles 2.1's EL support will be activated by default when running on JSP 2.1 or above and when the Tiles EL module is present in the classpath.
The TilesConfigurer simply configures a TilesContainer using a set of files
containing definitions, to be accessed by TilesView
instances. This is a
Spring-based alternative (for usage in Spring configuration) to the Tiles-provided
org.apache.tiles.web.startup.TilesListener (for usage in web.xml
).
TilesViews can be managed by any ViewResolver
.
For simple convention-based view resolution, consider using TilesViewResolver
.
A typical TilesConfigurer bean definition looks as follows:
<bean id="tilesConfigurer" class="org.springframework.web.servlet.view.tiles2.TilesConfigurer"> <property name="definitions"> <list> <value>/WEB-INF/defs/general.xml</value> <value>/WEB-INF/defs/widgets.xml</value> <value>/WEB-INF/defs/administrator.xml</value> <value>/WEB-INF/defs/customer.xml</value> <value>/WEB-INF/defs/templates.xml</value> </list> </property> </bean>The values in the list are the actual Tiles XML files containing the definitions.
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
logger |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Creates and exposes a TilesContainer for this web application,
delegating to the TilesInitializer.
| |||||||||||
Removes the TilesContainer from this web application.
| |||||||||||
Set whether to check Tiles definition files for a refresh at runtime.
| |||||||||||
Specify whether to apply Tiles 2.2's "complete-autoload" configuration.
| |||||||||||
Set the Tiles definitions, i.e.
| |||||||||||
Set the org.apache.tiles.definition.DefinitionsFactory implementation to use.
| |||||||||||
Set the org.apache.tiles.preparer.PreparerFactory implementation to use.
| |||||||||||
Set the ServletContext that this object runs in.
| |||||||||||
Configure Tiles using a custom TilesInitializer, typically specified as an inner bean.
| |||||||||||
Set Tiles properties (equivalent to the ServletContext init-params in
the Tiles documentation), overriding the default settings.
| |||||||||||
Set whether to use a MutableTilesContainer (typically the CachingTilesContainer
implementation) for this application.
| |||||||||||
Set whether to validate the Tiles XML definitions.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Creates a new instance of org.apache.tiles.startup.BasicTilesInitializer.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
From interface
org.springframework.beans.factory.DisposableBean
| |||||||||||
From interface
org.springframework.beans.factory.InitializingBean
| |||||||||||
From interface
org.springframework.web.context.ServletContextAware
|
Creates and exposes a TilesContainer for this web application, delegating to the TilesInitializer.
in case of setup failure | |
TilesException |
Removes the TilesContainer from this web application.
in case of cleanup failure | |
TilesException |
Set whether to check Tiles definition files for a refresh at runtime. Default is "false".
Specify whether to apply Tiles 2.2's "complete-autoload" configuration.
See org.apache.tiles.extras.complete.CompleteAutoloadTilesContainerFactory for details on the complete-autoload mode.
NOTE: Specifying the complete-autoload mode effectively disables all other bean properties on this configurer. The entire initialization procedure is then left to org.apache.tiles.extras.complete.CompleteAutoloadTilesInitializer.
Set the Tiles definitions, i.e. the list of files containing the definitions. Default is "/WEB-INF/tiles.xml".
Set the org.apache.tiles.definition.DefinitionsFactory implementation to use. Default is org.apache.tiles.definition.UrlDefinitionsFactory, operating on definition resource URLs.
Specify a custom DefinitionsFactory, e.g. a UrlDefinitionsFactory subclass,
to customize the creation of Tiles Definition objects. Note that such a
DefinitionsFactory has to be able to handle URL
source objects,
unless you configure a different TilesContainerFactory.
Set the org.apache.tiles.preparer.PreparerFactory implementation to use. Default is org.apache.tiles.preparer.BasicPreparerFactory, creating shared instances for specified preparer classes.
Specify SimpleSpringPreparerFactory
to autowire
org.apache.tiles.preparer.ViewPreparer instances based on specified
preparer classes, applying Spring's container callbacks as well as applying
configured Spring BeanPostProcessors. If Spring's context-wide annotation-config
has been activated, annotations in ViewPreparer classes will be automatically
detected and applied.
Specify SpringBeanPreparerFactory
to operate on specified preparer
names instead of classes, obtaining the corresponding Spring bean from
the DispatcherServlet's application context. The full bean creation process
will be in the control of the Spring application context in this case,
allowing for the use of scoped beans etc. Note that you need to define one
Spring bean definition per preparer name (as used in your Tiles definitions).
Set the ServletContext that this object runs in.
Invoked after population of normal bean properties but before an init
callback like InitializingBean's afterPropertiesSet
or a
custom init-method. Invoked after ApplicationContextAware's
setApplicationContext
.
servletContext | ServletContext object to be used by this object |
---|
Configure Tiles using a custom TilesInitializer, typically specified as an inner bean.
Default is a variant of org.apache.tiles.startup.DefaultTilesInitializer, respecting the "definitions", "preparerFactoryClass" etc properties on this configurer.
NOTE: Specifying a custom TilesInitializer effectively disables all other bean properties on this configurer. The entire initialization procedure is then left to the TilesInitializer as specified.
Set Tiles properties (equivalent to the ServletContext init-params in the Tiles documentation), overriding the default settings.
NOTE: This property is only effective with Tiles 2.1. Tiles 2.2 doesn't support property-based configuration anymore.
Set whether to use a MutableTilesContainer (typically the CachingTilesContainer implementation) for this application. Default is "false".
Set whether to validate the Tiles XML definitions. Default is "true".
Creates a new instance of org.apache.tiles.startup.BasicTilesInitializer.
Override it to use a different initializer.