retry: add comments to getNextRetryIntervalMillis.

Author: kenmccracken

examples/here-oauth-client-example/dependency-reduced-pom.xml

@@ -3,7 +3,7 @@
   <parent>
     <artifactId>here-aaa-sdk</artifactId>
     <groupId>com.here.account</groupId>
-    <version>0.4.22</version>
+    <version>0.4.23-SNAPSHOT</version>
     <relativePath>../../pom.xml</relativePath>
   </parent>
   <modelVersion>4.0.0</modelVersion>
@@ -71,7 +71,7 @@
     <dependency>
       <groupId>junit</groupId>
       <artifactId>junit</artifactId>
-      <version>4.11</version>
+      <version>4.13.1</version>
       <scope>test</scope>
       <exclusions>
         <exclusion>

here-oauth-client/src/main/java/com/here/account/oauth2/retry/Socket5xxExponentialRandomBackoffPolicy.java

@@ -41,6 +41,13 @@ public boolean shouldRetry(RetryContext retryContext) {
                 || (null != retryContext.getLastException() && retryContext.getLastException().getCause() instanceof SocketTimeoutException);
     }
 
+    /**
+     * Employs the exponential random backoff policy using a base of 2 and exponent of number of retries,
+     * up to a maximum, subject to the configured maxRetryFactor, and multiplied by the retryIntervalMillis.
+     *
+     * @param retryContext An instance of {@link RetryContext}
+     * @return the next retry interval in milliseconds
+     */
     @Override
     public int getNextRetryIntervalMillis(RetryContext retryContext){
         int retryCount = retryContext.getRetryCount();