Table of Contents

Class DeduplicationCapacityExceededException

Namespace
Excalibur.Dispatch.Delivery
Assembly
Excalibur.Dispatch.dll

Transient exception thrown by an in-memory deduplicator when its tracking store is at capacity and a record-producing operation cannot be honored without silently skipping deduplication.

public sealed class DeduplicationCapacityExceededException : Exception, ISerializable
Inheritance
DeduplicationCapacityExceededException
Implements
Inherited Members
Extension Methods

Remarks

This is a fail-closed signal: rather than admit an un-trackable message (which would risk dropping a real message or missing a later duplicate), the deduplicator throws so the message is not acknowledged and is redelivered once capacity is reclaimed by expiry or cleanup. Treat it as transient and retry-able. Initializes a new instance of the DeduplicationCapacityExceededException class.

Constructors

DeduplicationCapacityExceededException()

Initializes a new instance of the DeduplicationCapacityExceededException class.

public DeduplicationCapacityExceededException()

DeduplicationCapacityExceededException(int)

Initializes a new instance of the DeduplicationCapacityExceededException class for the given capacity.

public DeduplicationCapacityExceededException(int maxTrackedEntries)

Parameters

maxTrackedEntries int

The configured maximum number of tracked entries that was reached.

DeduplicationCapacityExceededException(string)

Transient exception thrown by an in-memory deduplicator when its tracking store is at capacity and a record-producing operation cannot be honored without silently skipping deduplication.

public DeduplicationCapacityExceededException(string message)

Parameters

message string

The exception message.

Remarks

This is a fail-closed signal: rather than admit an un-trackable message (which would risk dropping a real message or missing a later duplicate), the deduplicator throws so the message is not acknowledged and is redelivered once capacity is reclaimed by expiry or cleanup. Treat it as transient and retry-able. Initializes a new instance of the DeduplicationCapacityExceededException class.

DeduplicationCapacityExceededException(string?, Exception?)

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

public DeduplicationCapacityExceededException(string? message, Exception? innerException)

Parameters

message string

The exception message.

innerException Exception

The inner exception.

Remarks

The innerException parameter cannot be forwarded to the base Exception(string, Exception) constructor because the primary constructor locks the base call to Exception(message). This overload exists to satisfy the standard exception constructor pattern (CA1032).

Properties

MaxTrackedEntries

Gets the configured maximum number of tracked entries that was reached, when known.

public int? MaxTrackedEntries { get; }

Property Value

int?

The configured capacity cap, or null when not specified.