org.apache.tiles.web.util

Class TilesDecorationFilter

java.lang.Object

org.apache.tiles.web.util.TilesDecorationFilter

All Implemented Interfaces:

javax.servlet.Filter

public class TilesDecorationFilter
extends Object
implements javax.servlet.Filter

Decoration Filter. Intercepts all requests and decorates them with the configured definition.

For example, given the following config: <xmp> <filter> <filter-name>Tiles Decoration Filter</filter-name> <filter-class>org.apache.tiles.web.TilesDecorationFilter</filter-class> <init-param> <param-name>definition</param-name> <param-value>test.definition</param-value> </init-param> <init-param> <param-name>attribute-name</param-name> <param-value>body</param-value> </init-param> <init-param> <param-name>prevent-token</param-name> <param-value>layout</param-value> </init-param> </filter>

<filter-mapping> <filter-name>Tiles Decoration Filter</filter-name> <url-pattern>/testdecorationfilter.jsp</url-pattern> <dispatcher>REQUEST</dispatcher> </filter-mapping> </xmp> The filter will intercept all requests to the indicated url pattern store the initial request path as the "body" attribute and then render the "test.definition" definition. The filter will only redecorate those requests which do not contain the request attribute associated with the prevent token "layout".

Field Summary

Fields

Modifier and Type	Field and Description
static String	CONTAINER_KEY_INIT_PARAMETER Init parameter to define the key of the container to use.

Constructor Summary

Constructors

Constructor and Description
TilesDecorationFilter()

Method Summary

Methods

Modifier and Type	Method and Description
void	destroy()
void	doFilter(javax.servlet.ServletRequest req, javax.servlet.ServletResponse res, javax.servlet.FilterChain filterChain)
void	init(javax.servlet.FilterConfig config)
protected Map<String,String>	parseAlternateDefinitions() Creates the alternate definitions map, to map a mask of definition names to a configured definition.

Methods inherited from class java.lang.Object

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

Field Detail

CONTAINER_KEY_INIT_PARAMETER

public static final String CONTAINER_KEY_INIT_PARAMETER

Init parameter to define the key of the container to use.

Since:

2.1.2

See Also:

Constant Field Values

Constructor Detail

TilesDecorationFilter

public TilesDecorationFilter()

Method Detail

init

public void init(javax.servlet.FilterConfig config)
          throws javax.servlet.ServletException

Specified by:

init in interface javax.servlet.Filter

Throws:

javax.servlet.ServletException

parseAlternateDefinitions

protected Map<String,String> parseAlternateDefinitions()

Creates the alternate definitions map, to map a mask of definition names to a configured definition.

Returns:

The alternate definitions map.

destroy

public void destroy()

Specified by:

destroy in interface javax.servlet.Filter

doFilter

public void doFilter(javax.servlet.ServletRequest req,
            javax.servlet.ServletResponse res,
            javax.servlet.FilterChain filterChain)
              throws IOException,
                     javax.servlet.ServletException

Specified by:

doFilter in interface javax.servlet.Filter

Throws:

IOException

javax.servlet.ServletException