Value 表示法对于非常基本的任务来说是足够的，但处理任何更重要的任务都可能很麻烦。错误处理实现起来很冗长，例如，想象一下尝试检测输入数据中存在未知字段的情况。当你犯错时，编译器无法帮助你，例如，想象一下在代码中几十个地方不小心将 v["name"] 错误地写成 v["nmae"]。

将JSON解析为强类型数据结构

Serde提供了一种强大的方法，可以将JSON数据自动映射到Rust数据结构。

use serde::{Deserialize, Serialize};
use serde_json::Result;

#[derive(Serialize, Deserialize)]
struct Person {
    name: String,
    age: u8,
    phones: Vec<String>,
}

fn typed_example() -> Result<()> {
    // Some JSON input data as a &str. Maybe this comes from the user.
    let data = r#"
        {
            "name": "John Doe",
            "age": 43,
            "phones": [
                "+44 1234567",
                "+44 2345678"
            ]
        }"#;

    // Parse the string of data into a Person object. This is exactly the
    // same function as the one that produced serde_json::Value above, but
    // now we are asking it for a Person as output.
    let p: Person = serde_json::from_str(data)?;

    // Do things just like with any other Rust data structure.
    println!("Please call {} at the number {}", p.name, p.phones[0]);

    Ok(())
}
#

这与之前相同的 serde_json::from_str 函数，但这次我们将返回值赋给一个类型为 Person 的变量，因此Serde将自动将输入数据解释为 Person，并在布局不符合预期的 Person 时产生有意义的错误信息。

任何实现了 Serde 的 Deserialize 特性的类型都可以用这种方式反序列化。这包括 Rust 标准库中的内置类型，如 Vec<T> 和 HashMap<K, V>，以及任何带有 #[derive(Deserialize)] 注解的结构体或枚举。

一旦我们有了 p 类型的 Person，我们的 IDE 和 Rust 编译器可以帮助我们正确地使用它，就像对其他 Rust 代码那样。IDE 可以自动完成字段名以防止拼写错误，这在 serde_json::Value 表示中是不可能的。Rust 编译器还可以检查当我们编写 p.phones[0] 时，p.phones 被保证是一个 Vec<String>，因此索引它是有意义的，并生成一个 String。

构建 JSON 值

Serde JSON 提供了一个 json! 宏，用于用非常自然的 JSON 语法构建 serde_json::Value 对象。

use serde_json::json;

fn main() {
    // The type of `john` is `serde_json::Value`
    let john = json!({
        "name": "John Doe",
        "age": 43,
        "phones": [
            "+44 1234567",
            "+44 2345678"
        ]
    });

    println!("first phone number: {}", john["phones"][0]);

    // Convert to a string of JSON and print it out
    println!("{}", john.to_string());
}

Value::to_string() 函数将一个 serde_json::Value 转换为一个 JSON 文本的 String。

json! 宏的一个好处是，变量和表达式可以直接在构建 JSON 值时插入。Serde 会检查在编译时你插入的值是否能够表示为 JSON。

#
#
let full_name = "John Doe";
let age_last_year = 42;

// The type of `john` is `serde_json::Value`
let john = json!({
    "name": full_name,
    "age": age_last_year + 1,
    "phones": [
        format!("+44 {}", random_phone())
    ]
});

这非常方便，但我们遇到了之前在 Value 上遇到的问题，即 IDE 和 Rust 编译器无法帮助我们纠正错误。Serde JSON 提供了一种将强类型数据结构序列化为 JSON 文本的好方法。

通过序列化数据结构创建 JSON

可以使用 serde_json::to_string 将数据结构转换为 JSON 字符串。还有一个 serde_json::to_vec，它将序列化为 Vec<u8>，以及 serde_json::to_writer，它将序列化到任何 io::Write，例如文件或 TCP 流。

use serde::{Deserialize, Serialize};
use serde_json::Result;

#[derive(Serialize, Deserialize)]
struct Address {
    street: String,
    city: String,
}

fn print_an_address() -> Result<()> {
    // Some data structure.
    let address = Address {
        street: "10 Downing Street".to_owned(),
        city: "London".to_owned(),
    };

    // Serialize it to a JSON string.
    let j = serde_json::to_string(&address)?;

    // Print, write to a file, or send to an HTTP server.
    println!("{}", j);

    Ok(())
}
#

任何实现了 Serde 的 Serialize 特性的类型都可以以这种方式进行序列化。这包括 Rust 标准库的内置类型，如 Vec<T> 和 HashMap<K, V>，以及任何带有 #[derive(Serialize)] 注解的结构体或枚举。

无标准库支持

此软件包目前需要 Rust 标准库。有关在无标准库的情况下使用 Serde 的 JSON 支持，请参阅 serde-json-core 软件包。