StackExchange.Redis-中文使用文档

• 语言: 中文（简体）
• 格式: .pdf
• 来源: github.com/ningyu1

摘要

文档为StackExchange.Redis的中文使用指南，介绍该C#客户端的基本用法。核心对象为ConnectionMultiplexer，需共享重用，通过Connect方法连接Redis服务器（如本地默认端口6379）。支持同步、异步（Async后缀）及执行后不理（CommandFlags）三种操作模式。事务实现需结合WATCH/MULTI/EXEC命令，StackExchange.Redis提供Constraints抽象简化事务。键是数据唯一标识，影响路由；值存储内容，可被Redis转换处理。文档还涵盖配置、事件、管道、发布订阅、脚本、超时等章节。

AI总结

该文档是《StackExchange.Redis 中文使用文档》，主要内容如下：

**1. 背景介绍**
- **Redis**：基于内存、可选持久性的键值对存储数据库，由 ANSI C 编写，是最流行的键值对存储。
- **StackExchange.Redis**：由 Stackoverflow 开发的 .NET Redis 客户端，性能优越，是 .NET 应用中使用最广泛的 Redis 客户端。

**2. 核心对象与基本使用**
- **ConnectionMultiplexer**：核心类，隐藏多服务器细节，线程安全，应共享和重用，而非每次操作都创建。
- 创建方式：`ConnectionMultiplexer.Connect("localhost")` 或 `ConnectAsync`。
- 支持主/从设置，可通过逗号分隔指定多个节点。

**3. 三种使用机制**
- **同步**：操作完成后返回，虽可能阻塞调用者，但不阻塞其他线程。
- **异步**：返回 `Task` 或 `Task`，可使用 `await` 或 `.Wait()` 等待完成。
- **执行后不理**：不关心回复，通过可选参数 `CommandFlags` 实现。

**4. 事务实现**
- **Redis 层**：使用 `WATCH`、`MULTI`、`EXEC`、`UNWATCH` 实现事务，`WATCH` 监控键变化，变化则回滚。
- **StackExchange.Redis 层**：提供 `constraints` 抽象，通过 `AddCondition` 添加条件，自动处理 `WATCH` 和 `MULTI/EXEC`，避免并发混乱。

**5. 键与值的区别**
- **键**：数据的唯一名称，影响命令路由（尤其在集群中），通过 `RedisKey` 类型表示，可从 `string` 或 `byte[]` 隐式转换。
- **值**：键对应的内容，不影响路由，但可能被 Redis 解释（如 `incr` 将字符串转为数值）。
- **通道**：用于发布/订阅，不影响路由，与常规值不同。

**6. 文档目录**
涵盖基础、配置、事件、同步执行、键查找、键与值、管道与重用链接、分析、发布订阅顺序、脚本、超时、事务等内容。