Table of Contents

Class CdcFatalClassifier

Namespace
Excalibur.Cdc
Assembly
Excalibur.Cdc.dll

Decides whether a CDC processing fault requires the loop to stop for review or permits recovery by the existing backoff-reconnect policy. Stopped faults never advance the checkpoint.

public static class CdcFatalClassifier
Inheritance
CdcFatalClassifier
Inherited Members

Remarks

When an IMessageFailureClassifier is available (the registered DefaultMessageFailureClassifier when Dispatch is wired) it is the single source of truth, so the CDC retry-vs-terminate decision stays consistent with the rest of the pipeline.

When no classifier is supplied, a conservative fallback reconnects recognized transient BCL faults. Unrecognized faults stop for review without advancing the checkpoint. Stopping an unknown fault is not a classification as permanent or poison.

This is part of the supported CDC extensibility surface: a consumer implementing a custom ICdcProcessor composes it to apply the framework's recommended fatal-vs-transient decision (the same one the built-in providers use), rather than re-deriving it.

Methods

IsFatal(Exception, IMessageFailureClassifier?)

Determines whether exception is fatal (non-retryable).

public static bool IsFatal(Exception exception, IMessageFailureClassifier? classifier)

Parameters

exception Exception

The exception raised during CDC processing.

classifier IMessageFailureClassifier

The shared failure classifier, or null to use the conservative built-in fallback.

Returns

bool

true if the loop must stop (permanent, poison or unknown); false for recognized transient/uncertain failures or cooperative cancellation. A stopped unknown fault retains its checkpoint; it is not a permanent rejection.