Object

com.gilt.gfc.util

Retry

Related Doc: package util

Permalink

object Retry

Helper to retry potentially failing functions

Since

10/Apr/2015 16:55

Linear Supertypes
AnyRef, Any
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. Retry
  2. AnyRef
  3. Any
  1. Hide All
  2. Show all
Visibility
  1. Public
  2. All

Value Members

  1. final def !=(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  4. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  5. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  6. final def eq(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  7. def equals(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  8. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  9. final def getClass(): Class[_]

    Permalink
    Definition Classes
    AnyRef → Any
  10. def hashCode(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  11. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  12. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  13. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
  14. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
  15. def retry[T](maxRetryTimes: Long = Long.MaxValue)(f: ⇒ T)(implicit log: (Throwable) ⇒ Unit = _.printStackTrace): T

    Permalink

    Retries a function until it succeeds or a maximum number of retries has been reached.

    Retries a function until it succeeds or a maximum number of retries has been reached.

    maxRetryTimes

    The maximum number of retries, defaults to Long.MaxValue. The function f is called at most maxRetryTimes + 1 times. In other words, iff maxRetryTimes == 0, f will be called exactly once, iff maxRetryTimes == 1, it will be called at most twice, etc.

    f

    The function to (re)try

    log

    An optional log function to report failed iterations to. By default prints the thrown Exception to the console.

    returns

    A successful T if the function succeeded within maxRetryTimes or the last thrown NonFatal Exception otherwise. If the function throws a fatal Error, it is not retried and the error is rethrown.

    Annotations
    @tailrec()
  16. def retryWithExponentialDelay[T](maxRetryTimes: Long = Long.MaxValue, maxRetryTimeout: Deadline = 1 day fromNow, initialDelay: Duration = 1 millisecond, maxDelay: FiniteDuration = 1 day, exponentFactor: Double = 2)(f: ⇒ T)(implicit log: (Throwable) ⇒ Unit = _.printStackTrace): T

    Permalink

    Retries a function until it succeeds, a maximum number of retries has been reached, or a retry timeout has been reached.

    Retries a function until it succeeds, a maximum number of retries has been reached, or a retry timeout has been reached. Each retry iteration is being exponentially delayed. The delay grows from a given start value and by a given factor until it reaches a given maximum delay value. If maxRetryTimeout is reached, the last function call is at the point of the timeout. E.g. if the initial delay is 1 second, the retry timeout 10 seconds and all other parameters at their default, the function will be retried after 1, 3 (1+2), 7 (1+2+4) and finally 10 seconds before it fails.

    maxRetryTimes

    The maximum number of retries, defaults to Long.MaxValue. The function f is called at most maxRetryTimes + 1 times. In other words, iff maxRetryTimes == 0, f will be called exactly once, iff maxRetryTimes == 1, it will be called at most twice, etc.

    maxRetryTimeout

    The retry Deadline until which to retry the function, defaults to 1 day from now

    initialDelay

    The initial delay value, defaults to 1 nanosecond

    maxDelay

    The maximum delay value, defaults to 1 day

    exponentFactor

    The factor by which the delay increases between retry iterations

    f

    The function to (re)try

    log

    An optional log function to report failed iterations to. By default prints the thrown Exception to the console.

    returns

    A successful T if the function succeeded within maxRetryTimes and maxRetryTimeout or the last thrown NonFatal Exception otherwise. If the function throws a fatal Error, it is not retried and the error is rethrown.

    Annotations
    @tailrec()
  17. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  18. def toString(): String

    Permalink
    Definition Classes
    AnyRef → Any
  19. final def wait(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  20. final def wait(arg0: Long, arg1: Int): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  21. final def wait(arg0: Long): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Inherited from AnyRef

Inherited from Any

Ungrouped