Class BackOffHandler (1.55.0)

public class BackOffHandler : IHttpUnsuccessfulResponseHandler, IHttpExceptionHandler

A thread-safe back-off handler which handles an abnormal HTTP response or an exception with IBackOff.

Inheritance

Object > BackOffHandler

Implements

IHttpUnsuccessfulResponseHandler, IHttpExceptionHandler

Inherited Members

Object.Equals(Object)

Object.Equals(Object, Object)

Object.GetHashCode()

Object.GetType()

Object.MemberwiseClone()

Object.ReferenceEquals(Object, Object)

Object.ToString()

Namespace

Google.Apis.Http

Assembly

Google.Apis.Core.dll

Constructors

BackOffHandler(BackOffHandler.Initializer)

public BackOffHandler(BackOffHandler.Initializer initializer)

Constructs a new back-off handler with the given initializer.

Parameter
Name	Description
`initializer`	`BackOffHandler.Initializer`

BackOffHandler(IBackOff)

public BackOffHandler(IBackOff backOff)

Constructs a new back-off handler with the given back-off.

Parameter
Name	Description
`backOff`	`IBackOff` The back-off policy.

Properties

BackOff

public IBackOff BackOff { get; }

Gets the back-off policy used by this back-off handler.

Property Value
Type	Description
`IBackOff`

HandleExceptionFunc

public Func<Exception, bool> HandleExceptionFunc { get; }

Gets a delegate function which indicates whether this back-off handler should handle an exception. The default is DefaultHandleExceptionFunc.

Property Value
Type	Description
`Func<Exception, Boolean>`

HandleUnsuccessfulResponseFunc

public Func<HttpResponseMessage, bool> HandleUnsuccessfulResponseFunc { get; }

Gets a delegate function which indicates whether this back-off handler should handle an abnormal HTTP response. The default is DefaultHandleUnsuccessfulResponseFunc.

Property Value
Type	Description
`Func<HttpResponseMessage, Boolean>`

MaxTimeSpan

public TimeSpan MaxTimeSpan { get; }

Gets the maximum time span to wait. If the back-off instance returns a greater time span, the handle method returns false. Default value is 16 seconds per a retry request.

Property Value
Type	Description
`TimeSpan`

Methods

HandleExceptionAsync(HandleExceptionArgs)

public virtual Task<bool> HandleExceptionAsync(HandleExceptionArgs args)

Handles an exception thrown when sending a HTTP request. A simple rule must be followed, if you modify the request object in a way that the exception can be resolved, you must return true.

Parameter
Name	Description
`args`	`HandleExceptionArgs` Handle exception argument which properties such as the request, exception, current failed try.

Returns
Type	Description
`Task<Boolean>`	Whether this handler has made a change that requires the request to be resent.

HandleResponseAsync(HandleUnsuccessfulResponseArgs)

public virtual Task<bool> HandleResponseAsync(HandleUnsuccessfulResponseArgs args)

Handles an abnormal response when sending a HTTP request. A simple rule must be followed, if you modify the request object in a way that the abnormal response can be resolved, you must return true.

Parameter
Name	Description
`args`	`HandleUnsuccessfulResponseArgs` Handle response argument which contains properties such as the request, response, current failed try.

Returns
Type	Description
`Task<Boolean>`	Whether this handler has made a change that requires the request to be resent.

Wait(TimeSpan, CancellationToken)

protected virtual Task Wait(TimeSpan ts, CancellationToken cancellationToken)

Waits the given time span. Overriding this method is recommended for mocking purposes.

Parameters
Name	Description
`ts`	`TimeSpan` TimeSpan to wait (and block the current thread).
`cancellationToken`	`CancellationToken` The cancellation token in case the user wants to cancel the operation in the middle.

Returns
Type	Description
`Task`

Extension Method

Utilities.ThrowIfNull<T>(T, String)