Packages

trait RetrySupport extends AnyRef

This trait provides the retry utility function

Source
RetrySupport.scala
Linear Supertypes
Known Subclasses
Type Hierarchy
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. RetrySupport
  2. AnyRef
  3. Any
Implicitly
  1. by any2stringadd
  2. by StringFormat
  3. by Ensuring
  4. by ArrowAssoc
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##: Int
    Definition Classes
    AnyRef → Any
  3. def +(other: String): String
    Implicit
    This member is added by an implicit conversion from RetrySupport toany2stringadd[RetrySupport] performed by method any2stringadd in scala.Predef.
    Definition Classes
    any2stringadd
  4. def ->[B](y: B): (RetrySupport, B)
    Implicit
    This member is added by an implicit conversion from RetrySupport toArrowAssoc[RetrySupport] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @inline()
  5. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  6. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  7. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @HotSpotIntrinsicCandidate() @native()
  8. def ensuring(cond: (RetrySupport) => Boolean, msg: => Any): RetrySupport
    Implicit
    This member is added by an implicit conversion from RetrySupport toEnsuring[RetrySupport] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  9. def ensuring(cond: (RetrySupport) => Boolean): RetrySupport
    Implicit
    This member is added by an implicit conversion from RetrySupport toEnsuring[RetrySupport] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  10. def ensuring(cond: Boolean, msg: => Any): RetrySupport
    Implicit
    This member is added by an implicit conversion from RetrySupport toEnsuring[RetrySupport] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  11. def ensuring(cond: Boolean): RetrySupport
    Implicit
    This member is added by an implicit conversion from RetrySupport toEnsuring[RetrySupport] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  12. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  13. def equals(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef → Any
  14. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  15. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  16. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  17. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  18. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  19. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  20. def retry[T](attempt: () => Future[T], shouldRetry: (Throwable) => Boolean, attempts: Int, delayFunction: (Int) => Option[FiniteDuration])(implicit ec: ExecutionContext, scheduler: Scheduler): Future[T]

    Given a function from Unit to Future, returns an internally retrying Future.

    Given a function from Unit to Future, returns an internally retrying Future. The first attempt will be made immediately, any subsequent attempt will be made after the 'delay' return by delayFunction(the input next attempt count start from 1). Returns None for no delay. A scheduler (eg context.system.scheduler) must be provided to delay each retry. You could provide a function to generate the next delay duration after first attempt, this function should never return null, otherwise an IllegalArgumentException will be thrown.

    If attempts are exhausted the returned future is simply the result of invoking attempt. Note that the attempt function will be invoked on the given execution context for subsequent tries and therefore must be thread safe (not touch unsafe mutable state).

    If an attempt fails, the exception from the failure will be passed to the 'shouldRetry' predicate; if the predicate evaluates 'true', a retry will be attempted. This allows for short-circuiting in situations where the retries cannot be expected to succeed (e.g. in a situation where the legality of arguments can only be determined asynchronously).

    Example usage:

    // retry with backoff

    protected val sendAndReceive: HttpRequest => Future[HttpResponse] = { (req) => ??? }
    private val sendReceiveRetry: HttpRequest => Future[HttpResponse] = (req: HttpRequest) => retry[HttpResponse](
      attempt = () => sendAndReceive(req),
      attempts = 10,
      delayFunction = attempted => Option(2.seconds * attempted),
      shouldRetry = ex => !ex.isInstanceOf[IllegalArgumentException]
    )
  21. def retry[T](attempt: () => Future[T], attempts: Int, delayFunction: (Int) => Option[FiniteDuration])(implicit ec: ExecutionContext, scheduler: Scheduler): Future[T]

    Given a function from Unit to Future, returns an internally retrying Future.

    Given a function from Unit to Future, returns an internally retrying Future. The first attempt will be made immediately, each subsequent attempt will be made after the 'delay' return by delayFunction(the input next attempt count start from 1). Returns None for no delay. A scheduler (eg context.system.scheduler) must be provided to delay each retry. You could provide a function to generate the next delay duration after first attempt, this function should never return null, otherwise an IllegalArgumentException will be thrown.

    If attempts are exhausted the returned future is simply the result of invoking attempt. Note that the attempt function will be invoked on the given execution context for subsequent tries and therefore must be thread safe (not touch unsafe mutable state).

    Example usage:

    //retry with back off

    protected val sendAndReceive: HttpRequest => Future[HttpResponse]
    private val sendReceiveRetry: HttpRequest => Future[HttpResponse] = (req: HttpRequest) => retry[HttpResponse](
      attempt = () => sendAndReceive(req),
      attempts = 10,
      delayFunction = attempted => Option(2.seconds * attempted)
    )
  22. def retry[T](attempt: () => Future[T], attempts: Int, delay: FiniteDuration)(implicit ec: ExecutionContext, scheduler: Scheduler): Future[T]

    Given a function from Unit to Future, returns an internally retrying Future.

    Given a function from Unit to Future, returns an internally retrying Future. The first attempt will be made immediately, each subsequent attempt will be made after 'delay'. A scheduler (eg context.system.scheduler) must be provided to delay each retry.

    If attempts are exhausted the returned future is simply the result of invoking attempt. Note that the attempt function will be invoked on the given execution context for subsequent tries and therefore must be thread safe (not touch unsafe mutable state).

    Example usage:

    protected val sendAndReceive: HttpRequest => Future[HttpResponse]
    private val sendReceiveRetry: HttpRequest => Future[HttpResponse] = (req: HttpRequest) => retry[HttpResponse](
      attempt = () => sendAndReceive(req),
      attempts = 10,
      delay = 2.seconds
    )
  23. def retry[T](attempt: () => Future[T], shouldRetry: (Throwable) => Boolean, attempts: Int, minBackoff: FiniteDuration, maxBackoff: FiniteDuration, randomFactor: Double)(implicit ec: ExecutionContext, scheduler: Scheduler): Future[T]

    Given a function from Unit to Future, returns an internally retrying Future.

    Given a function from Unit to Future, returns an internally retrying Future. The first attempt will be made immediately, each subsequent attempt will made with a backoff time if the preceding attempt failed and the 'shouldRetry' predicate, when applied to the failure's exception evaluates to 'true'. If the predicate evaluates to 'false', the failed attempt will be returned. This allows for short-circuiting in situations where the retries cannot be expected to succeed (e.g. in a situation where the legality of arguments can only be determined asynchronously).

    If attempts are exhausted, the returned future is that of the last attempt. Note that the attempt function will be invoked on the given execution context for subsequent tries and therefore must be thread safe (not touch unsafe mutable state).

    Example usage:

    protected def sendAndReceive(req: HttpRequest): Future[HttpResponse]
    private val sendReceiveRetry: HttpRequest => Future[HttpResponse] = (req: HttpRequest) => retry[HttpResponse](
      attempt = () => sendAndReceive(req),
      attempts = 10,
      minBackoff = 1.second,
      maxBackoff = 10.seconds,
      randomFactor = 0.2,
      shouldRetry = ex => !ex.isInstanceOf[IllegalArgumentException])
  24. def retry[T](attempt: () => Future[T], attempts: Int, minBackoff: FiniteDuration, maxBackoff: FiniteDuration, randomFactor: Double)(implicit ec: ExecutionContext, scheduler: Scheduler): Future[T]

    Given a function from Unit to Future, returns an internally retrying Future.

    Given a function from Unit to Future, returns an internally retrying Future. The first attempt will be made immediately, each subsequent attempt will be made with a backoff time, if the previous attempt failed.

    If attempts are exhausted the returned future is simply the result of invoking attempt. Note that the attempt function will be invoked on the given execution context for subsequent tries and therefore must be thread safe (not touch unsafe mutable state).

    Example usage:

    protected val sendAndReceive: HttpRequest => Future[HttpResponse]
    private val sendReceiveRetry: HttpRequest => Future[HttpResponse] = (req: HttpRequest) => retry[HttpResponse](
      attempt = () => sendAndReceive(req),
      attempts = 10,
      minBackoff = 1.seconds,
      maxBackoff = 2.seconds,
      randomFactor = 0.5
    )
    minBackoff

    minimum (initial) duration until the child actor will started again, if it is terminated

    maxBackoff

    the exponential back-off is capped to this duration

    randomFactor

    after calculation of the exponential back-off an additional random delay based on this factor is added, e.g. 0.2 adds up to 20% delay. In order to skip this additional delay pass in 0.

  25. def retry[T](attempt: () => Future[T], shouldRetry: (Throwable) => Boolean, attempts: Int)(implicit ec: ExecutionContext): Future[T]

    Given a function from Unit to Future, returns an internally retrying Future.

    Given a function from Unit to Future, returns an internally retrying Future. The first attempt will be made immediately, each subsequent attempt will be made immediately if the preceding attempt failed and the 'shouldRetry' predicate, when applied to the failure's exception evaluates to 'true'. If the predicate evaluates to 'false', the failed attempt will be returned. This allows for short-circuiting in situations where the retries cannot be expected to succeed (e.g. in a situation where the legality of arguments can only be determined asynchronously).

    If attempts are exhausted, the returned future is the that of the last attempt. Note that the attempt function will be invoked on the given execution context for subsequent tries and therefore must be thread safe (not touch unsafe mutable state).

    Example usage

    def possiblyFailing(): Future[Something] = ???
    val withRetry: Future[Something] = retry(
      attempt = possiblyFailing,
      attempts = 10,
      shouldRetry = { (ex) => ex.isInstanceOf[IllegalArgumentException] })
  26. def retry[T](attempt: () => Future[T], attempts: Int)(implicit ec: ExecutionContext): Future[T]

    Given a function from Unit to Future, returns an internally retrying Future.

    Given a function from Unit to Future, returns an internally retrying Future. The first attempt will be made immediately, each subsequent attempt will be made immediately if the previous attempt failed.

    If attempts are exhausted the returned future is simply the result of invoking attempt. Note that the attempt function will be invoked on the given execution context for subsequent tries and therefore must be thread safe (not touch unsafe mutable state).

    Example usage:

    def possiblyFailing(): Future[Something] = ???
    val withRetry: Future[Something] = retry(attempt = possiblyFailing, attempts = 10)
  27. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  28. def toString(): String
    Definition Classes
    AnyRef → Any
  29. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  30. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException]) @native()
  31. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])

Deprecated Value Members

  1. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.Throwable]) @Deprecated
    Deprecated

    (Since version 9)

  2. def formatted(fmtstr: String): String
    Implicit
    This member is added by an implicit conversion from RetrySupport toStringFormat[RetrySupport] performed by method StringFormat in scala.Predef.
    Definition Classes
    StringFormat
    Annotations
    @deprecated @inline()
    Deprecated

    (Since version 2.12.16) Use formatString.format(value) instead of value.formatted(formatString), or use the f"" string interpolator. In Java 15 and later, formatted resolves to the new method in String which has reversed parameters.

  3. def [B](y: B): (RetrySupport, B)
    Implicit
    This member is added by an implicit conversion from RetrySupport toArrowAssoc[RetrySupport] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @deprecated
    Deprecated

    (Since version 2.13.0) Use -> instead. If you still wish to display it as one character, consider using a font with programming ligatures such as Fira Code.

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion any2stringadd fromRetrySupport to any2stringadd[RetrySupport]

Inherited by implicit conversion StringFormat fromRetrySupport to StringFormat[RetrySupport]

Inherited by implicit conversion Ensuring fromRetrySupport to Ensuring[RetrySupport]

Inherited by implicit conversion ArrowAssoc fromRetrySupport to ArrowAssoc[RetrySupport]

Ungrouped