com.google.api.client.http

Class HttpBackOffUnsuccessfulResponseHandler

java.lang.Object

com.google.api.client.http.HttpBackOffUnsuccessfulResponseHandler

All Implemented Interfaces:

HttpUnsuccessfulResponseHandler

@Beta
public class HttpBackOffUnsuccessfulResponseHandler
extends Object
implements HttpUnsuccessfulResponseHandler

Beta
Back-off handler which handles an abnormal HTTP response with BackOff.

It is designed to work with only one HttpRequest at a time. As a result you MUST create a new instance of HttpBackOffUnsuccessfulResponseHandler with a new instance of BackOff for each instance of HttpRequest.

Sample usage:

 request.setUnsuccessfulResponseHandler(
 new HttpBackOffUnsuccessfulResponseHandler(new ExponentialBackOff()));
 

Note: Implementation doesn't call BackOff.reset() at all, since it expects a new BackOff instance.

Implementation is not thread-safe

Since:

1.15

Author:

Eyal Peled

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	HttpBackOffUnsuccessfulResponseHandler.BackOffRequired Beta Interface which defines if back-off is required based on an abnormal HttpResponse.

Constructor Summary

Constructors

Constructor and Description
HttpBackOffUnsuccessfulResponseHandler(BackOff backOff) Constructs a new instance from a BackOff.

Method Summary

Modifier and Type	Method and Description
BackOff	getBackOff() Returns the back-off.
HttpBackOffUnsuccessfulResponseHandler.BackOffRequired	getBackOffRequired() Returns the HttpBackOffUnsuccessfulResponseHandler.BackOffRequired instance which determines if back-off is required based on an abnormal HTTP response.
Sleeper	getSleeper() Returns the sleeper.
boolean	handleResponse(HttpRequest request, HttpResponse response, boolean supportsRetry) Handler that will be invoked when an abnormal response is received.
HttpBackOffUnsuccessfulResponseHandler	setBackOffRequired(HttpBackOffUnsuccessfulResponseHandler.BackOffRequired backOffRequired) Sets the HttpBackOffUnsuccessfulResponseHandler.BackOffRequired instance which determines if back-off is required based on an abnormal HTTP response.
HttpBackOffUnsuccessfulResponseHandler	setSleeper(Sleeper sleeper) Sets the sleeper.

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpBackOffUnsuccessfulResponseHandler

public HttpBackOffUnsuccessfulResponseHandler(BackOff backOff)

Constructs a new instance from a BackOff.

Parameters:

backOff - back-off policy

Method Detail

getBackOff

public final BackOff getBackOff()

Returns the back-off.

getBackOffRequired

public final HttpBackOffUnsuccessfulResponseHandler.BackOffRequired getBackOffRequired()

Returns the HttpBackOffUnsuccessfulResponseHandler.BackOffRequired instance which determines if back-off is required based on an abnormal HTTP response.

setBackOffRequired

public HttpBackOffUnsuccessfulResponseHandler setBackOffRequired(HttpBackOffUnsuccessfulResponseHandler.BackOffRequired backOffRequired)

Sets the HttpBackOffUnsuccessfulResponseHandler.BackOffRequired instance which determines if back-off is required based on an abnormal HTTP response.

The default value is HttpBackOffUnsuccessfulResponseHandler.BackOffRequired.ON_SERVER_ERROR.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

getSleeper

public final Sleeper getSleeper()

Returns the sleeper.

setSleeper

public HttpBackOffUnsuccessfulResponseHandler setSleeper(Sleeper sleeper)

Sets the sleeper.

The default value is Sleeper.DEFAULT.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

handleResponse

public boolean handleResponse(HttpRequest request,
                              HttpResponse response,
                              boolean supportsRetry)
                       throws IOException

Handler that will be invoked when an abnormal response is received. There are a few simple rules that one must follow:

• If you modify the request object or modify its execute interceptors in a way that should resolve the error, you must return true to issue a retry.
• Do not read from the content stream, this will prevent the eventual end user from having access to it.

Handles the request with BackOff. That means that if back-off is required a call to Sleeper.sleep(long) will be made.

Specified by:

handleResponse in interface HttpUnsuccessfulResponseHandler

Parameters:

request - Request object that can be read from for context or modified before retry

response - Response to process

supportsRetry - Whether there will actually be a retry if this handler return true. Some handlers may want to have an effect only when there will actually be a retry after they handle their event (e.g. a handler that implements exponential backoff).

Returns:

Whether or not this handler has made a change that will require the request to be re-sent.

Throws:

IOException