Table of Contents

Enum OutboxDeliveryGuarantee

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

Specifies the delivery guarantee level for outbox message processing.

public enum OutboxDeliveryGuarantee
Extension Methods

Fields

AtLeastOnce = 0

Batched completion with highest throughput and larger failure window.

Messages are read in batches, published, and then marked complete as a batch. If a failure occurs after publishing but before batch completion, all messages in the batch may be redelivered on restart.

Use when: High throughput is critical and handlers are idempotent.

Throughput: Highest (batch operations reduce database round-trips).

Failure window: Entire batch (could be 100+ messages).

MinimizedWindow = 1

Individual completion with lower throughput and smaller failure window.

Each message is marked complete immediately after successful publish. If a failure occurs, only the current message may be redelivered.

Use when: Minimizing duplicate deliveries is more important than throughput.

Throughput: Lower (one database round-trip per message).

Failure window: Single message.

Remarks

This enum controls how the outbox processor handles message completion and the trade-offs between throughput, failure window, and delivery guarantees.

Throughput vs. Failure Window Trade-off: Higher throughput modes batch operations but increase the window during which failures could cause message redelivery. Lower throughput modes complete messages individually for tighter guarantees.