Expand description
wordval-nats:面向服务间通信的 NATS 消息队列集成。
提供高层级的 NatsClient 封装,涵盖发布/订阅、请求-响应、
队列组负载均衡与 JetStream 持久化。NatsPlugin 实现了
wordval_core::Plugin trait 用于生命周期管理,全局资源访问器
(nats() / try_nats())遵循 wordval 单例模式
(可安全重启,与 wordval_bus::bus() 一致)。
§快速开始
ⓘ
use wordval_nats::nats;
// 发布消息
nats().publish_json("game.auth.login", &serde_json::json!({
"username": "alice",
"password": "secret",
})).await?;
// 订阅
let mut sub = nats().subscribe("game.chat.lobby").await?;Re-exports§
pub use error::NatsError;
Modules§
- error
- NATS 操作错误。
Structs§
- Message
- A Core NATS message.
- Nats
Client - 高层封装
async_nats::Client,同时持有一个可选的 JetStream 上下文, 用于持久化 / 至少一次(at-least-once)发布。 - Nats
Plugin - 管理 NATS 客户端连接生命周期的 NATS 插件。
- Publish
Ack PublishAckis an acknowledgment received after successfully publishing a message.- Publish
AckFuture - Subject
- A
Subjectis an immutable string type that guarantees valid UTF-8 contents. - Subscriber
- Retrieves messages from given
subscriptioncreated by Client::subscribe.
Traits§
Functions§
- nats
- 返回全局
NatsClient。 - try_
nats - 返回全局
NatsClient的Some,未初始化时返回None。