This project has retired. For details please refer to its Attic page.

org.apache.tiles.servlet.context
Class ServletTilesRequestContext

java.lang.Object
  org.apache.tiles.servlet.context.ServletTilesApplicationContext
      org.apache.tiles.servlet.context.ServletTilesRequestContext

All Implemented Interfaces:

TilesRequestContext, TilesApplicationContext

Direct Known Subclasses:

JspTilesRequestContext

public class ServletTilesRequestContext
extends ServletTilesApplicationContext
implements TilesRequestContext

Servlet-based implementation of the TilesApplicationContext interface.

Version:

$Rev: 632818 $ $Date: 2008-03-02 20:48:05 +0100 (Sun, 02 Mar 2008) $

Constructor Summary

ServletTilesRequestContext(ServletContext servletContext, HttpServletRequest request, HttpServletResponse response)
Creates a new instance of ServletTilesRequestContext.

Method Summary

void	dispatch(String path) Dispatches the request to a specified path.
protected void	forward(String path) Forwards to a path.
Map<String,String>	getHeader() Return an immutable Map that maps header names to the first (or only) header value (as a String).
Map<String,String[]>	getHeaderValues() Return an immutable Map that maps header names to the set of all values specified in the request (as a String array).
Map<String,String>	getParam() Return an immutable Map that maps request parameter names to the first (or only) value (as a String).
Map<String,String[]>	getParamValues() Return an immutable Map that maps request parameter names to the set of all values (as a String array).
HttpServletRequest	getRequest() Get the underlying request.
Locale	getRequestLocale() Return the preferred Locale in which the client will accept content.
Map<String,Object>	getRequestScope() Return a mutable Map that maps request scope attribute names to their values.
HttpServletResponse	getResponse() Get the underlying response.
Map<String,Object>	getSessionScope() Return a mutable Map that maps session scope attribute names to their values.
void	include(String path) Includes the response from the specified URL in the current response output.
void	initialize(HttpServletRequest request, HttpServletResponse response) Initialize (or reinitialize) this ServletTilesRequestContext instance for the specified Servlet API objects.
boolean	isUserInRole(String role) Determine whether or not the specified user is in the given role.
void	release() Release references to allocated resources acquired in initialize() of via subsequent processing.
protected IOException	wrapServletException(ServletException ex, String message) Wraps a ServletException to create an IOException with the root cause if present.

Methods inherited from class org.apache.tiles.servlet.context.ServletTilesApplicationContext

createRequestContext, getApplicationScope, getInitParams, getResource, getResources, getServletContext, initialize

Methods inherited from class java.lang.Object

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

Constructor Detail

ServletTilesRequestContext

public ServletTilesRequestContext(ServletContext servletContext,
                                  HttpServletRequest request,
                                  HttpServletResponse response)

Creates a new instance of ServletTilesRequestContext.

Parameters:

servletContext - The servlet context.

request - The request object.

response - The response object.

Method Detail

getHeader

public Map<String,String> getHeader()

Return an immutable Map that maps header names to the first (or only) header value (as a String).

Specified by:

getHeader in interface TilesRequestContext

Returns:

The header map.

getHeaderValues

public Map<String,String[]> getHeaderValues()

Return an immutable Map that maps header names to the set of all values specified in the request (as a String array). Header names must be matched in a case-insensitive manner.

Specified by:

getHeaderValues in interface TilesRequestContext

Returns:

The header values map.

getParam

public Map<String,String> getParam()

Return an immutable Map that maps request parameter names to the first (or only) value (as a String).

Specified by:

getParam in interface TilesRequestContext

Returns:

The parameter map.

getParamValues

public Map<String,String[]> getParamValues()

Return an immutable Map that maps request parameter names to the set of all values (as a String array).

Specified by:

getParamValues in interface TilesRequestContext

Returns:

The parameter values map.

getRequestScope

public Map<String,Object> getRequestScope()

Return a mutable Map that maps request scope attribute names to their values.

Specified by:

getRequestScope in interface TilesRequestContext

Returns:

The request scope map.

getSessionScope

public Map<String,Object> getSessionScope()

Return a mutable Map that maps session scope attribute names to their values.

Specified by:

getSessionScope in interface TilesRequestContext

Returns:

The request scope map.

dispatch

public void dispatch(String path)
              throws IOException

Dispatches the request to a specified path.

Specified by:

dispatch in interface TilesRequestContext

Parameters:

path - The path to dispatch to.

Throws:

IOException - If something goes wrong during dispatching.

forward

protected void forward(String path)
                throws IOException

Forwards to a path.

Parameters:

path - The path to forward to.

Throws:

IOException - If something goes wrong during the operation.

include

public void include(String path)
             throws IOException

Includes the response from the specified URL in the current response output.

Specified by:

include in interface TilesRequestContext

Parameters:

path - The path to include.

Throws:

IOException - If something goes wrong during inclusion.

getRequestLocale

public Locale getRequestLocale()

Return the preferred Locale in which the client will accept content.

Specified by:

getRequestLocale in interface TilesRequestContext

Returns:

The current request locale. It is the locale of the request object itself and it is NOT the locale that the user wants to use. See LocaleResolver to implement strategies to resolve locales.

getRequest

public HttpServletRequest getRequest()

Get the underlying request.

Specified by:

getRequest in interface TilesRequestContext

Returns:

The current request object.

getResponse

public HttpServletResponse getResponse()

Get the underlying response.

Specified by:

getResponse in interface TilesRequestContext

Returns:

The current request object.

initialize

public void initialize(HttpServletRequest request,
                       HttpServletResponse response)

Initialize (or reinitialize) this ServletTilesRequestContext instance for the specified Servlet API objects.

Parameters:

request - The HttpServletRequest for this request

response - The HttpServletResponse for this request

release

public void release()

Release references to allocated resources acquired in initialize() of via subsequent processing. After this method is called, subsequent calls to any other method than initialize() will return undefined results.

Overrides:

release in class ServletTilesApplicationContext

isUserInRole

public boolean isUserInRole(String role)

Determine whether or not the specified user is in the given role.

Specified by:

isUserInRole in interface TilesRequestContext

Parameters:

role - the role to check against.

Returns:

true if the user is in the given role.

wrapServletException

protected IOException wrapServletException(ServletException ex,
                                           String message)

Wraps a ServletException to create an IOException with the root cause if present.

Parameters:

ex - The exception to wrap.

message - The message of the exception.

Returns:

The wrapped exception.

Since:

2.0.6