Struct RabbitMqProvider 

pub struct RabbitMqProvider { /* private fields */ }

RabbitMQ queue provider using AMQP 0-9-1 via the lapin crate.

All queues are declared as durable on first use. Messages are published with delivery_mode = 2 (persistent) so they survive broker restarts.

The provider emulates visibility timeouts by keeping in-flight messages in an unacked state on the AMQP broker. If the application crashes before calling [complete_message] or [abandon_message], the AMQP broker will redeliver the message once the connection is dropped.

Channel Strategy

A single persistent AMQP channel is reused for all publish operations and a second for all receive operations instead of opening a new channel per call. Both channels are recreated transparently if the broker closes them. This keeps the channel count bounded regardless of message throughput and avoids exhausting the broker’s per-connection channel limit.

Implementations

impl RabbitMqProvider

pub async fn new(config: RabbitMqConfig) -> Result<Self, RabbitMqError>

Create a new RabbitMqProvider and establish an AMQP connection.

Errors

Returns RabbitMqError if the AMQP connection cannot be established or if the URL is malformed.

Examples

use queue_runtime::providers::RabbitMqProvider;
use queue_runtime::RabbitMqConfig;

let config = RabbitMqConfig::default();
let provider = RabbitMqProvider::new(config).await.unwrap();

Trait Implementations

impl QueueProvider for RabbitMqProvider

fn send_message<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, queue: &'life1 QueueName, message: &'life2 Message, ) -> Pin<Box<dyn Future<Output = Result<MessageId, QueueError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Send single message

fn send_messages<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, queue: &'life1 QueueName, messages: &'life2 [Message], ) -> Pin<Box<dyn Future<Output = Result<Vec<MessageId>, QueueError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Send multiple messages

fn receive_message<'life0, 'life1, 'async_trait>( &'life0 self, queue: &'life1 QueueName, timeout: Duration, ) -> Pin<Box<dyn Future<Output = Result<Option<ReceivedMessage>, QueueError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Receive single message

fn receive_messages<'life0, 'life1, 'async_trait>( &'life0 self, queue: &'life1 QueueName, max_messages: u32, timeout: Duration, ) -> Pin<Box<dyn Future<Output = Result<Vec<ReceivedMessage>, QueueError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Receive multiple messages

fn complete_message<'life0, 'life1, 'async_trait>( &'life0 self, receipt: &'life1 ReceiptHandle, ) -> Pin<Box<dyn Future<Output = Result<(), QueueError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Complete message processing

fn abandon_message<'life0, 'life1, 'async_trait>( &'life0 self, receipt: &'life1 ReceiptHandle, ) -> Pin<Box<dyn Future<Output = Result<(), QueueError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Abandon message for retry

fn dead_letter_message<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, receipt: &'life1 ReceiptHandle, reason: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<(), QueueError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Send to dead letter queue

fn create_session_client<'life0, 'life1, 'async_trait>( &'life0 self, queue: &'life1 QueueName, session_id: Option<SessionId>, ) -> Pin<Box<dyn Future<Output = Result<Box<dyn SessionProvider>, QueueError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Create session client

fn provider_type(&self) -> ProviderType

Get provider type

fn supports_sessions(&self) -> SessionSupport

Get session support level

fn supports_batching(&self) -> bool

Check batch operation support

fn max_batch_size(&self) -> u32

Get maximum batch size