org.eclipse.jetty.servlet
Class ErrorPageErrorHandler

java.lang.Object
  extended by org.eclipse.jetty.util.component.AbstractLifeCycle
      extended by org.eclipse.jetty.util.component.AggregateLifeCycle
          extended by org.eclipse.jetty.server.handler.AbstractHandler
              extended by org.eclipse.jetty.server.handler.ErrorHandler
                  extended by org.eclipse.jetty.servlet.ErrorPageErrorHandler
All Implemented Interfaces:
Handler, Destroyable, Dumpable, LifeCycle

public class ErrorPageErrorHandler
extends ErrorHandler

Error Page Error Handler An ErrorHandler that maps exceptions and status codes to URIs for dispatch using the internal ERROR style of dispatch.


Nested Class Summary
 
Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle
AbstractLifeCycle.AbstractLifeCycleListener
 
Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle
LifeCycle.Listener
 
Field Summary
protected  ServletContext _servletContext
           
static String ERROR_PAGE
           
 
Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle
_listeners, FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING
 
Constructor Summary
ErrorPageErrorHandler()
           
 
Method Summary
 void addErrorPage(Class<? extends Throwable> exception, String uri)
          Add Error Page mapping for an exception class This method is called as a result of an exception-type element in a web.xml file or may be called directly
 void addErrorPage(int from, int to, String uri)
          Add Error Page mapping for a status code range.
 void addErrorPage(int code, String uri)
          Add Error Page mapping for a status code.
 void addErrorPage(String exceptionClassName, String uri)
          Add Error Page mapping for an exception class This method is called as a result of an exception-type element in a web.xml file or may be called directly
protected  void doStart()
           
protected  void doStop()
           
 Map<String,String> getErrorPages()
           
 void handle(String target, Request baseRequest, HttpServletRequest request, HttpServletResponse response)
          Handle a request.
 void setErrorPages(Map<String,String> errorPages)
           
 
Methods inherited from class org.eclipse.jetty.server.handler.ErrorHandler
getCacheControl, handleErrorPage, isShowStacks, setCacheControl, setShowStacks, write, writeErrorPage, writeErrorPageBody, writeErrorPageHead, writeErrorPageMessage, writeErrorPageStacks
 
Methods inherited from class org.eclipse.jetty.server.handler.AbstractHandler
destroy, dumpThis, getServer, setServer
 
Methods inherited from class org.eclipse.jetty.util.component.AggregateLifeCycle
addBean, dump, dump, dump, dump, dump, dumpStdErr, getBean, getBeans, getBeans, removeBean, removeBeans
 
Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle
addLifeCycleListener, getState, getState, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface org.eclipse.jetty.util.component.LifeCycle
addLifeCycleListener, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop
 

Field Detail

ERROR_PAGE

public static final String ERROR_PAGE
See Also:
Constant Field Values

_servletContext

protected ServletContext _servletContext
Constructor Detail

ErrorPageErrorHandler

public ErrorPageErrorHandler()
Method Detail

handle

public void handle(String target,
                   Request baseRequest,
                   HttpServletRequest request,
                   HttpServletResponse response)
            throws IOException
Description copied from interface: Handler
Handle a request.

Specified by:
handle in interface Handler
Overrides:
handle in class ErrorHandler
Parameters:
target - The target of the request - either a URI or a name.
baseRequest - The original unwrapped request object.
request - The request either as the Request object or a wrapper of that request. The HttpConnection.getCurrentConnection() method can be used access the Request object if required.
response - The response as the Response object or a wrapper of that request. The HttpConnection.getCurrentConnection() method can be used access the Response object if required.
Throws:
IOException
See Also:
ErrorHandler.handle(String, Request, HttpServletRequest, HttpServletResponse)

getErrorPages

public Map<String,String> getErrorPages()
Returns:
Returns the errorPages.

setErrorPages

public void setErrorPages(Map<String,String> errorPages)
Parameters:
errorPages - The errorPages to set. A map of Exception class name or error code as a string to URI string

addErrorPage

public void addErrorPage(Class<? extends Throwable> exception,
                         String uri)
Add Error Page mapping for an exception class This method is called as a result of an exception-type element in a web.xml file or may be called directly

Parameters:
exception - The exception
uri - The URI of the error page.

addErrorPage

public void addErrorPage(String exceptionClassName,
                         String uri)
Add Error Page mapping for an exception class This method is called as a result of an exception-type element in a web.xml file or may be called directly

Parameters:
exceptionClassName - The exception
uri - The URI of the error page.

addErrorPage

public void addErrorPage(int code,
                         String uri)
Add Error Page mapping for a status code. This method is called as a result of an error-code element in a web.xml file or may be called directly

Parameters:
code - The HTTP status code to match
uri - The URI of the error page.

addErrorPage

public void addErrorPage(int from,
                         int to,
                         String uri)
Add Error Page mapping for a status code range. This method is not available from web.xml and must be called directly.

Parameters:
from - The lowest matching status code
to - The highest matching status code
uri - The URI of the error page.

doStart

protected void doStart()
                throws Exception
Overrides:
doStart in class AbstractHandler
Throws:
Exception

doStop

protected void doStop()
               throws Exception
Overrides:
doStop in class AbstractHandler
Throws:
Exception


Copyright © 1995-2011 Mort Bay Consulting. All Rights Reserved.