org.apache.juneau.rest.client

Class RestCallInterceptor

java.lang.Object

org.apache.juneau.rest.client.RestCallInterceptor

Direct Known Subclasses:

RestCallLogger

public abstract class RestCallInterceptor
extends Object

Used to intercept http connection responses to allow modification of that response before processing and for listening for call lifecycle events.

Useful if you want to prevent RestCallExceptions from being thrown on error conditions.

Constructor Summary

Constructors

Constructor and Description
RestCallInterceptor()

Method Summary

Modifier and Type	Method and Description
void	onClose(RestCall restCall) Called when RestCall.close() is called.
void	onConnect(RestCall restCall, int statusCode, org.apache.http.HttpRequest req, org.apache.http.HttpResponse res) Called immediately after an HTTP response has been received.
void	onInit(RestCall restCall) Called when RestCall object is created.
void	onRetry(RestCall restCall, int statusCode, org.apache.http.HttpRequest req, org.apache.http.HttpResponse res, Exception ex) Called if retry is going to be attempted.

Methods inherited from class java.lang.Object

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

Constructor Detail

RestCallInterceptor

public RestCallInterceptor()

Method Detail

onInit

public void onInit(RestCall restCall)

Called when RestCall object is created.

Parameters:

restCall - The restCall object invoking this method.

onConnect

public void onConnect(RestCall restCall,
                      int statusCode,
                      org.apache.http.HttpRequest req,
                      org.apache.http.HttpResponse res)

Called immediately after an HTTP response has been received.

Parameters:

statusCode - The HTTP status code received.

restCall - The restCall object invoking this method.

req - The HTTP request object.

res - The HTTP response object.

onRetry

public void onRetry(RestCall restCall,
                    int statusCode,
                    org.apache.http.HttpRequest req,
                    org.apache.http.HttpResponse res,
                    Exception ex)

Called if retry is going to be attempted.

Parameters:

statusCode - The HTTP status code received.

restCall - The restCall object invoking this method.

req - The HTTP request object.

res - The HTTP response object.

ex - The exception thrown from the client.

onClose

public void onClose(RestCall restCall)
             throws RestCallException

Called when RestCall.close() is called.

Parameters:

restCall - The restCall object invoking this method.

Throws:

RestCallException - Error occurred during call.