com.aoindustries.servlet.http

Class Dispatcher

java.lang.Object

com.aoindustries.servlet.http.Dispatcher

public class Dispatcher
extends Object

Static utilities that may be useful by servlet/JSP/taglib environments.

Author:

AO Industries, Inc.

Field Summary

Fields

Modifier and Type	Field and Description
static String	ARG_MAP_REQUEST_ATTRIBUTE_NAME The name of the request-scope Map that will contain the arguments for the current page.

Method Summary

Modifier and Type	Method and Description
static void	forward(ServletContext servletContext, String page, HttpServletRequest request, HttpServletResponse response)
static void	forward(ServletContext servletContext, String page, HttpServletRequest request, HttpServletResponse response, Map<String,?> args) Performs a forward, allowing page-relative paths and setting all values compatible with <ao:forward> tag.
static String	getCurrentPagePath(HttpServletRequest request) Gets the current page path, including any effects from include/forward.
static String	getDispatchedPage(ServletRequest request) Gets the current-thread dispatched page or null if not set.
static String	getOriginalPage(ServletRequest request) Gets the current request original page or null if not set.
static String	getOriginalPagePath(HttpServletRequest request) Gets the original page path corresponding to the original request before any forward/include.
static void	include(ServletContext servletContext, String page, HttpServletRequest request, HttpServletResponse response)
static void	include(ServletContext servletContext, String page, HttpServletRequest request, HttpServletResponse response, Map<String,?> args) Performs an include, allowing page-relative paths and setting all values compatible with <ao:include> tag.
static void	setDispatchedPage(ServletRequest request, String dispatchedPage) Sets the current-thread dispatched page.
static void	setOriginalPage(ServletRequest request, String page) Sets the current request original page.

Methods inherited from class java.lang.Object

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

Field Detail

ARG_MAP_REQUEST_ATTRIBUTE_NAME

public static final String ARG_MAP_REQUEST_ATTRIBUTE_NAME

The name of the request-scope Map that will contain the arguments for the current page.

See Also:

Constant Field Values

Method Detail

getOriginalPage

public static String getOriginalPage(ServletRequest request)

Gets the current request original page or null if not set.

See Also:

for the version that uses current request as a default.

setOriginalPage

public static void setOriginalPage(ServletRequest request,
                                   String page)

Sets the current request original page.

getOriginalPagePath

public static String getOriginalPagePath(HttpServletRequest request)

Gets the original page path corresponding to the original request before any forward/include. Assumes all forward/include done with ao taglib. If no original page available, uses the servlet path from the provided request.

See Also:

getOriginalPage(javax.servlet.ServletRequest)

getDispatchedPage

public static String getDispatchedPage(ServletRequest request)

Gets the current-thread dispatched page or null if not set.

See Also:

for the version that uses current request as a default.

setDispatchedPage

public static void setDispatchedPage(ServletRequest request,
                                     String dispatchedPage)

Sets the current-thread dispatched page.

getCurrentPagePath

public static String getCurrentPagePath(HttpServletRequest request)

Gets the current page path, including any effects from include/forward. This will be the path of the current page on forward or include. Assumes all forward/include done with ao taglib. This may be used as a substitute for HttpServletRequest.getServletPath() when the current page is needed instead of the originally requested servlet.

forward

public static void forward(ServletContext servletContext,
                           String page,
                           HttpServletRequest request,
                           HttpServletResponse response,
                           Map<String,?> args)
                    throws ServletException,
                           IOException

Performs a forward, allowing page-relative paths and setting all values compatible with <ao:forward> tag.

Parameters:

args - The arguments for the page, make unmodifiable and accessible as request-scope var "arg"

Throws:

ServletException

IOException

forward

public static void forward(ServletContext servletContext,
                           String page,
                           HttpServletRequest request,
                           HttpServletResponse response)
                    throws ServletException,
                           IOException

Throws:

ServletException

IOException

See Also:

forward(javax.servlet.ServletContext, java.lang.String, javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, java.util.Map)

include

public static void include(ServletContext servletContext,
                           String page,
                           HttpServletRequest request,
                           HttpServletResponse response,
                           Map<String,?> args)
                    throws SkipPageException,
                           ServletException,
                           IOException

Performs an include, allowing page-relative paths and setting all values compatible with <ao:include> tag.

Parameters:

args - The arguments for the page, make unmodifiable and accessible as request-scope var "arg"

Throws:

SkipPageException - when the included page has been skipped due to a redirect.

ServletException

IOException

include

public static void include(ServletContext servletContext,
                           String page,
                           HttpServletRequest request,
                           HttpServletResponse response)
                    throws SkipPageException,
                           ServletException,
                           IOException

Throws:

SkipPageException

ServletException

IOException

See Also:

include(javax.servlet.ServletContext, java.lang.String, javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, java.util.Map)