A result retry algorithm is responsible for the following operations (based on the response
returned by the previous attempt or on the thrown exception):
Accepting a task for retry so another attempt will be made.
Canceling retrying process so the related java.util.concurrent.Future will be
canceled.
Implementations of this interface receive a RetryingContext that can contain specific
RetrySettings and retryable codes that should be used to determine the retry behavior.
Implementations of this interface must be thread-safe.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eResultRetryAlgorithmWithContext\u003c/code\u003e interface is used to manage retry operations, including accepting tasks for retry, canceling the retry process, and creating \u003ccode\u003eTimedAttemptSettings\u003c/code\u003e for subsequent attempts.\u003c/p\u003e\n"],["\u003cp\u003eImplementations of this interface must be thread-safe and utilize a \u003ccode\u003eRetryingContext\u003c/code\u003e containing \u003ccode\u003eRetrySettings\u003c/code\u003e and retryable codes to determine retry behavior.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ecreateNextAttempt\u003c/code\u003e method creates \u003ccode\u003eTimedAttemptSettings\u003c/code\u003e for the next retry attempt based on the \u003ccode\u003eRetryingContext\u003c/code\u003e, previous \u003ccode\u003eThrowable\u003c/code\u003e, \u003ccode\u003eResponseT\u003c/code\u003e, and \u003ccode\u003eTimedAttemptSettings\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eshouldRetry\u003c/code\u003e method determines if another attempt should be made, based on the \u003ccode\u003eRetryingContext\u003c/code\u003e, previous \u003ccode\u003eThrowable\u003c/code\u003e, and \u003ccode\u003eResponseT\u003c/code\u003e, potentially throwing a \u003ccode\u003eCancellationException\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe latest version for the ResultRetryAlgorithmWithContext is 2.63.1 and is the version which is detailed in the documentation.\u003c/p\u003e\n"]]],[],null,["# Interface ResultRetryAlgorithmWithContext<ResponseT> (2.69.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.69.0 (latest)](/java/docs/reference/gax/latest/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.68.2](/java/docs/reference/gax/2.68.2/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.67.0](/java/docs/reference/gax/2.67.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.66.0](/java/docs/reference/gax/2.66.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.65.0](/java/docs/reference/gax/2.65.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.63.1](/java/docs/reference/gax/2.63.1/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.62.0](/java/docs/reference/gax/2.62.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.61.0](/java/docs/reference/gax/2.61.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.60.0](/java/docs/reference/gax/2.60.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.59.1](/java/docs/reference/gax/2.59.1/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.58.0](/java/docs/reference/gax/2.58.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.57.0](/java/docs/reference/gax/2.57.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.55.0](/java/docs/reference/gax/2.55.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.54.1](/java/docs/reference/gax/2.54.1/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.53.0](/java/docs/reference/gax/2.53.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.52.0](/java/docs/reference/gax/2.52.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.51.0](/java/docs/reference/gax/2.51.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.50.0](/java/docs/reference/gax/2.50.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.49.0](/java/docs/reference/gax/2.49.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.48.1](/java/docs/reference/gax/2.48.1/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.47.0](/java/docs/reference/gax/2.47.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.46.1](/java/docs/reference/gax/2.46.1/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.45.0](/java/docs/reference/gax/2.45.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.43.0](/java/docs/reference/gax/2.43.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.42.0](/java/docs/reference/gax/2.42.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.41.0](/java/docs/reference/gax/2.41.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.39.0](/java/docs/reference/gax/2.39.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.38.0](/java/docs/reference/gax/2.38.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.37.0](/java/docs/reference/gax/2.37.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.36.0](/java/docs/reference/gax/2.36.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.35.0](/java/docs/reference/gax/2.35.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.34.1](/java/docs/reference/gax/2.34.1/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.33.0](/java/docs/reference/gax/2.33.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.32.1](/java/docs/reference/gax/2.32.1/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.31.1](/java/docs/reference/gax/2.31.1/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.30.1](/java/docs/reference/gax/2.30.1/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.24.0](/java/docs/reference/gax/2.24.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.23.3](/java/docs/reference/gax/2.23.3/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.22.0](/java/docs/reference/gax/2.22.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.21.0](/java/docs/reference/gax/2.21.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.20.1](/java/docs/reference/gax/2.20.1/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.19.6](/java/docs/reference/gax/2.19.6/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.18.7](/java/docs/reference/gax/2.18.7/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.17.0](/java/docs/reference/gax/2.17.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.16.0](/java/docs/reference/gax/2.16.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.15.0](/java/docs/reference/gax/2.15.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.14.0](/java/docs/reference/gax/2.14.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.13.0](/java/docs/reference/gax/2.13.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.12.2](/java/docs/reference/gax/2.12.2/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.11.0](/java/docs/reference/gax/2.11.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.10.0](/java/docs/reference/gax/2.10.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.9.0](/java/docs/reference/gax/2.9.0/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.8.1](/java/docs/reference/gax/2.8.1/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext)\n- [2.7.1](/java/docs/reference/gax/2.7.1/com.google.api.gax.retrying.ResultRetryAlgorithmWithContext) \n\n public interface ResultRetryAlgorithmWithContext\u003cResponseT\u003e extends ResultRetryAlgorithm\u003cResponseT\u003e\n\nA result retry algorithm is responsible for the following operations (based on the response\nreturned by the previous attempt or on the thrown exception):\n\n1. Accepting a task for retry so another attempt will be made.\n2. Canceling retrying process so the related java.util.concurrent.Future will be canceled.\n3. Creating [TimedAttemptSettings](/java/docs/reference/gax/latest/com.google.api.gax.retrying.TimedAttemptSettings) for each subsequent retry attempt.\n\nImplementations of this interface receive a [RetryingContext](/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetryingContext) that can contain specific\n[RetrySettings](/java/docs/reference/gax/latest/com.google.api.gax.retrying.RetrySettings) and retryable codes that should be used to determine the retry behavior.\n\nImplementations of this interface must be thread-safe. \n\nImplements\n----------\n\ncom.google.api.gax.retrying.ResultRetryAlgorithm\\\u003cResponseT\\\u003e\n\nMethods\n-------\n\n### createNextAttempt(RetryingContext context, Throwable previousThrowable, ResponseT previousResponse, TimedAttemptSettings previousSettings)\n\n public abstract TimedAttemptSettings createNextAttempt(RetryingContext context, Throwable previousThrowable, ResponseT previousResponse, TimedAttemptSettings previousSettings)\n\nCreates a next attempt [TimedAttemptSettings](/java/docs/reference/gax/latest/com.google.api.gax.retrying.TimedAttemptSettings).\n\n### shouldRetry(RetryingContext context, Throwable previousThrowable, ResponseT previousResponse)\n\n public abstract boolean shouldRetry(RetryingContext context, Throwable previousThrowable, ResponseT previousResponse)\n\nReturns `true` if another attempt should be made, or `false` otherwise."]]
