Package org.eclipse.jetty.ee11.servlet

Class ErrorPageErrorHandler

java.lang.Object

org.eclipse.jetty.server.handler.ErrorHandler

org.eclipse.jetty.ee11.servlet.ErrorHandler

org.eclipse.jetty.ee11.servlet.ErrorPageErrorHandler

All Implemented Interfaces:

ErrorHandler.ErrorPageMapper, Request.Handler, Invocable

public class ErrorPageErrorHandler
extends ErrorHandler
implements ErrorHandler.ErrorPageMapper

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.ee11.servlet.ErrorHandler

ErrorHandler.ErrorPageMapper

Nested classes/interfaces inherited from class org.eclipse.jetty.server.handler.ErrorHandler

ErrorHandler.ErrorRequest

Nested classes/interfaces inherited from interface org.eclipse.jetty.ee11.servlet.ErrorHandler.ErrorPageMapper

ErrorHandler.ErrorPageMapper.ErrorPage, ErrorHandler.ErrorPageMapper.PageLookupTechnique

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.thread.Invocable

Invocable.Callable, Invocable.InvocationType, Invocable.ReadyTask, Invocable.Task

Nested classes/interfaces inherited from interface org.eclipse.jetty.server.Request.Handler

Request.Handler.AbortException

Field Summary

Fields

Modifier and Type	Field	Description
static final String	GLOBAL_ERROR_PAGE

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

ERROR_CACHE_CONTROL, ERROR_CONTEXT, ERROR_EXCEPTION, ERROR_MESSAGE, ERROR_METHODS, ERROR_ORIGIN, ERROR_STATUS

Fields inherited from interface org.eclipse.jetty.util.thread.Invocable

__nonBlocking, NOOP

Constructor Summary

Constructors

Constructor	Description
ErrorPageErrorHandler()

Method Summary

Modifier and Type	Method	Description
void	addErrorPage(int from, int to, String uri)	Adds ErrorPage mapping for a status code range.
void	addErrorPage(int code, String uri)	Adds ErrorPage mapping for a status code.
void	addErrorPage(Class<? extends Throwable> exception, String uri)	Adds ErrorPage mapping for an exception class.
void	addErrorPage(String exceptionClassName, String uri)	Adds ErrorPage mapping for an exception class.
ErrorHandler.ErrorPageMapper.ErrorPage	getErrorPage(Integer errorStatusCode, Throwable error)
Map<String,String>	getErrorPages()
boolean	isUnwrapServletException()
void	prepare(ErrorHandler.ErrorPageMapper.ErrorPage errorPage, jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response)
void	setErrorPages(Map<String,String> errorPages)	Set a map of Exception class names or error codes as a string to URI string.
void	setUnwrapServletException(boolean unwrapServletException)

Methods inherited from class org.eclipse.jetty.ee11.servlet.ErrorHandler

generateAcceptableResponse, getErrorHandler, handle, writeError, writeErrorHtmlMessage

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

badMessageError, computeBufferSize, errorPageForMethod, generateCacheControl, generateResponse, getBufferSize, getCacheControl, getDefaultResponseMimeType, htmlRow, isShowCauses, isShowMessageInTitle, isShowOrigin, isShowStacks, setBufferSize, setCacheControl, setDefaultResponseMimeType, setShowCauses, setShowMessageInTitle, setShowOrigin, setShowStacks, toString, write, writeErrorHtml, writeErrorHtmlBody, writeErrorHtmlHead, writeErrorHtmlMeta, writeErrorHtmlStacks, writeErrorJson, writeErrorOrigin, writeErrorPlain

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.server.Request.Handler

getInvocationType

Field Details

GLOBAL_ERROR_PAGE

public static final String GLOBAL_ERROR_PAGE

See Also:

• Constant Field Values

Constructor Details

ErrorPageErrorHandler

public ErrorPageErrorHandler()

Method Details

isUnwrapServletException

public boolean isUnwrapServletException()

Returns:

True if ServletException is unwrapped for RequestDispatcher.ERROR_EXCEPTION

setUnwrapServletException

public void setUnwrapServletException(boolean unwrapServletException)

Parameters:

unwrapServletException - True if ServletException should be unwrapped for RequestDispatcher.ERROR_EXCEPTION

prepare

public void prepare(ErrorHandler.ErrorPageMapper.ErrorPage errorPage,
 jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response)

Specified by:

prepare in interface ErrorHandler.ErrorPageMapper

getErrorPage

public ErrorHandler.ErrorPageMapper.ErrorPage getErrorPage(Integer errorStatusCode,
 Throwable error)

Specified by:

getErrorPage in interface ErrorHandler.ErrorPageMapper

getErrorPages

public Map<String,String> getErrorPages()

setErrorPages

public void setErrorPages(Map<String,String> errorPages)

Set a map of Exception class names or error codes as a string to URI string.

Parameters:

errorPages - a map of Exception class names or error codes as a string to URI string

addErrorPage

public void addErrorPage(Class<? extends Throwable> exception,
 String uri)

Adds ErrorPage 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)

Adds ErrorPage 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)

Adds ErrorPage 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)

Adds ErrorPage 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.