Table of Contents

Class OutboxFenceRefusedException

Namespace
Excalibur.Dispatch
Assembly
Excalibur.Dispatch.Abstractions.dll

Base type for every refusal of an outbox completion: the signal that a drain operation was declined because the caller can no longer prove it is entitled to decide this message's fate.

public abstract class OutboxFenceRefusedException : Exception, ISerializable
Inheritance
OutboxFenceRefusedException
Implements
Derived
Inherited Members
Extension Methods

Remarks

A refusal is not a delivery failure, and the distinction is the reason this type exists. A caller that cannot tell the two apart routes the refusal into its failure handling and marks, retries, or dead-letters a message it no longer owns — an unfenced write performed by a superseded tenure, which is precisely what the fence exists to prevent. Catching this base type gives a caller that property once, for every refusal, including ones added later; catching each derived type separately re-opens the hole the next time the family grows.

Abort the refused operation without a failure-store fallback. A learned stale-token refusal additionally stops later admissions at that captured token or older tokens in the same authority domain. An absent token stops the current drain without inventing a rejected-token watermark. The live leader resolves claims left behind once they age out; typed row-scoped outcomes allow unrelated rows to continue.

The family is defined by that obligation, not by the mechanism that produced it. Entitlement can be lost in more than one way - a tenure superseded by a newer leader, or a claim that lapsed and was taken by a later cycle of the SAME processor - and the caller's correct response does not vary between them. The name says "fence" for historical reasons; the obligation above, not the name, is the membership test for whether a new refusal belongs here.

Constructors

OutboxFenceRefusedException()

Initializes a new instance of the OutboxFenceRefusedException class.

protected OutboxFenceRefusedException()

OutboxFenceRefusedException(string)

Initializes a new instance of the OutboxFenceRefusedException class with a message.

protected OutboxFenceRefusedException(string message)

Parameters

message string

The message that describes the refusal.

OutboxFenceRefusedException(string, Exception)

Initializes a new instance of the OutboxFenceRefusedException class with a message and an inner exception.

protected OutboxFenceRefusedException(string message, Exception innerException)

Parameters

message string

The message that describes the refusal.

innerException Exception

The exception that caused this refusal.