kuilt-bolt/us.tractat.kuilt.bolt/AppendResult/Failed

Failed

data class Failed(val reason: String, val insertDots: Set<Dot>, val offset: Long?, val endOffset: Long? = null, val cause: Throwable? = null) : AppendResult

The append failed. The ops are lost from the archive.

This is worse than it sounds, which is why this variant reports identities rather than a count: the live replica will subsequently window those records away, so they are gone from both sides. A consumer holding insertDots can defer windowing for them, re-feed them, or correlate the gap against a backend; a consumer holding failed++ can do none of those.

Constructors

Failed

constructor(reason: String, insertDots: Set<Dot>, offset: Long?, endOffset: Long? = null, cause: Throwable? = null)

Properties

cause

val cause: Throwable?

the underlying failure, when there was one.

endOffset

val endOffset: Long?

one past the last byte actually written before the failure, or null when nothing was written or the extent is unknown. Together with offset this is the damaged byte range.

insertDots

val insertDots: Set<Dot>

the insert dots the lost frame would have covered — the identities.

offset

val offset: Long?

the append offset the frame would have occupied, or null if the archive could not report one.

reason

val reason: String

a human-readable description of what went wrong.