Skip to main content

Crate wordval_nats

Crate wordval_nats 

Source
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.
NatsClient
高层封装 async_nats::Client,同时持有一个可选的 JetStream 上下文, 用于持久化 / 至少一次(at-least-once)发布。
NatsPlugin
管理 NATS 客户端连接生命周期的 NATS 插件。
PublishAck
PublishAck is an acknowledgment received after successfully publishing a message.
PublishAckFuture
Subject
A Subject is an immutable string type that guarantees valid UTF-8 contents.
Subscriber
Retrieves messages from given subscription created by Client::subscribe.

Traits§

ToSubject

Functions§

nats
返回全局 NatsClient。
try_nats
返回全局 NatsClient 的 Some,未初始化时返回 None。