com.aoindustries.servlet.http

Class Includer

java.lang.Object

com.aoindustries.servlet.http.Includer

public class Includer
extends Object

Performs an include while allowing SkipPageException and sendError to escape the include. This is required to support redirecting from within an included page.

Author:

AO Industries, Inc.

Method Summary

Modifier and Type	Method and Description
static void	dispatchInclude(javax.servlet.RequestDispatcher dispatcher, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) Performs the actual include, supporting propagation of SkipPageException and sendError.
static void	sendError(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, int status)
static void	sendError(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, int status, String message) Sends an error.
static void	setLocation(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, String location) Sets a Location header.
static void	setPageSkipped(javax.servlet.ServletRequest request) Sets the skip page flag.

Methods inherited from class java.lang.Object

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

Method Detail

dispatchInclude

public static void dispatchInclude(javax.servlet.RequestDispatcher dispatcher,
                                   javax.servlet.http.HttpServletRequest request,
                                   javax.servlet.http.HttpServletResponse response)
                            throws javax.servlet.ServletException,
                                   IOException,
                                   javax.servlet.jsp.SkipPageException

Performs the actual include, supporting propagation of SkipPageException and sendError.

Throws:

javax.servlet.ServletException

IOException

javax.servlet.jsp.SkipPageException

setLocation

public static void setLocation(javax.servlet.http.HttpServletRequest request,
                               javax.servlet.http.HttpServletResponse response,
                               String location)

Sets a Location header. When not in an included page, calls setHeader directly. When inside of an include will set request attribute so outermost include can call setHeader.

sendError

public static void sendError(javax.servlet.http.HttpServletRequest request,
                             javax.servlet.http.HttpServletResponse response,
                             int status,
                             String message)
                      throws IOException

Sends an error. When not in an included page, calls sendError directly. When inside of an include will set request attribute so outermost include can call sendError.

Throws:

IOException

sendError

public static void sendError(javax.servlet.http.HttpServletRequest request,
                             javax.servlet.http.HttpServletResponse response,
                             int status)
                      throws IOException

Throws:

IOException

setPageSkipped

public static void setPageSkipped(javax.servlet.ServletRequest request)

Sets the skip page flag.