Creates a next attempt TimedAttemptSettings. The implementation increments the current
attempt count and uses randomized exponential backoff factor for calculating next attempt
execution time.
Creates a next attempt TimedAttemptSettings. The implementation increments the current
attempt count and uses randomized exponential backoff factor for calculating next attempt
execution time.
[[["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 latest version available for the ExponentialRetryAlgorithm is 2.63.1, with several other previous versions also being accessible.\u003c/p\u003e\n"],["\u003cp\u003eThe ExponentialRetryAlgorithm class implements the TimedRetryAlgorithmWithContext interface and provides a thread-safe way to manage retries with jittered exponential backoff.\u003c/p\u003e\n"],["\u003cp\u003eThis class allows the creation of a first attempt with \u003ccode\u003ecreateFirstAttempt()\u003c/code\u003e that executes immediately, and next attempts with \u003ccode\u003ecreateNextAttempt()\u003c/code\u003e using an incrementing attempt count and randomized exponential backoff.\u003c/p\u003e\n"],["\u003cp\u003eThe algorithm's retry behavior, decided by the methods \u003ccode\u003eshouldRetry()\u003c/code\u003e, checks if the next attempt exceeds either the maximum attempts limit or the total timeout limit.\u003c/p\u003e\n"],["\u003cp\u003eConstructors allow the setting of \u003ccode\u003eRetrySettings\u003c/code\u003e and an \u003ccode\u003eApiClock\u003c/code\u003e for managing time specific calculations.\u003c/p\u003e\n"]]],[],null,["# Class ExponentialRetryAlgorithm (2.69.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.69.0 (latest)](/java/docs/reference/gax/latest/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.68.2](/java/docs/reference/gax/2.68.2/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.67.0](/java/docs/reference/gax/2.67.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.66.0](/java/docs/reference/gax/2.66.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.65.0](/java/docs/reference/gax/2.65.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.63.1](/java/docs/reference/gax/2.63.1/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.62.0](/java/docs/reference/gax/2.62.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.61.0](/java/docs/reference/gax/2.61.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.60.0](/java/docs/reference/gax/2.60.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.59.1](/java/docs/reference/gax/2.59.1/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.58.0](/java/docs/reference/gax/2.58.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.57.0](/java/docs/reference/gax/2.57.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.55.0](/java/docs/reference/gax/2.55.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.54.1](/java/docs/reference/gax/2.54.1/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.53.0](/java/docs/reference/gax/2.53.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.52.0](/java/docs/reference/gax/2.52.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.51.0](/java/docs/reference/gax/2.51.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.50.0](/java/docs/reference/gax/2.50.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.49.0](/java/docs/reference/gax/2.49.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.48.1](/java/docs/reference/gax/2.48.1/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.47.0](/java/docs/reference/gax/2.47.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.46.1](/java/docs/reference/gax/2.46.1/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.45.0](/java/docs/reference/gax/2.45.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.43.0](/java/docs/reference/gax/2.43.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.42.0](/java/docs/reference/gax/2.42.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.41.0](/java/docs/reference/gax/2.41.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.39.0](/java/docs/reference/gax/2.39.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.38.0](/java/docs/reference/gax/2.38.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.37.0](/java/docs/reference/gax/2.37.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.36.0](/java/docs/reference/gax/2.36.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.35.0](/java/docs/reference/gax/2.35.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.34.1](/java/docs/reference/gax/2.34.1/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.33.0](/java/docs/reference/gax/2.33.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.32.1](/java/docs/reference/gax/2.32.1/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.31.1](/java/docs/reference/gax/2.31.1/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.30.1](/java/docs/reference/gax/2.30.1/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.24.0](/java/docs/reference/gax/2.24.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.23.3](/java/docs/reference/gax/2.23.3/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.22.0](/java/docs/reference/gax/2.22.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.21.0](/java/docs/reference/gax/2.21.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.20.1](/java/docs/reference/gax/2.20.1/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.19.6](/java/docs/reference/gax/2.19.6/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.18.7](/java/docs/reference/gax/2.18.7/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.17.0](/java/docs/reference/gax/2.17.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.16.0](/java/docs/reference/gax/2.16.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.15.0](/java/docs/reference/gax/2.15.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.14.0](/java/docs/reference/gax/2.14.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.13.0](/java/docs/reference/gax/2.13.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.12.2](/java/docs/reference/gax/2.12.2/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.11.0](/java/docs/reference/gax/2.11.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.10.0](/java/docs/reference/gax/2.10.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.9.0](/java/docs/reference/gax/2.9.0/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.8.1](/java/docs/reference/gax/2.8.1/com.google.api.gax.retrying.ExponentialRetryAlgorithm)\n- [2.7.1](/java/docs/reference/gax/2.7.1/com.google.api.gax.retrying.ExponentialRetryAlgorithm) \n\n public class ExponentialRetryAlgorithm implements TimedRetryAlgorithmWithContext\n\nThe timed retry algorithm which uses jittered exponential backoff factor for calculating the next\nattempt execution time.\n\nThis class is thread-safe. \n\nInheritance\n-----------\n\n[java.lang.Object](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html) \\\u003e ExponentialRetryAlgorithm \n\nImplements\n----------\n\n[TimedRetryAlgorithmWithContext](/java/docs/reference/gax/latest/com.google.api.gax.retrying.TimedRetryAlgorithmWithContext) \n\nInherited Members\n-----------------\n\n[Object.clone()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#clone--) \n[Object.equals(Object)](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#equals-java.lang.Object-) \n[Object.finalize()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#finalize--) \n[Object.getClass()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#getClass--) \n[Object.hashCode()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#hashCode--) \n[Object.notify()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notify--) \n[Object.notifyAll()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notifyAll--) \n[Object.toString()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#toString--) \n[Object.wait()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait--) \n[Object.wait(long)](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-) \n[Object.wait(long,int)](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-int-)\n\nConstructors\n------------\n\n### ExponentialRetryAlgorithm(RetrySettings globalSettings, ApiClock clock)\n\n public ExponentialRetryAlgorithm(RetrySettings globalSettings, ApiClock clock)\n\nCreates a new exponential retry algorithm instance.\n\nMethods\n-------\n\n### createFirstAttempt()\n\n public TimedAttemptSettings createFirstAttempt()\n\nCreates a first attempt [TimedAttemptSettings](/java/docs/reference/gax/latest/com.google.api.gax.retrying.TimedAttemptSettings). The first attempt is configured to be\nexecuted immediately.\n\n### createFirstAttempt(RetryingContext context)\n\n public TimedAttemptSettings createFirstAttempt(RetryingContext context)\n\nCreates a first attempt [TimedAttemptSettings](/java/docs/reference/gax/latest/com.google.api.gax.retrying.TimedAttemptSettings). The first attempt is configured to be\nexecuted immediately.\n\n### createNextAttempt(RetryingContext context, TimedAttemptSettings previousSettings)\n\n public TimedAttemptSettings createNextAttempt(RetryingContext context, TimedAttemptSettings previousSettings)\n\nCreates a next attempt [TimedAttemptSettings](/java/docs/reference/gax/latest/com.google.api.gax.retrying.TimedAttemptSettings). The implementation increments the current\nattempt count and uses randomized exponential backoff factor for calculating next attempt\nexecution time.\n\n### createNextAttempt(TimedAttemptSettings previousSettings)\n\n public TimedAttemptSettings createNextAttempt(TimedAttemptSettings previousSettings)\n\nCreates a next attempt [TimedAttemptSettings](/java/docs/reference/gax/latest/com.google.api.gax.retrying.TimedAttemptSettings). The implementation increments the current\nattempt count and uses randomized exponential backoff factor for calculating next attempt\nexecution time.\n\n### nextRandomLong(long bound)\n\n protected long nextRandomLong(long bound)\n\n### shouldRPCTerminate(long timeLeftMs)\n\n protected boolean shouldRPCTerminate(long timeLeftMs)\n\n| **Internal Only**: This feature is not stable for application use.\n\n### shouldRetry(RetryingContext context, TimedAttemptSettings nextAttemptSettings)\n\n public boolean shouldRetry(RetryingContext context, TimedAttemptSettings nextAttemptSettings)\n\nReturns `true` if another attempt should be made, or `false` otherwise.\n\n### shouldRetry(TimedAttemptSettings nextAttemptSettings)\n\n public boolean shouldRetry(TimedAttemptSettings nextAttemptSettings)\n\nReturns `true` if another attempt should be made, or `false` otherwise."]]
