Interface IRabbitMQDeadLetterBuilder
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
exchangestringThe DLX name.
Returns
- IRabbitMQDeadLetterBuilder
The builder for chaining.
Exceptions
- ArgumentException
Thrown when
exchangeis null or whitespace.
Queue(string)
Sets the dead letter queue name.
IRabbitMQDeadLetterBuilder Queue(string queue)
Parameters
queuestringThe DLQ name.
Returns
- IRabbitMQDeadLetterBuilder
The builder for chaining.
Exceptions
- ArgumentException
Thrown when
queueis null or whitespace.
RoutingKey(string)
Sets the routing key for dead letter messages.
IRabbitMQDeadLetterBuilder RoutingKey(string routingKey)
Parameters
routingKeystringThe routing key pattern.
Returns
- IRabbitMQDeadLetterBuilder
The builder for chaining.
Exceptions
- ArgumentNullException
Thrown when
routingKeyis null.