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.


Copyright © 2007-2011 The Apache Software Foundation. All Rights Reserved.