org.eclipse.jetty.servlet

## Class ErrorPageErrorHandler

- java.lang.Object
- - org.eclipse.jetty.util.component.AbstractLifeCycle
  - - org.eclipse.jetty.util.component.AggregateLifeCycle
    - - org.eclipse.jetty.server.handler.AbstractHandler
      - - org.eclipse.jetty.server.handler.ErrorHandler
        - - org.eclipse.jetty.servlet.ErrorPageErrorHandler

- All Implemented Interfaces:
    Handler, ErrorHandler.ErrorPageMapper, Destroyable, Dumpable, LifeCycle

      public class ErrorPageErrorHandler
      extends ErrorHandler
      implements ErrorHandler.ErrorPageMapper

  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.server.handler.ErrorHandler

      `ErrorHandler.ErrorPageMapper`

    - ### 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

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `protected javax.servlet.ServletContext` | `_servletContext`
    `static String` | `GLOBAL_ERROR_PAGE`

    - ### Fields inherited from class org.eclipse.jetty.server.handler.ErrorHandler

      `ERROR_PAGE`

    - ### Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

      `_listeners, FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING`

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `ErrorPageErrorHandler()`

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `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()` Start the managed lifecycle beans in the order they were added.
    `String` | `getErrorPage(javax.servlet.http.HttpServletRequest request)`
    `Map<String,String>` | `getErrorPages()`
    `void` | `setErrorPages(Map<String,String> errorPages)`

    - ### Methods inherited from class org.eclipse.jetty.server.handler.ErrorHandler

      `getCacheControl, getShowMessageInTitle, handle, handleErrorPage, isShowStacks, setCacheControl, setShowMessageInTitle, setShowStacks, write, writeErrorPage, writeErrorPageBody, writeErrorPageHead, writeErrorPageMessage, writeErrorPageStacks`

    - ### Methods inherited from class org.eclipse.jetty.server.handler.AbstractHandler

      `destroy, doStop, dumpThis, getServer, setServer`

    - ### Methods inherited from class org.eclipse.jetty.util.component.AggregateLifeCycle

      `addBean, addBean, contains, dump, dump, dump, dump, dump, dumpObject, dumpStdErr, getBean, getBeans, getBeans, isManaged, manage, removeBean, removeBeans, unmanage`

    - ### 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

    - #### GLOBAL_ERROR_PAGE

          public static final String GLOBAL_ERROR_PAGE

      See Also:
        Constant Field Values

    - #### _servletContext

          protected javax.servlet.ServletContext _servletContext

  - ### Constructor Detail

    - #### ErrorPageErrorHandler

          public ErrorPageErrorHandler()

  - ### Method Detail

    - #### getErrorPage

          public String getErrorPage(javax.servlet.http.HttpServletRequest request)

      Specified by:
        `getErrorPage` in interface `ErrorHandler.ErrorPageMapper`

    - #### 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

      Description copied from class: `AggregateLifeCycle`
      Start the managed lifecycle beans in the order they were added.
      Overrides:
        `doStart` in class `AbstractHandler`
      Throws:
        `Exception`
      See Also:
        `AbstractLifeCycle.doStart()`

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