Skip to content

Commit 895ae20

Browse files
committed
Remove author and version comments from Retry classes to streamline code documentation.
1 parent faa5b5d commit 895ae20

File tree

5 files changed

+2
-23
lines changed

5 files changed

+2
-23
lines changed

src/main/java/com/contentstack/cms/core/RetryCallback.java

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,6 @@
1616
/**
1717
* The Contentstack RetryCallback
1818
*
19-
* @author ***REMOVED ** @version v0.1.0
2019
* @since 2022-10-20
2120
*/
2221
public abstract class RetryCallback<T> implements Callback<T> {

src/main/java/com/contentstack/cms/core/RetryCondition.java

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,19 +7,14 @@
77
* <p>
88
* This interface allows custom logic to determine whether a failed request
99
* should be retried based on the HTTP status code and/or the exception that occurred.
10-
* </p>
1110
* <p>
1211
* Status code conventions:
1312
* <ul>
1413
* <li>0 = Network error (IOException, SocketTimeoutException) - typically retryable</li>
1514
* <li>-1 = Unknown error - typically not retryable</li>
1615
* <li>Other values = HTTP status codes (200-599)</li>
1716
* </ul>
18-
* </p>
1917
*
20-
* @author Contentstack
21-
* @version v1.0.0
22-
* @since 2026-01-28
2318
*/
2419
@FunctionalInterface
2520
public interface RetryCondition {

src/main/java/com/contentstack/cms/core/RetryConfig.java

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -13,19 +13,14 @@
1313
* <li>How long to wait between retries (retryDelay, retryDelayOptions)</li>
1414
* <li>Which errors should be retried (retryCondition)</li>
1515
* </ul>
16-
* </p>
1716
* <p>
1817
* This configuration is used by:
1918
* <ul>
2019
* <li>AuthInterceptor (non-OAuth synchronous calls)</li>
2120
* <li>OAuthInterceptor (OAuth synchronous calls)</li>
2221
* <li>RetryCallback (asynchronous calls)</li>
2322
* </ul>
24-
* </p>
2523
*
26-
* @author Contentstack
27-
* @version v1.0.0
28-
* @since 2026-01-28
2924
*/
3025
public class RetryConfig {
3126

@@ -122,7 +117,6 @@ public RetryDelayOptions getRetryDelayOptions() {
122117
* <li>retryCondition: DefaultRetryCondition (retries on 408, 429, 5xx, network errors)</li>
123118
* <li>retryDelayOptions: null (uses fixed retryDelay)</li>
124119
* </ul>
125-
* </p>
126120
*
127121
* @return a default RetryConfig instance
128122
*/
@@ -143,7 +137,7 @@ public static class Builder {
143137
* Sets the maximum number of retry attempts.
144138
* Default: 3 (for backward compatibility)
145139
*
146-
* @param retryLimit the retry limit (must be >= 0)
140+
* @param retryLimit the retry limit (must be &gt;= 0)
147141
* @return this builder instance
148142
* @throws IllegalArgumentException if retryLimit is negative
149143
*/
@@ -160,7 +154,7 @@ public Builder retryLimit(int retryLimit) {
160154
* This is used when retryDelayOptions are not configured.
161155
* Default: 300ms
162156
*
163-
* @param retryDelay the delay in milliseconds (must be >= 0)
157+
* @param retryDelay the delay in milliseconds (must be &gt;= 0)
164158
* @return this builder instance
165159
* @throws IllegalArgumentException if retryDelay is negative
166160
*/

src/main/java/com/contentstack/cms/core/RetryDelayOptions.java

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11,11 +11,7 @@
1111
* <li><b>Linear Backoff:</b> If {@code base} is set, delay = base * retryCount</li>
1212
* <li><b>Fixed Delay:</b> Falls back to {@code retryDelay} from RetryConfig</li>
1313
* </ol>
14-
* </p>
1514
*
16-
* @author Contentstack
17-
* @version v1.0.0
18-
* @since 2026-01-28
1915
*/
2016
public class RetryDelayOptions {
2117

src/main/java/com/contentstack/cms/core/RetryUtil.java

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,6 @@
99
* Provides helper methods for calculating retry delays based on RetryConfig.
1010
* </p>
1111
*
12-
* @author Contentstack
13-
* @version v1.0.0
14-
* @since 2026-01-28
1512
*/
1613
public class RetryUtil {
1714

@@ -24,14 +21,12 @@ private RetryUtil() {
2421

2522
/**
2623
* Calculates the delay in milliseconds before the next retry attempt.
27-
* <p>
2824
* Priority order:
2925
* <ol>
3026
* <li>If {@code retryDelayOptions.customBackoff} is set, use it</li>
3127
* <li>If {@code retryDelayOptions.base} is set, use linear backoff: base * retryCount</li>
3228
* <li>Otherwise, use fixed {@code retryDelay} from RetryConfig</li>
3329
* </ol>
34-
* </p>
3530
*
3631
* @param config the RetryConfig containing delay settings
3732
* @param retryCount the current retry attempt number (1-based: 1st retry, 2nd retry, etc.)

0 commit comments

Comments
 (0)