Redis-rs 用于 Rust：完整指南及示例

什么是 Redis-rs，为什么需要它？

\n\n

Redis-rs 是一个用 Rust 语言编写的 Redis 异步和同步客户端。它是 Rust 生态系统中用于操作 Redis 的最流行且维护最活跃的库之一。它提供了一个方便、安全且高性能的接口，用于与 Redis 服务器交互。

\n\n

为什么需要 Redis-rs？

\n

\n
• 高性能： Rust 以其速度和内存安全性著称。Redis-rs 继承了这些特性，确保与 Redis 交互时开销最小。
\n
• 异步性： 该库最初设计用于与异步运行时（如 Tokio 和 async-std）配合使用，从而能够在不阻塞线程的情况下处理数千个连接。
\n
• 类型安全： Rust 严格的类型系统有助于在编译阶段避免许多错误。Redis-rs 利用这一优势，提供类型化的命令。
\n
• 支持集群和复制： 该库支持 Redis 集群操作、自动请求重定向以及副本操作。
\n
• 活跃的社区： Redis-rs 拥有庞大的开发者群体，定期更新且文档完善。
\n

\n\n

该库非常适合构建高负载 Web 应用程序、缓存系统、消息队列、会话存储以及任何需要通过 Redis 快速访问数据的项目。

\n\n

安装 Redis-rs

\n\n

要将 Redis-rs 安装到您的 Rust 项目中，请在 Cargo.toml 文件中添加依赖项：

\n\n

[dependencies]\nredis = "0.27.0"  # 请在 crates.io 上查看最新版本\ntokio = { version = "1.0", features = ["full"] }  # 用于异步执行\n

\n\n

然后执行命令：

\n\n

cargo build

\n\n

如果您计划使用同步客户端，则不需要 Tokio，但对于异步客户端，它是必需的。

\n\n

快速入门及代码示例

\n\n

让我们编写一个简单的程序，连接到 Redis，写入一个值，然后读取它。

\n\n

use redis::AsyncCommands;\nuse tokio;\n\n#[tokio::main]\nasync fn main() -> redis::RedisResult<()> {\n    // 建立与 Redis 服务器的连接\n    let client = redis::Client::open("redis://127.0.0.1:6379/")?;\n    let mut con = client.get_async_connection().await?;\n\n    // 设置键 "hello" 的值为 "world"\n    con.set("hello", "world").await?;\n\n    // 获取键 "hello" 的值\n    let value: String = con.get("hello").await?;\n    println!("键 'hello' 的值: {}", value);\n\n    Ok(())\n}\n

\n\n

这个示例展示了 Redis-rs 的基本操作：连接、写入和读取数据。请注意使用了 #[tokio::main]——这是一个宏，用于启动 Tokio 异步运行时。

\n\n

Redis-rs 的主要方法和函数

\n\n

让我们看看 10 个最常用的方法。所有示例都假设您有一个通过 client.get_async_connection().await? 获取的异步连接 con。

\n\n

1. set() — 设置值

\n

描述： 为指定的键设置值。如果键已存在，则覆盖该值。

\n

参数：

\n

\n
• key: K — 键（任何实现了 ToRedisArgs 的类型）
\n
• value: V — 值（任何实现了 ToRedisArgs 的类型）
\n

\n

示例：

\n

con.set("user:1:name", "Alice").await?;\ncon.set("counter", 42).await?;

\n\n

2. get() — 获取值

\n

描述： 根据指定的键获取值。返回