Skip to main content

Crate nadis

Crate nadis 

Source
Expand description

Redis 客户端、分布式锁、管线、发布订阅和分区消费基础层。

分区消费通过 Redis 租约与 PEL 完成持久接管,由实例独占的 napart Runner 集合执行业务键有序任务。 本地调度支持 source、group、stream 隔离,跨执行域的同计划同业务键仍保持顺序屏障。 成功业务与 ACK 分离,未知确认保留提交责任;源级总预算覆盖读取、执行、重试和发布, group/stream 将消费容量划为固定域份额,跨域不借用;发布仍使用源级独立预算。 正常停机报告未收敛时可以继续等待同一操作,显式强停才请求有损中止。

业务通常通过 nasa::redis 门面接入;本 crate 承载单点/集群 Redis 的类型化命令、 连接治理和分布式协作能力。

§普通消费与命令微批

Stream、共享组 Proxy 与 AutoPipeline 各自持有可等待的关闭 owner,也可交给 Application 按命名计划管理。Service 的消费与发送入口和宿主终端共用启动许可,关键任务责任在发布前 受本地状态保护;Batch 仅支持命名 Pipeline。普通 Stream 组模式的 on_success 在 handler 失败时保留 PEL,不自动重投;Proxy 清理必须有完整 pending 证据,排干与清理共用截止点。 它们不提供分区消费的业务键顺序。

受管微批限制已接纳命令参数字节,单批软上限 B 与单命令上限 M 给出 B+M 的保守边界, 不包含响应、编码和等待调用者的内存。未知写入结果不会自动重放;取消等待不等于任务已经退出。 本地处理次数与任务存活不证明远端 PEL、业务成功或 Redis 可达。

Re-exports§

pub use client::RedisClient;
pub use client::RedisRegistry;
pub use codec::Json;
pub use commands::KeyTtl;
pub use config::CompatibilityProfile;
pub use config::PartitionGroupCfg;
pub use config::RedisConfig;
pub use error::NasaRedisError;
pub use idempotent::IdempotentCounterCfg;
pub use idempotent::IdempotentCounterError;
pub use idempotent::IdempotentCounterSnapshot;
pub use idempotent::IdempotentPipelineSession;
pub use idempotent::IdempotentRejection;
pub use idempotent::IdempotentTicket;
pub use idempotent::IdempotentTtlMode;
pub use error::Result;
pub use keytag::effective_tag;
pub use keytag::redis_slot;
pub use keytag::synthetic_tag;
pub use leader::Leader;
pub use lock::DistributedLock;
pub use lock::HoldStatus;
pub use lock::LockGuard;
pub use partition::compat_double_to_string;
pub use partition::compat_long_hash;
pub use partition::compat_string_hash;
pub use partition::route_i64;
pub use partition::route_str;
pub use partition::ExecutionDomainSnapshot;
pub use partition::PartitionExecutorCfg;
pub use partition::PartitionExecutorScope;
pub use partition::PartitionLimits;
pub use partition::PartitionRecord;
pub use partition::PartitionShutdownReport;
pub use partition::PartitionSnapshot;
pub use partition::PreparedPartition;
pub use partition::PublisherSnapshot;
pub use partition::RecordIdentity;
pub use partition::RunningPartition;
pub use pipeline::AutoPipeline;
pub use pipeline::MicroBatchCfg;
pub use pipeline::PipelineSession;
pub use pipeline::Ticket;
pub use proxy::PreparedProxy;
pub use proxy::ProxyCfg;
pub use proxy::ProxyPoison;
pub use proxy::ProxyStartOffset;
pub use proxy::RunningProxy;
pub use pubsub::Message;
pub use pubsub::Subscription;
pub use snowflake::SnowflakeConfig;
pub use snowflake::WorkerIdLease;
pub use stream::StreamAckPolicy;
pub use stream::StreamEntry;
pub use stream::StreamEnvelope;
pub use stream::StreamEvent;
pub use stream::StreamField;
pub use stream::StreamGroupStart;
pub use stream::StreamMode;
pub use stream::StreamPublishItem;
pub use stream::StreamStart;
pub use stream::StreamSubscribeCfg;
pub use stream::StreamSubscriber;
pub use stream::StreamSubscription;
pub use stream::StreamTypedEvent;
pub use stream::STREAM_EVENT;

Modules§

client
Redis 连接建立、拓扑识别和统一执行入口。
codec
Redis 值序列化包装类型。
commands
类型化 Redis 命令集合。 类型化 Redis 命令层,统一计时、连接与错误语义。
config
Redis 连接、命令、锁、stream 和 partition 配置。
error
Redis 组件统一错误类型。
idempotent
nonce 幂等计数:String/Hash/ZSet 计数的 nonce 窗口幂等,账本身份为稳定线协议。 nonce 幂等计数:为 String、Hash、ZSet 计数提供 nonce 窗口幂等,一段 Lua 同时完成判重、计数与凭证登记。
keytag
Redis Cluster hash tag 与 slot 计算工具。 按 Redis 字节级 hash tag 规则计算 Cluster slot,并为任意源键派生同槽辅助键。
leader
基于分布式锁的 leader 选举辅助。 基于 DistributedLock 的 Redis 租约选举;持有约定锁的节点在本地发布领导权。
lock
Redis 分布式锁与本地重入守卫。
partition
基于 Redis Stream 的分区消费、重平衡和处置控制。 Redis Stream 分区消费:来源租约、不可变计划、业务键顺序与独立确认责任。
pipeline
显式 pipeline、typed ticket 和自动微批管线。
proxy
Redis Stream 代理消费运行时。
pubsub
Redis pub/sub 订阅和发布封装。
snowflake
雪花 ID 生成器:纯算法 Snowflake 与显式初始化、永久不复用 workerId 的 Redis 账本。 Snowflake workerId 的显式分配边界。
stream
普通 stream(event-field wire)的 publish/subscribe。

Structs§

RedisCommand
自动微批调用使用的 Redis 命令与类型化响应转换合同。 Represents redis commands.
RedisTaskObservation
当前领域 owner 的本地责任快照;各数量不代表 Redis 的持久消息总数。
Snowflake
纯本地雪花 ID 生成器。

Enums§

SnowflakeError
雪花生成器错误。

Traits§

FromRedisValue
自动微批调用使用的 Redis 命令与类型化响应转换合同。 This trait is used to convert a redis value into a more appropriate type.