public class ExceptionFilter extends GenericFilter
LogLevel.WARNINGand the exchange is diverted to the specified exception handler.
Note: While the response object will be retained in the exchange object, this class will close any open entity within the response object prior to dispatching the exchange to the exception handler.
|Modifier and Type||Class and Description|
Creates and initializes an exception filter in a heap environment.
|Constructor and Description|
Build a new exception filter that will divert the flow to the given handler in case of exception.
public void filter(Exchange exchange, Handler next) throws HandlerException, IOException
exchange.requestcontains the request to be filtered. To pass the request to the next filter or handler in the chain, the filter calls
next.handle(exchange). After this call,
exchange.responsecontains the response that can be filtered.
This method may elect not to pass the request to the next filter or handler, and instead
handle the request itself. It can achieve this by merely avoiding a call to
next.handle(exchange) and creating its own response object the exchange. The
filter is also at liberty to replace a response with another of its own after the call
Important note: If an existing response exists in the exchange object
and the filter intends to replace it with its own, it must first check to see if the
existing response has an entity, and if it does, must call its
close method in
order to signal that the processing of the response from a remote server is complete.
Copyright © 2014 ForgeRock AS. All rights reserved.