kernel/me.ahoo.wow.kernel/HandlerRetry

HandlerRetry

class HandlerRetry @InternalWowApi constructor(val maxAttempts: Int? = null, val initialBackoff: Duration? = null, val maxBackoff: Duration? = null, val multiplier: Double? = null, val timeout: Duration? = null, val recoverable: List<Class<out Throwable>>? = null, val unrecoverable: List<Class<out Throwable>>? = null, val systemic: List<Class<out Throwable>>? = null)

A subscription's own in-process retry budget: the settings it gives, each null when it gives none, which then come from the budget below it (over). A handler's @Retry gives one (of), the host's wow.subscriptions.[<context>.<name>].retry.* another, over it; both fall back to wow.subscription.retry.

maxAttempts: the calls in all, at least 1.
initialBackoff: the wait after the first failure; maxBackoff: the longest wait; multiplier: how much longer each next wait is.
timeout: how long one attempt may run before it is cancelled and counted as failed.
recoverable, unrecoverable, systemic: the exception classes the handler classifies itself, each with its subclasses (classify); null when not given, never empty.

Constructors

HandlerRetry

@InternalWowApi

constructor(maxAttempts: Int? = null, initialBackoff: Duration? = null, maxBackoff: Duration? = null, multiplier: Double? = null, timeout: Duration? = null, recoverable: List<Class<out Throwable>>? = null, unrecoverable: List<Class<out Throwable>>? = null, systemic: List<Class<out Throwable>>? = null)

Types

Companion

object Companion

Properties

initialBackoff

val initialBackoff: Duration?

isEmpty

val isEmpty: Boolean

Whether no setting is given.

maxAttempts

val maxAttempts: Int?

maxBackoff

val maxBackoff: Duration?

multiplier

val multiplier: Double?

recoverable

val recoverable: List<Class<out Throwable>>?

systemic

val systemic: List<Class<out Throwable>>?

timeout

val timeout: Duration?

unrecoverable

val unrecoverable: List<Class<out Throwable>>?

Functions

classify

fun classify(failure: Throwable): FailureClass?

The class of failure by the handler's own lists (9.x Retry.recoverable): the class of the list whose class is nearest to it in its class hierarchy, recoverable then systemic then unrecoverable on a tie; null when no list holds a class it is an instance of.

equals

open operator override fun equals(other: Any?): Boolean

hashCode

open override fun hashCode(): Int

over

fun over(base: HandlerRetry?): HandlerRetry

These settings, each one not given being base's.

toString

open override fun toString(): String