Lib.rs

Rust AMQP 客户端库。

此项目遵循 AMQP 0.9.1 规范，特别针对 RabbitMQ。

功能开关

• codegen：生成代码而不是使用预生成的代码
• native-tls：通过 native-tls 启用 amqps 支持（当设置时优先于 rustls）
• openssl：通过 openssl 启用 amqps 支持（当设置时优先于 rustls）
• rustls (默认)：通过 rustls 启用 amqps 支持（默认使用 rustls-native-certs）
• rustls-native-certs：与 rustls 相同，确保即使 rustls 的默认设置更改，我们仍然会使用 rustls-native-certs
• rustls-webpki-roots-certs：与 rustls 相同，但使用 webkit-roots 代替 rustls-native-certs

与第三方运行时的集成

lapin 可以通过将运行时传递给 ConnectionProperties 来使用您选择的任何运行时。

您可以通过 executor-trait 配置要使用的执行器。

您可以通过 reactor-trait 配置要使用的反应器。

有 tokio、async-std 等实现。

示例

use futures_lite::stream::StreamExt;
use lapin::{
    options::*, publisher_confirm::Confirmation, types::FieldTable, BasicProperties, Connection,
    ConnectionProperties, Result,
};
use tracing::info;

fn main() -> Result<()> {
    if std::env::var("RUST_LOG").is_err() {
        std::env::set_var("RUST_LOG", "info");
    }

    tracing_subscriber::fmt::init();

    let addr = std::env::var("AMQP_ADDR").unwrap_or_else(|_| "amqp://127.0.0.1:5672/%2f".into());

    async_global_executor::block_on(async {
        let conn = Connection::connect(
            &addr,
            ConnectionProperties::default(),
        )
        .await?;

        info!("CONNECTED");

        let channel_a = conn.create_channel().await?;
        let channel_b = conn.create_channel().await?;

        let queue = channel_a
            .queue_declare(
                "hello",
                QueueDeclareOptions::default(),
                FieldTable::default(),
            )
            .await?;

        info!(?queue, "Declared queue");

        let mut consumer = channel_b
            .basic_consume(
                "hello",
                "my_consumer",
                BasicConsumeOptions::default(),
                FieldTable::default(),
            )
            .await?;
        async_global_executor::spawn(async move {
            info!("will consume");
            while let Some(delivery) = consumer.next().await {
                let delivery = delivery.expect("error in consumer");
                delivery
                    .ack(BasicAckOptions::default())
                    .await
                    .expect("ack");
            }
        }).detach();

        let payload = b"Hello world!";

        loop {
            let confirm = channel_a
                .basic_publish(
                    "",
                    "hello",
                    BasicPublishOptions::default(),
                    payload,
                    BasicProperties::default(),
                )
                .await?
                .await?;
            assert_eq!(confirm, Confirmation::NotRequested);
        }
    })
}