client/me.ahoo.wow.client/PeerProblem

PeerProblem

class PeerProblem(val status: Int, val code: String?, val detail: String?, val result: CommandResult?, val retry: Retry, val retryAfter: Duration?, val version: Int? = null, val cause: Throwable? = null, val title: String? = null, val violations: List<Violation> = emptyList(), val extensions: Map<String, Any?> = emptyMap())

A problem a peer answered with (RFC 9457): its HTTP status, its Wow code (none for one that is only HTTP's, or a body that is no problem, such as a proxy's), its detail, the command's result when it had a ref, what a retry may do and after how long (retryAfter, its Retry-After), and the aggregate's version it answered: a rejection's, or the current one a state read of a minimum version was answered with (wow.query.min-version-not-reached). A failure the client's transport met itself (no node reached, a connection lost) is one too, of a catalog code, with that failure as its cause.

Constructors

PeerProblem

constructor(status: Int, code: String?, detail: String?, result: CommandResult?, retry: Retry, retryAfter: Duration?, version: Int? = null, cause: Throwable? = null, title: String? = null, violations: List<Violation> = emptyList(), extensions: Map<String, Any?> = emptyMap())

Types

Companion

@InternalWowApi

object Companion

Properties

cause

val cause: Throwable?

code

val code: String?

detail

val detail: String?

extensions

val extensions: Map<String, Any?>

The problem's other members, those RFC 9457 and Wow do not name, each by its name.

refusedBeforeHandling

val refusedBeforeHandling: Boolean

Whether the node refused the request before handling it, so another node of the peer may take it: a 503 carrying Wow's own code of a node that is shutting down or on standby. A bare 503, or a gateway's, is no proof that nothing ran.

result

val result: CommandResult?

retriesCommand

val retriesCommand: Boolean

Whether the client sends a command answered so again itself, with its request id: never a

retriesQuery

val retriesQuery: Boolean

Whether a query answered so is run again: a retry may get past it, a query repeating nothing; but a state read below its minimum version, which the peer already waited for, is the caller's to wait for again (me.ahoo.wow.api.read.MinVersionNotReachedException).

retry

val retry: Retry

retryAfter

val retryAfter: Duration?

status

val status: Int

title

val title: String?

The problem's title; null when it has none.

version

val version: Int?

violations