Retry

Object Hierarchy:

Description:

    Retry retry = Retry.networkDefault ();
    var configured = retry.withMaxAttempts (3);
    if (configured.isError ()) {
        return;
    }
    retry.onRetry ((attempt, reason, delay) => {
            print ("retry %d: %s (%" + int64.FORMAT + "ms)\n", attempt, reason, delay);
        });

    bool ok = retry.retry (() => {
        return call_external_service ();
    });

Content:

Static methods:

• public static Retry ioDefault ()
  Creates recommended retry policy for short I/O lock/contention cases.
• public static Retry networkDefault ()
  Creates recommended retry policy for network operations.

Creation methods:

• public Retry ()
  Creates retry policy with conservative default settings.

Methods:

• public Retry httpStatusRetry (ArrayList<int> statusCodes)
  Configures retry predicate from HTTP status code list.
• public Retry onRetry (owned RetryCallback fn)
  Registers callback called before sleeping for next attempt.
• public bool retry (owned RetryFunc fn)
  Retries bool callback until success or attempts exhausted.
• public T retryResult<T> (owned RetryResultFunc<T> fn)
  Retries nullable callback until non-null value or attempts exhausted.
• public bool retryVoid (owned RetryVoidFunc fn)
  Retries callback that returns Result.
• public Result<Retry,Error> withBackoff (Duration initial, Duration max)
  Sets exponential backoff strategy.
• public Result<Retry,Error> withFixedDelay (Duration delay)
  Sets fixed delay strategy.
• public Retry withJitter (bool enabled)
  Enables or disables random jitter.
• public Result<Retry,Error> withMaxAttempts (int n)
  Sets maximum attempts.
• public Retry withRetryOn (owned RetryOnFunc shouldRetry)
  Sets retry predicate for failure reason text.

Inherited Members: