Module org.eclipse.jetty.ee10.servlet

Package org.eclipse.jetty.ee10.servlet

Class ErrorHandler

java.lang.Object

org.eclipse.jetty.ee10.servlet.ErrorHandler

All Implemented Interfaces:

org.eclipse.jetty.server.Request.Handler, org.eclipse.jetty.util.thread.Invocable

Direct Known Subclasses:

ErrorPageErrorHandler

public class ErrorHandler
extends Object
implements org.eclipse.jetty.server.Request.Handler

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	ErrorHandler.ErrorPageMapper

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

org.eclipse.jetty.util.thread.Invocable.Callable, org.eclipse.jetty.util.thread.Invocable.InvocationType, org.eclipse.jetty.util.thread.Invocable.ReadyTask, org.eclipse.jetty.util.thread.Invocable.Task

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

org.eclipse.jetty.server.Request.Handler.AbortException

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ERROR_CHARSET
static final String	ERROR_CONTEXT
static final String	ERROR_PAGE

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

__nonBlocking, NOOP

Constructor Summary

Constructors

Constructor	Description
ErrorHandler()

Method Summary

Modifier and Type	Method	Description
ByteBuffer	badMessageError(int status, String reason, org.eclipse.jetty.http.HttpFields.Mutable fields)	Bad Message Error body
boolean	errorPageForMethod(String method)
protected void	generateAcceptableResponse(ServletContextRequest baseRequest, jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, int code, String message)	Generate an acceptable error response.
protected void	generateAcceptableResponse(ServletContextRequest baseRequest, jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, int code, String message, String contentType)	Generate an acceptable error response for a mime type.
protected Writer	getAcceptableWriter(org.eclipse.jetty.server.Request baseRequest, jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response)	Deprecated.
String	getCacheControl()	Get the cacheControl.
static org.eclipse.jetty.server.Request.Handler	getErrorHandler(org.eclipse.jetty.server.Server server, org.eclipse.jetty.server.handler.ContextHandler context)
boolean	getShowMessageInTitle()
boolean	handle(org.eclipse.jetty.server.Request request, org.eclipse.jetty.server.Response response, org.eclipse.jetty.util.Callback callback)
protected void	handleErrorPage(jakarta.servlet.http.HttpServletRequest request, Writer writer, int code, String message)
boolean	isShowServlet()
boolean	isShowStacks()
void	setCacheControl(String cacheControl)	Set the cacheControl.
void	setShowMessageInTitle(boolean showMessageInTitle)	Set if true, the error message appears in page title.
void	setShowServlet(boolean showServlet)
void	setShowStacks(boolean showStacks)
protected void	write(Writer writer, String string)
protected void	writeErrorJson(jakarta.servlet.http.HttpServletRequest request, PrintWriter writer, int code, String message)
protected void	writeErrorPage(jakarta.servlet.http.HttpServletRequest request, Writer writer, int code, String message, boolean showStacks)
protected void	writeErrorPageBody(jakarta.servlet.http.HttpServletRequest request, Writer writer, int code, String message, boolean showStacks)
protected void	writeErrorPageHead(jakarta.servlet.http.HttpServletRequest request, Writer writer, int code, String message)
protected void	writeErrorPageMessage(jakarta.servlet.http.HttpServletRequest request, Writer writer, int code, String message, String uri)
protected void	writeErrorPageStacks(jakarta.servlet.http.HttpServletRequest request, Writer writer)
protected void	writeErrorPlain(jakarta.servlet.http.HttpServletRequest request, PrintWriter writer, int code, String message)

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.server.Request.Handler

getInvocationType

Field Details

ERROR_PAGE

public static final String ERROR_PAGE

See Also:

• Constant Field Values

ERROR_CONTEXT

public static final String ERROR_CONTEXT

See Also:

• Constant Field Values

ERROR_CHARSET

public static final String ERROR_CHARSET

See Also:

• Constant Field Values

Constructor Details

ErrorHandler

public ErrorHandler()

Method Details

errorPageForMethod

public boolean errorPageForMethod(String method)

handle

public boolean handle(org.eclipse.jetty.server.Request request,
 org.eclipse.jetty.server.Response response,
 org.eclipse.jetty.util.Callback callback)
               throws Exception

Specified by:

handle in interface org.eclipse.jetty.server.Request.Handler

Throws:

Exception

generateAcceptableResponse

protected void generateAcceptableResponse(ServletContextRequest baseRequest,
 jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 int code,
 String message)
                                   throws IOException

Generate an acceptable error response.

This method is called to generate an Error page of a mime type that is acceptable to the user-agent. The Accept header is evaluated in quality order and the method generateAcceptableResponse(ServletContextRequest, HttpServletRequest, HttpServletResponse, int, String, String) is called for each mimetype until the response is written to or committed.

Parameters:

baseRequest - The base request

request - The servlet request (may be wrapped)

response - The response (may be wrapped)

code - the http error code

message - the http error message

Throws:

IOException - if the response cannot be generated

getAcceptableWriter

@Deprecated
protected Writer getAcceptableWriter(org.eclipse.jetty.server.Request baseRequest,
 jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response)
                              throws IOException

Deprecated.

Returns an acceptable writer for an error page.

Uses the user-agent's Accept-Charset to get response Writer. The acceptable charsets are tested in quality order if they are known to the JVM and the first known is set on ServletResponse.setCharacterEncoding(String) and the ServletResponse.getWriter() method used to return a writer. If there is no Accept-Charset header then ISO-8859-1 is used. If '*' is the highest quality known charset, then utf-8 is used.

Parameters:

baseRequest - The base request

request - The servlet request (may be wrapped)

response - The response (may be wrapped)

Returns:

A Writer if there is a known acceptable charset or null

Throws:

IOException - if a Writer cannot be returned

generateAcceptableResponse

protected void generateAcceptableResponse(ServletContextRequest baseRequest,
 jakarta.servlet.http.HttpServletRequest request,
 jakarta.servlet.http.HttpServletResponse response,
 int code,
 String message,
 String contentType)
                                   throws IOException

Generate an acceptable error response for a mime type.

This method is called for each mime type in the users agent's Accept header, a response of the appropriate type is generated.

The default implementation handles "text/html", "text/*" and "*/*". The method can be overridden to handle other types. Implementations must immediate produce a response and may not be async.

Parameters:

baseRequest - The base request

request - The servlet request (may be wrapped)

response - The response (may be wrapped)

code - the http error code

message - the http error message

contentType - The mimetype to generate (may be */*or other wildcard)

Throws:

IOException - if a response cannot be generated

handleErrorPage

protected void handleErrorPage(jakarta.servlet.http.HttpServletRequest request,
 Writer writer,
 int code,
 String message)
                        throws IOException

Throws:

IOException

writeErrorPage

protected void writeErrorPage(jakarta.servlet.http.HttpServletRequest request,
 Writer writer,
 int code,
 String message,
 boolean showStacks)
                       throws IOException

Throws:

IOException

writeErrorPageHead

protected void writeErrorPageHead(jakarta.servlet.http.HttpServletRequest request,
 Writer writer,
 int code,
 String message)
                           throws IOException

Throws:

IOException

writeErrorPageBody

protected void writeErrorPageBody(jakarta.servlet.http.HttpServletRequest request,
 Writer writer,
 int code,
 String message,
 boolean showStacks)
                           throws IOException

Throws:

IOException

writeErrorPageMessage

protected void writeErrorPageMessage(jakarta.servlet.http.HttpServletRequest request,
 Writer writer,
 int code,
 String message,
 String uri)
                              throws IOException

Throws:

IOException

writeErrorPlain

protected void writeErrorPlain(jakarta.servlet.http.HttpServletRequest request,
 PrintWriter writer,
 int code,
 String message)

writeErrorJson

protected void writeErrorJson(jakarta.servlet.http.HttpServletRequest request,
 PrintWriter writer,
 int code,
 String message)

writeErrorPageStacks

protected void writeErrorPageStacks(jakarta.servlet.http.HttpServletRequest request,
 Writer writer)
                             throws IOException

Throws:

IOException

badMessageError

public ByteBuffer badMessageError(int status,
 String reason,
 org.eclipse.jetty.http.HttpFields.Mutable fields)

Bad Message Error body

Generate an error response body to be sent for a bad message. In this case there is something wrong with the request, so either a request cannot be built, or it is not safe to build a request. This method allows for a simple error page body to be returned and some response headers to be set.

Parameters:

status - The error code that will be sent

reason - The reason for the error code (may be null)

fields - The header fields that will be sent with the response.

Returns:

The content as a ByteBuffer, or null for no body.

getCacheControl

public String getCacheControl()

Get the cacheControl.

Returns:

the cacheControl header to set on error responses.

setCacheControl

public void setCacheControl(String cacheControl)

Set the cacheControl.

Parameters:

cacheControl - the cacheControl header to set on error responses.

isShowServlet

public boolean isShowServlet()

Returns:

True if the error page will show the Servlet that generated the error

setShowServlet

public void setShowServlet(boolean showServlet)

Parameters:

showServlet - True if the error page will show the Servlet that generated the error

isShowStacks

public boolean isShowStacks()

Returns:

True if stack traces are shown in the error pages

setShowStacks

public void setShowStacks(boolean showStacks)

Parameters:

showStacks - True if stack traces are shown in the error pages

setShowMessageInTitle

public void setShowMessageInTitle(boolean showMessageInTitle)

Set if true, the error message appears in page title.

Parameters:

showMessageInTitle - if true, the error message appears in page title

getShowMessageInTitle

public boolean getShowMessageInTitle()

write

protected void write(Writer writer,
 String string)
              throws IOException

Throws:

IOException

getErrorHandler

public static org.eclipse.jetty.server.Request.Handler getErrorHandler(org.eclipse.jetty.server.Server server,
 org.eclipse.jetty.server.handler.ContextHandler context)