Table of Contents

Interface IRabbitMQDeadLetterBuilder

Namespace
Excalibur.Dispatch.Transport.RabbitMQ
Assembly
Excalibur.Dispatch.Transport.RabbitMQ.dll

Fluent builder interface for configuring RabbitMQ dead letter exchange (DLX) handling.

public interface IRabbitMQDeadLetterBuilder
Extension Methods

Examples

rmq.ConfigureDeadLetter(dlx =>
{
    dlx.Exchange("dead-letters")
       .Queue("dead-letter-queue")
       .RoutingKey("#");
});

Remarks

Access this builder through ConfigureDeadLetter(Action<IRabbitMQDeadLetterBuilder>).

Dead letter exchanges receive messages that cannot be delivered or processed:

  • Messages rejected (basic.reject or basic.nack) with requeue=false
  • Messages that exceed TTL
  • Messages that exceed queue length limits

Methods

Exchange(string)

Sets the dead letter exchange name.

IRabbitMQDeadLetterBuilder Exchange(string exchange)

Parameters

exchange string

The DLX name.

Returns

IRabbitMQDeadLetterBuilder

The builder for chaining.

Exceptions

ArgumentException

Thrown when exchange is null or whitespace.

Queue(string)

Sets the dead letter queue name.

IRabbitMQDeadLetterBuilder Queue(string queue)

Parameters

queue string

The DLQ name.

Returns

IRabbitMQDeadLetterBuilder

The builder for chaining.

Exceptions

ArgumentException

Thrown when queue is null or whitespace.

RoutingKey(string)

Sets the routing key for dead letter messages.

IRabbitMQDeadLetterBuilder RoutingKey(string routingKey)

Parameters

routingKey string

The routing key pattern.

Returns

IRabbitMQDeadLetterBuilder

The builder for chaining.

Exceptions

ArgumentNullException

Thrown when routingKey is null.