引言
在现代 Web 开发中，发送 HTTP 请求和处理 JSON 数据是非常常见的需求。本文将介绍如何在 Rust 中使用 reqwest 库来实现这些功能，并通过一个具体的示例来展示异步编程的优雅之处。
准备工作
首先，我们需要在 Cargo.toml 中添加必要的依赖：
[dependencies]
reqwest = { version = "0.12.9", features = ["json"] } # HTTP 客户端库
serde = { version = "1.0.215", features = ["derive"] } # JSON 序列化/反序列化库
tokio = { version = "1.42.0", features = ["full"] } # 异步运行时
代码实现
让我们通过一个实际的例子来学习。我们将使用 Dog API（https://dog.ceo/api/breeds/image/random）来获取随机狗狗图片的 URL。
首先，定义响应数据结构：
use serde::Deserialize;
#[derive(Deserialize, Debug)]
struct ImageResponse {
message: String, // 图片 URL
status: String, // 响应状态
}
实现主要逻辑：
#[tokio::main]
async fn main() {
// 发送 GET 请求并获取响应
let response = reqwest::get("https://dog.ceo/api/breeds/image/random")
.await
.unwrap();
// 将响应解析为 ImageResponse 结构体
let image: ImageResponse = response.json().await.unwrap();
// 打印结果
println!("获取到的图片信息：{:?}", image);
}
代码解析
#[tokio::main]：这个属性宏使我们能够在 main 函数中使用异步代码。reqwest::get()：发送 GET 请求，返回一个 Future。.await：等待异步操作完成。.json()：将响应体解析为指定的结构体类型。
进阶用法
如果你需要处理错误，可以使用更健壮的写法：
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
// 发送请求并处理可能的错误
let response = reqwest::get("https://dog.ceo/api/breeds/image/random")
.await?;
// 解析 JSON 响应
let image: ImageResponse = response.json().await?;
println!("图片 URL: {}", image.message);
println!("状态: {}", image.status);
Ok(())
}
总结
通过本文，我们学习了：
如何使用 reqwest 发送 HTTP 请求 如何使用 serde 处理 JSON 数据 如何在 Rust 中进行异步编程 错误处理的最佳实践
这些知识点是构建现代 Web 应用的基础。reqwest 库的设计非常符合 Rust 的哲学，既保证了安全性，又提供了良好的开发体验。
参考文章
Rust Reqwest 官方文档：https://docs.rs/reqwest/latest/reqwest/ Rust 异步编程指南：https://rust-lang.github.io/async-book/ Serde JSON 文档：https://docs.serde.rs/serde_json/
书籍推荐
各位 Rust 爱好者，今天为大家介绍一本《Programming Rust: Fast, Safe Systems Development》(第二版) 是由 Jim Blandy、Jason Orendorff 和 Leonora Tindall 合著的 Rust 编程指南。本书深入探讨了 Rust 语言在系统编程中的应用，着重介绍如何利用 Rust 的独特特性来平衡性能和安全性。书中涵盖了 Rust 的基础数据类型、所有权和借用概念、特征和泛型、并发编程、闭包、迭代器以及异步编程等核心内容。这本更新版基于 Rust 2021 版本，为系统程序员提供了全面而实用的 Rust 编程指导。
