Rust Json 序列化重叠职责

我正在学习 Rust 中的 Json 序列化，特别是如何将 Rust 对象序列化为 Json。

目前我看到 3 种将结构体实例转换为 Json 的方法：

1. 派生可编码特征

2. 手动实现 ToJson 特征

3. 手动实现可编码特征

下面的代码说明了所有 3 种方法：

extern crate serialize;

use serialize::{Encoder, Encodable, json};
use serialize::json::{Json, ToJson};
use std::collections::TreeMap;

fn main() {
  let document = Document::new();
  let word_document = WordDocument::new();
  println!("1. Deriving `Encodable`: {}", json::encode(&document));
  println!("2. Manually implementing `ToJson` trait: {}", document.to_json());
  println!("3. Manually implementing `Encodable` trait: {}", json::encode(&word_document));
}

#[deriving(Encodable)]
struct Document<'a> {
  metadata: Vec<(&'a str, &'a str)>
}

impl<'a> Document<'a> {
  fn new() -> Document<'a> {
    let metadata = vec!(("Title", "Untitled Document 1"));
    Document {metadata: metadata}
  }
}

impl<'a> ToJson for Document<'a> {
  fn to_json(&self) -> Json {
    let mut tm = TreeMap::new();
    for &(ref mk, ref mv) in self.metadata.iter() {
      tm.insert(mk.to_string(), mv.to_string().to_json());
    }
    json::Object(tm)
  }
}

struct WordDocument<'a> {
  metadata: Vec<(&'a str, &'a str)>
}

impl<'a> WordDocument<'a> {
  fn new() -> WordDocument<'a> {
    let metadata = vec!(("Title", "Untitled Word Document 1"));
    WordDocument {metadata: metadata}
  }
}

impl<'a, E, S: Encoder<E>> Encodable<S, E> for WordDocument<'a> {
  fn encode(&self, s: &mut S) -> Result<(), E> {
    s.emit_map(self.metadata.len(), |e| {
      let mut i = 0;
      for &(ref key,  ref val) in self.metadata.iter() {
        try!(e.emit_map_elt_key(i, |e| key.encode(e)));
        try!(e.emit_map_elt_val(i, |e| val.encode(e)));
        i += 1;
      }
      Ok(())
    })
  }
}

生锈的婴儿围栏：http://is.gd/r7cYmE http://is.gd/r7cYmE

Results:

1. Deriving `Encodable`: {"metadata":[["Title","Untitled Document 1"]]}
2. Manually implementing `ToJson` trait: {"Title":"Untitled Document 1"}
3. Manually implementing `Encodable` trait: {"Title":"Untitled Word Document 1"}

第一种方法是全自动的，但没有提供足够的灵活性。 第二个和第三个通过手动指定序列化过程实现了相同级别的灵活性。就我而言，我希望将文档元数据序列化为对象，而不是数组（这是派生实现给我的）。

问题:

1. 为什么存在方法 2 和 3？我不明白它们之间重叠的原因。我希望只存在一种自动（派生）序列化方法和一种手动方法。

2. 如果我想要手动序列化，我应该选择哪种方法，为什么？

3. 我是否正确地假设方法 2 将构建一个Json内存中的枚举（除了结构体本身）并且更不适合大型文档（多兆字节），而方法 3 是流式传输并且对于大型文档更安全？

4. 为什么 rust stdlib 即使对于基元也使用方法 3，而在内部不使用方法 2？

为什么存在方法 2 和 3？我不明白它们之间重叠的原因。我希望只存在一种自动（派生）序列化方法和一种手动方法。

方法2（ToJsonTrait) 特定于 JSON 编码。它返回 JSON 对象，而不是写入流。一个使用示例是映射到自定义表示 - 请参阅这个例子 https://doc.rust-lang.org/1.0.0/serialize/json/#simple-example-of-tojson-usage在文档中。

方法3（实施Encodable) 必须存在才能使方法 1 起作用。

我是否正确地假设方法 2 将在内存中构建 Json 枚举（除了结构本身）并且更不适合大型文档（多兆字节），而方法 3 是流式传输并且对于大型文档更安全？

Yes. ToJson创建一个嵌套的Json整个对象的枚举，而Encodable流到一个Writer.

如果我想要手动序列化，我应该选择哪种方法，为什么？

为什么 rust stdlib 即使对于基元也使用方法 3，而在内部不使用方法 2？

你应该使用Encodable。它不是特定于 JSON 格式的，不使用中间表示（因此可以流式传输而不是存储在内存中），并且应该继续使用添加到库中的新格式。