org.apache.sling.engine.servlets
Interface ErrorHandler

public interface ErrorHandler

The ErrorHandler defines the interface of the service used by the Sling to handle calls to HttpServletResponse.sendError and to handle uncaught Throwables.

Method Summary

void	handleError(int status, String message, SlingHttpServletRequest request, SlingHttpServletResponse response) Called to render a response for a HTTP status code.
void	handleError(Throwable throwable, SlingHttpServletRequest request, SlingHttpServletResponse response) Called to render a response for an uncaught Throwable.

Method Detail

handleError

void handleError(int status,
                 String message,
                 SlingHttpServletRequest request,
                 SlingHttpServletResponse response)
                 throws IOException

Called to render a response for a HTTP status code. This method should set the response status and print the status code and optional message.

If the response has already been committed, an error message should be logged but no further processing should take place.

Parameters:

status - The HTTP status code to set

message - An optional message to write to the response. This message may be null.

request - The request object providing more information on the request.

response - The response object used to send the status and message.

Throws:

IOException - May be thrown if an error occurrs sending the response.

handleError

void handleError(Throwable throwable,
                 SlingHttpServletRequest request,
                 SlingHttpServletResponse response)
                 throws IOException

Called to render a response for an uncaught Throwable.

If the response has already been committed, an error message should be logged but no further processing should take place.

Parameters:

throwable - The Throwable causing this method to be called.

request - The request object providing more information on the request.

response - The response object used to send the status and message.

Throws:

IOException - May be thrown if an error occurrs sending the response.