跳到主要内容
英文版本为准

本页译自英文,由模型翻译。若与英文原文存在差异,以英文原文为准。

Broker

处理器、路由器、编解码器和中间件都不依赖 Broker。把服务换到另一个 Broker,你只需要改 with_broker 里的一行。

框架自带一个完整的内存 Broker,用于单个应用内部的队列。基于外部服务的 Broker 是独立的 crate,加进 依赖即可使用。

每个 Broker crate 都有自己的文档站点,链接在下表的“文档”列和 Broker 菜单里。

BrokerCrate传输文档
内存ruststream(feature memory)进程内队列,无需外部服务本站
NATSruststream-natsCore NATS 与 JetStreampowersemmi.github.io/ruststream-nats
Redisruststream-fredRedis Streams(单机、集群、哨兵)powersemmi.github.io/ruststream-fred
RabbitMQruststream-lapinAMQP 0.9.1(队列、交换机、发布者确认、direct reply-to)powersemmi.github.io/ruststream-lapin
Kafkaruststream-rdkafkaApache Kafka(消费者组、提交跟踪、事务、精确一次管道)powersemmi.github.io/ruststream-rdkafka
AMQP 1.0ruststream-amqpActiveMQ Artemis、RabbitMQ 4.x、Azure Service Bus,以及更广泛的 AMQP 1.0 家族(请求-响应、事务)powersemmi.github.io/ruststream-amqp
Google Cloud Pub/Subruststream-gcp-pubsub基于官方客户端的 Pub/Sub(排序键、精确一次确认、死信策略)powersemmi.github.io/ruststream-gcp-pubsub
AWS SQS / SNSruststream-sqs-snsSQS 队列配合 SNS 扇出(FIFO 组、可见性管理、原生的延迟重试)powersemmi.github.io/ruststream-sqs-sns
Apache Pulsarruststream-pulsarPulsar 主题与主题模式(订阅模式、死信策略、重新定位)powersemmi.github.io/ruststream-pulsar
MQTT 5ruststream-rumqttcMQTT v5(QoS 等级、共享组、保留消息)powersemmi.github.io/ruststream-rumqttc
ZeroMQruststream-zeromq无 Broker 的 PUSH/PULL、PUB/SUB,以及基于 TCP 和 IPC 的 DEALER/ROUTER 请求-响应powersemmi.github.io/ruststream-zeromq
流文件 / stdioruststream-sea-file持久、可重放的流文件与 shell 管道;零基础设施,支持完整的重新定位powersemmi.github.io/ruststream-sea-file
AWS Kinesisruststream-kinesisKinesis 数据流(分片租约、检查点、重新定位)powersemmi.github.io/ruststream-kinesis
SQL 数据库ruststream-sqlx服务自有的 Postgres、MySQL/MariaDB 和 SQLite 表中的任务队列,以及基于任意 Broker 的事务性 outbox;SQL 语句在启动时或编译时检查powersemmi.github.io/ruststream-sqlx

要为别的传输实现 Broker,从 Broker trait 的文档读起:其中写明了 Broker crate 要实现的契约,以及检查该契约的一致性测试套件。

切换 Broker​

每个 Broker 都是同步构造的,运行时在应用启动时连接它。下面的例子里,只有构造 Broker 的那一行不同。

use ruststream::memory::MemoryBroker;
use ruststream::runtime::{AppInfo, RustStream};

#[ruststream::app]
fn app() -> RustStream {
RustStream::new(AppInfo::new("orders", "0.1.0"))
.with_broker(MemoryBroker::new(), |b| b.include_router(routes::orders()))
}

每个 Broker crate 在自己的文档里说明连接选项。订阅需要 Broker 专有的选项时(消费者组、 durable 名称),你可以在 #[subscriber(..)] 属性里给出该 Broker 的描述符;参见 Broker 专有的描述符。