# Interface RetryingFuture&lt;ResponseT&gt; (2.81.0)

2.81.0 (latest) 2.80.0 2.79.0 2.76.0 2.75.0 2.74.1 2.73.1 2.72.2 2.71.0 2.70.3 2.69.0 2.68.2 2.67.0 2.66.0 2.65.0 2.63.1 2.62.0 2.61.0 2.60.0 2.59.1 2.58.0 2.57.0 2.55.0 2.54.1 2.53.0 2.52.0 2.51.0 2.50.0 2.49.0 2.48.1 2.47.0 2.46.1 2.45.0 2.43.0 2.42.0 2.41.0 2.39.0 2.38.0 2.37.0 2.36.0 2.35.0 2.34.1 2.33.0 2.32.1 2.31.1 2.30.1 2.24.0 2.23.3 2.22.0 2.21.0 2.20.1 2.19.6 2.18.7 2.17.0 2.16.0 2.15.0 2.14.0 2.13.0 2.12.2 2.11.0 2.10.0 2.9.0 2.8.1 2.7.1

    public interface RetryingFuture<ResponseT> extends ApiFuture<ResponseT>

Represents a retrying future. This is a facade hiding all the complications of an
asynchronous/synchronous execution of a retriable task.

This interface is for advanced/internal use only.

## Implements

[ApiFuture](https://docs.cloud.google.com/java/docs/reference/api-common/latest/com.google.api.core.ApiFuture.html)\<ResponseT\>

| ## Type Parameter ||
|---|---|
| **Name** | **Description** |
| `ResponseT` |   |

## Methods

### getAttemptResult()

    public abstract ApiFuture<ResponseT> getAttemptResult()

Returns the current (active on the moment of the execution of this method) attempt result
future, allowing to track progress of the retrying future execution.

Adding direct executor (same thread) callbacks to the future returned by this method is
strongly not recommended, since the future is resolved under retrying future's internal lock
and may affect the whole retrying process. Adding separate thread callbacks is ok.

This method is for internal/advanced use only.

The returned future completes right after the corresponding attempt which it tracks, so
calling ApiFuture#get() is potentially a blocking operation. This method returns
exactly same future object until it completes (meaning that the corresponding attempt has
completed). If there is another attempt made after completion of the current attempt, the
subsequent call to this method will return a new future which will track the new attempt.

In case if the whole retrying future is completed, this method returns the same result as
the retrying future itself.

The returned future is non-cancellable, so calling ApiFuture#cancel(boolean) will
have no effect and will always return `false`.

The number of attempt results may be (and usually is) lower than the number of actual
attempts, since only a completed attempt has a result and not all attempts complete (some of
the service attempts, needed for proper execution of the actual attempts).

For each execution the following invariants hold:

- The future returned by this method completes soon after the attempt it tracks.
- If it was the last attempt, the futures complete in the following order: 1) the attempt future; 2) the whole retrying future; 3) the attempt result future returned by this method.
- After completion of the whole retrying future this method always returns exactly same future object.

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/api-common/latest/com.google.api.core.ApiFuture.html<ResponseT>` |   |

### getAttemptSettings()

    public abstract TimedAttemptSettings getAttemptSettings()

Returns current (active) attempt settings.

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/gax/latest/com.google.api.gax.retrying.TimedAttemptSettings` |   |

### getCallable()

    public abstract Callable<ResponseT> getCallable()

Returns callable tracked by this future.

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/Callable.html<ResponseT>` |   |

### peekAttemptResult()

    public abstract ApiFuture<ResponseT> peekAttemptResult()

Returns latest completed attempt result or `null` if the first attempt hasn't completed
yet.

This method is for internal/advanced use only.

If not null, the returned value is guaranteed to be an already completed future, so ApiFuture#isDone() will always be `true` and ApiFuture#get() will always be
non-blocking.

In case if the whole retrying future is completed, this method returns the same result as
the retrying future itself.

The number of attempt results may be (and usually is) lower than the number of actual
attempts, since only a completed attempt has a result and not all attempts complete (some of
the service attempts, needed for proper execution of the actual attempts).

For each execution the following invariants hold:

- If the first attempt hasn't completed yet, this method returns `null`.
- Right after completion of each attempt this method starts returning a new already completed future, which represents the result of the latest completed attempt.
- If it was the last attempt, the events happen in the following order: 1) the attempt future completes; 2) the whole retrying future completes; 3) this method starts returning a new already completed future, which represents the result of the last completed attempt.
- After completion of the whole retrying future this method always returns exactly same future object.

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/api-common/latest/com.google.api.core.ApiFuture.html<ResponseT>` |   |

### setAttemptFuture(ApiFuture\<ResponseT\> attemptFuture)

    public abstract void setAttemptFuture(ApiFuture<ResponseT> attemptFuture)

Sets the attempt in a form of a future. This future represents a concrete retry attempt,
potentially scheduled for execution in a some form of [java.util.concurrent.ScheduledExecutorService](https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ScheduledExecutorService.html), or an already completed future if the attempts
are executed synchronously.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `attemptFuture` | `https://docs.cloud.google.com/java/docs/reference/api-common/latest/com.google.api.core.ApiFuture.html<ResponseT>` the attempt future |