返回资讯中心
外部精选
软件工程
#开发者实时流

Rust 中解析 JSON:为天气客户端实现反序列化

来源标题:A hard rain's a-gonna fall: parsing JSON in Rust

文章继续用 Rust 构建基础天气客户端,新增 deserialize 函数把 Weatherstack 返回的 JSON 转成 Rust 数据。作者将其与已完成的 request 函数分工,以便对 get_weather 进行可测试的拆分。

Hacker News 最新teleforce2026/11/16 · 2 天前27 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

「万千低语无人听。」 ——Bob Dylan,《A Hard Rain's a-Gonna Fall》

JSON 是最糟糕的数据格式,除了其他所有格式之外——但事已至此。这就是我们选择的生活,如果我们要写 Rust 程序去跟 Weatherstack 这样的远程 API 打交道(就像我们在《Here comes the sun》里做的那样),那就得能应付它们发回来的 JSON 数据。

我们还需要一种办法,把 JSON 转成规规矩矩的 Rust 数据,好在此基础上做计算。接下来就来看看怎么做,同时继续折腾我们这个简单得令人尴尬的天气客户端程序。

在《Elephants for breakfast》里,我们琢磨过怎么测试 get_weather 这样的函数——毕竟我们没法提前知道它会返回什么天气状况。正确答案 literally 飘在空中。

于是我们灵巧地把问题翻了个面——柔道劈掌!——改为编写两个可测试的函数:request,负责构造发往 Weatherstack 的 HTTP 请求;以及 deserialize,负责拆解返回的应答。

request 我们已经写好了——确切地说,是你写好的——顺便说一句,干得漂亮!现在轮到 deserialize 了。

我们计划在 get_weather 函数中这样调用它:

let weather = deserialize(&resp.text()?)?;

此时 API 请求已经发出,resp 中保存着响应,其中包含特定 JSON 格式的天气数据。

这里的含义是:如果把响应体作为 &str 传给 deserialize,就应该拿回一个 Weather 结构体,表示 JSON 中编码的天气状况。

这听起来是可以测试的,所以又轮到你来想办法了。

目标:按照下面的思路为 deserialize 写一个测试。

提示:我们在之前对 Weatherstack 做探索性请求时保存了真实的 JSON 数据(如果没有,就再请求一次)。那将是 deserialize 的完美测试数据:我们已经确切知道它编码了什么天气状况,所以只需把结果与对应的 Weather 结构体比对即可。

#[test]
fn deserialize_extracts_correct_weather_from_json() {
    let json = fs::read_to_string("tests/data/ws.json").unwrap();
    let weather = deserialize(&json).unwrap();
    assert_eq!(
        weather,
        Weather {
            temperature: 11.2,
            summary: "Sunny".into(),
        },
        "wrong weather"
    );
}

(Listing weather_2)

没必要测试 JSON 中其他内容的提取;我们根本不用它们,提取它们是浪费时间,测试提取更是如此。

我觉得你会同意,这很简单,那么接下来就看实际的提取了。我们要怎样把 &str 变成 Weather?

如果你读过我那本还算畅销的《The Secrets of Rust: Tools》,就会知道我们可以用 serde 库,通过 derive 属性来实现 Rust 结构体与 JSON 之间的序列化和反序列化。例如:

#[derive(Serialize, Deserialize)]
pub struct Memos {
    path: PathBuf,
    pub inner: Vec<Memo>,
}

通过派生 Serialize trait,我们让 serde 自动生成把 Memos 结构体转成(实际上)&str 的代码;而 Deserialize 自然就是做相反的事。

那么我们能不能在这里如法炮制?能不能定义一些 Rust 结构体,镜像 Weatherstack 返回的 JSON 数据的 schema,并在其上派生 Deserialize?

可以,这样做是可行的,但事实证明相当繁琐,因为 API 的 schema 由嵌套结构组成。我们得为所关心的每一层 JSON 都定义结构体。比如顶层,我们只想要 current:

"current": {
    ...
}
...

所以首先得定义一个表示整个响应的结构体,其中只有一个 current 字段(其他都可以忽略):

struct WSResponse {
    current: WSCurrent,
}

当然,现在又需要另一个结构体定义来表示 current 里面的内容:

struct WSCurrent {
    temperature: f64,
    weather_descriptions: Vec<String>,
}

这已经够烦人了,你可以想象,如果要处理 API 数据中更深层的嵌套,还得写更多这样的结构体。最糟糕的是,我们根本不想要这些结构体!比如程序里没有任何函数需要接收或返回 WSCurrent:我们已经有自己的 Weather 结构体,恰恰好只包含我们想要的数据。

这显然不是使用 Rust 类型系统的正确方式。我们更希望有一种办法,直接在 JSON 中查找想要的数据,然后转移到我们的 Weather 结构体里,而不必经过一堆无用的文书工作。

幸运的是,serde_json 提供了一种办法,使用一种叫做「JSON Pointer」的语法。首先,把数据反序列化成万能的 json::Value 类型:

use serde_json::Value;

let val: Value = serde_json::from_str(json)?;

假设我们成功得到了 val,那么它的内容就代表响应中包含的整个 JSON 对象。我们可以用类似路径的写法深入其中,抓取某个特定部分:

val.pointer("/current/temperature")

如果 JSON 中不存在这个路径,结果就会直接是 None。但我们可以相当确信服务器的响应会包含这些数据,所以结果会是 Some,其中包含另一个 json::Value,代表在给定路径上找到的内容。

那么现在就用这种「指针」方式来写 deserialize 吧:

fn deserialize(json: &str) -> Result<Weather> {
    let val: Value = serde_json::from_str(json)?;

    let temperature = val
        .pointer("/current/temperature")
        .and_then(Value::as_f64)
        .with_context(|| format!("bad response: {val}"))?;

    let summary = val
        .pointer("/current/weather_descriptions/0")
        .and_then(Value::as_str)
        .with_context(|| format!("bad response: {val}"))?
        .to_string();

    Ok(Weather {
        temperature,
        summary,
    })
}

(Listing weather_2)

这里我们加了一点额外的文书工作,以防查找失败:用 with_context 在返回合适错误信息的同时附上有问题的 JSON 数据。

不过假设查找成功,我们还需要把得到的 json::Value 转成真正的 Rust 类型:

.and_then(Value::as_f64)

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →