Class OutboxFenceRefusedException
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
messagestringThe 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)