Packages

object RetryFlow

Source
RetryFlow.scala
Linear Supertypes
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. RetryFlow
  2. AnyRef
  3. Any
  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. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  4. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  5. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @HotSpotIntrinsicCandidate() @native()
  6. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  7. def equals(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef → Any
  8. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  9. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  10. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  11. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  12. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  13. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @HotSpotIntrinsicCandidate() @native()
  14. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  15. def toString(): String
    Definition Classes
    AnyRef → Any
  16. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  17. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException]) @native()
  18. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  19. def withBackoff[In, Out, Mat](minBackoff: FiniteDuration, maxBackoff: FiniteDuration, randomFactor: Double, maxRetries: Int, flow: Flow[In, Out, Mat])(decideRetry: (In, Out) => Option[In]): Flow[In, Out, Mat]

    API may change!

    API may change!

    Allows retrying individual elements in the stream with an exponential backoff.

    The retry condition is controlled by the decideRetry function. It takes the originally emitted element and the response emitted by flow, and may return a request to be retried.

    The implementation of the RetryFlow requires that flow follows strict first-in-first-out and one-in-one-out semantics, i.e., the Flow may neither filter elements, nor emit more than one element per incoming element. The RetryFlow will fail if two elements are emitted for one incoming element. Any sort of batching, grouping, or filtering will make it hang forever.

    Just one element will be emitted into the flow at any time. Let's say the flow is handling an element, either first-time executing some calculation, or retrying. The next element won't be emitted into the flow until the current element has been finished processing. By finished, it means either succeed the very first attempt, succeed after a few attempts, or get dropped after using up maxRetries retries.

    minBackoff

    minimum duration to backoff between issuing retries

    maxBackoff

    maximum duration to backoff between issuing retries

    randomFactor

    adds jitter to the retry delay. Use 0 for no jitter

    maxRetries

    total number of allowed retries, when reached the last result will be emitted even if unsuccessful

    flow

    a flow to retry elements from

    decideRetry

    retry condition decision function

    Annotations
    @ApiMayChange()
  20. def withBackoffAndContext[In, CtxIn, Out, CtxOut, Mat](minBackoff: FiniteDuration, maxBackoff: FiniteDuration, randomFactor: Double, maxRetries: Int, flow: FlowWithContext[In, CtxIn, Out, CtxOut, Mat])(decideRetry: ((In, CtxIn), (Out, CtxOut)) => Option[(In, CtxIn)]): FlowWithContext[In, CtxIn, Out, CtxOut, Mat]

    API may change!

    API may change!

    Allows retrying individual elements in the stream with an exponential backoff.

    The retry condition is controlled by the decideRetry function. It takes the originally emitted element with its context, and the response emitted by flow, and may return a request to be retried.

    The implementation of the RetryFlow requires that flow follows one-in-one-out semantics, the FlowWithContext may not filter elements, nor emit more than one element per incoming element. The RetryFlow will fail if two elements are emitted from the flow, it will be stuck "forever" if nothing is emitted. Just one element will be emitted into the flow at any time. The flow needs to emit an element before the next will be emitted to it.

    The wrapped flow and decideRetry take the additional context parameters which can be a context, or used to control retrying with other information.

    minBackoff

    minimum duration to backoff between issuing retries

    maxBackoff

    maximum duration to backoff between issuing retries

    randomFactor

    adds jitter to the retry delay. Use 0 for no jitter

    maxRetries

    total number of allowed retries, when reached the last result will be emitted even if unsuccessful

    flow

    a flow with context to retry elements from

    decideRetry

    retry condition decision function

    Annotations
    @ApiMayChange()

Deprecated Value Members

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

    (Since version 9)

Inherited from AnyRef

Inherited from Any

Ungrouped