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

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

setOriginalPage

public static void setOriginalPage(String page)

Sets the current-thread original page.

getOriginalPagePath

public static String getOriginalPagePath(javax.servlet.http.HttpServletRequest request)

Gets the original page path corresponding to the original request before any forward/include. Assumes all forward/include done with ao taglib.

getDispatchedPage

public static String getDispatchedPage()

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

setDispatchedPage

public static void setDispatchedPage(String page)

Sets the current-thread dispatched page.

getCurrentPagePath

public static String getCurrentPagePath(javax.servlet.http.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(javax.servlet.ServletContext servletContext,
                           String page,
                           javax.servlet.http.HttpServletRequest request,
                           javax.servlet.http.HttpServletResponse response,
                           Map<String,?> args)
                    throws javax.servlet.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:

javax.servlet.ServletException

IOException

forward

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

Throws:

javax.servlet.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(javax.servlet.ServletContext servletContext,
                           String page,
                           javax.servlet.http.HttpServletRequest request,
                           javax.servlet.http.HttpServletResponse response,
                           Map<String,?> args)
                    throws javax.servlet.jsp.SkipPageException,
                           javax.servlet.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:

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

javax.servlet.ServletException

IOException

include

public static void include(javax.servlet.ServletContext servletContext,
                           String page,
                           javax.servlet.http.HttpServletRequest request,
                           javax.servlet.http.HttpServletResponse response)
                    throws javax.servlet.jsp.SkipPageException,
                           javax.servlet.ServletException,
                           IOException

Throws:

javax.servlet.jsp.SkipPageException

javax.servlet.ServletException

IOException

See Also:

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