Rust で JSON フォーマットを扱う (serde)

$ cargo add serde --features=derive
$ cargo add serde_json  # データフォーマットとして JSON を使う場合

[dependencies]
serde = { version = "1.0.152", features = ["derive"] }
serde_json = "1.0.91"

use serde::{Deserialize, Serialize};

#[derive(Serialize, Deserialize)]
struct Book {
    id: i32,
    title: String,
}

fn main() {
    // シリアライズ (構造体 → JSON 文字列)
    // 整形したいときは to_string の代わりに to_string_pretty を使えば OK
    let book = Book { id: 1, title: String::from("Title-1") };
    let json = serde_json::to_string(&book).unwrap();
    println!("{}", json); //=> {"id":1,"title":"Title-1"}

    // デシリアライズ (JSON 文字列 → 構造体)
    let json = r#"{"id":2, "title":"Title-2"}"#;
    let book: Book = serde_json::from_str(json).unwrap();
    println!("{}, {}", book.id, book.title); //=> 2, Title-2
}

use std::{error::Error, fs::File, path::Path};
use serde::{Deserialize, Serialize};

#[derive(Serialize, Deserialize)]
struct Book {
    id: i32,
    title: String,
}

fn save_book_to_json_file<P: AsRef<Path>>(path: P, book: &Book) -> Result<(), Box<dyn Error>> {
    let file = File::create(path)?; // std::io::Error の可能性
    serde_json::to_writer_pretty(file, book)?; // serde_json::Error の可能性
    Ok(())
}

fn main() {
    let book = Book { id: 1, title: String::from("Title-1") };
    match save_book_to_json_file("book.json", &book) {
        Ok(_) => println!("JSON ファイルへの保存に成功しました"),
        Err(err) => eprintln!("JSON ファイルへの保存に失敗しました: {}", err),
    }
}

use std::{error::Error, fs::File, io::BufReader, path::Path};
use serde::{Deserialize, Serialize};

#[derive(Serialize, Deserialize)]
struct Book {
    id: i32,
    title: String,
}

fn load_book_from_json_file<P: AsRef<Path>>(path: P) -> Result<Book, Box<dyn Error>> {
    let file = File::open(path)?; // std::io::Error の可能性
    let reader = BufReader::new(file); // 読み込み時は明示的にバッファリング
    let book = serde_json::from_reader(reader)?; // serde_json::Error の可能性
    Ok(book)
}

fn main() {
    match load_book_from_json_file("book.json") {
        Ok(book) => {
            println!("JSON ファイルの読み込みに成功しました");
            println!("内容: {}, {}", book.id, book.title);
        }
        Err(err) => eprintln!("JSON ファイルの読み込みに失敗しました: {}", err),
    }
}

#[derive(Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
struct User {
    avatar_url: String,  // JSON フィールド名は "avatarUrl" になる
    website_url: String, // JSON フィールド名は "websiteUrl" になる
}

#[derive(Serialize, Deserialize)]
struct User {
    #[serde(rename = "id")]
    user_id: String,
    // ...
}

#[derive(Serialize, Deserialize)]
struct User {
    #[serde(alias = "id", alias = "ID", alias = "userId")]
    user_id: String,
    // ...
}

#[derive(Serialize, Deserialize)]
#[serde(deny_unknown_fields)]
struct Book {
    // ...
}

#[derive(Serialize, Deserialize)]
struct Book {
    id: i32,
    title: Option<String>,
}

{
  "id": 1,
  "title": null
}

{
  "id": 1
}

#[derive(Serialize, Deserialize)]
struct Book {
    id: i32,
    #[serde(default)]
    title: String,
}

[
  { "title": "Final Fantasy", "genre": "RPG" },
  { "title": "Sqoon", "genre": "STG", "price": 4900 },
  { "title": "Gimmick", "note": "プレミア価格" }
]

use serde_json::Value;
use std::fs::File;
use std::io::BufReader;

// games.json を読み込んで Value 型で返す
fn load_games() -> Value {
    let file = File::open("games.json").expect("ファイルが開けませんでした。");
    let reader = BufReader::new(file);
    serde_json::from_reader(reader).expect("JSON の解析に失敗しました。")
}

fn main() {
    let games_json: Value = load_games();

    // JSON 全体は配列なので Value::Array として参照する
    if let Value::Array(games) = &games_json {
        for game in games {
            // 個々の要素は Value::Object として取り出す
            for (key, value) in game.as_object().unwrap() {
                println!("{}: {}", key, value);
            }
            println!("--------------------");
        }
    } else {
        println!("JSON のルート要素は配列でなければいけません。");
    }
}

$ cargo run -q
genre: "RPG"
title: "Final Fantasy"
--------------------
genre: "STG"
price: 4900
title: "Sqoon"
--------------------
note: "プレミア価格"
title: "Gimmick"
--------------------