JSON to Rust 構造体コンバーター

JSON to Rust 変換とは？

サンプル

{"id":101,"name":"Ada Lovelace","email":"ada@example.com","active":true,"roles":["admin","user"]}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub id: i64,
    pub name: String,
    pub email: String,
    pub active: bool,
    pub roles: Vec<String>,
}

{"repo":"serde","owner":{"login":"dtolnay","id":100}}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub repo: String,
    pub owner: Owner,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Owner {
    pub login: String,
    pub id: i64,
}

{"users":[{"id":1,"nick":"x"},{"id":2}]}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub users: Vec<User>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct User {
    pub id: i64,
    pub nick: Option<String>,
}

{"login":"octocat","publicRepos":15,"followerCount":9001,"createdAt":"2011-01-25"}

use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Root {
    pub login: String,
    #[serde(rename = "publicRepos")]
    pub public_repos: i64,
    #[serde(rename = "followerCount")]
    pub follower_count: i64,
    #[serde(rename = "createdAt")]
    pub created_at: String,
}

JSONをRustに変換する方法

1. 1

   JSONを貼り付ける

   JSONオブジェクト・配列・APIレスポンスを入力欄に入れてください。変換は即座に始まります。

2. 2

   出力を調整する

   ルート構造体の名前を変更し、serde derive、DebugとClone、pubの可視性を切り替えて、あなたのcrateのスタイルに合わせてください。

3. 3

   コピーまたはダウンロード

   生成されたRustをワンクリックで取得し、プロジェクトにそのまま貼り付けてください。

Common Use Cases

型付きAPIクライアント

RESTやGraphQLのレスポンスサンプルを、reqwestや同様のクライアント向けのserde構造体に変換します。デシリアライズのボイラープレートを手書きする必要はありません。

設定やフィクスチャの解析

serde_jsonでデシリアライズする必要のあるJSON設定ファイル、テストフィクスチャ、Webhookペイロードの構造体を生成します。

高速なプロトタイピング

見慣れないペイロードを貼り付けると、その形状がRustの型として即座に表示されます — 接続する前に新しいAPIを素早く探索する方法です。

変換の仕組み

構造推論

各オブジェクトは名前付き構造体になります。同一の形状は重複排除されるため、コピーではなく1つの構造体が得られます。オブジェクトの配列はキーごとにマージされ、一部の項目に存在しないキーはOption<T>になります。

正しい数値の型付け

整数はi64にマッピングされ、i64::MAXを超えるとu64に昇格し、u64を超えるとf64にフォールバックします。浮動小数点数はトークン（1.0、2e3）から検出されるため、serdeのデシリアライズが浮動小数点数と整数の不一致で失敗することはありません。

慣用的でコンパイル可能な識別子

キーは#[serde(rename)]で元のキーへ戻すsnake_caseフィールドになります。Rustのキーワード、重複する名前、識別子でないキーはサニタイズされるため、出力は常にコンパイルできます。

100%クライアントサイド

解析と生成はネットワーク通信なしでブラウザ内で実行されるため、データはプライベートに保たれます。

クリーンなRust構造体のためのヒント

ルート構造体に名前を付ける

読みやすいコードのために、デフォルトのRootではなく意味のあるルート名（例：User、ApiResponse）を設定してください。

serde_jsonは必要なときだけ追加する

serde_json::Valueは、空配列や型が混在する配列、nullのみのフィールドで現れます。可能であれば、より充実したサンプルからそれらのフィールドに具体的な型を与えるか、Cargo.tomlにserde_jsonを追加してください。

Optionか必須かを見直す

フィールドがOption<T>としてマークされるのは、サンプルがそれを省略している場合だけです。代表的なペイロードを貼り付けて、ツールが必須フィールドとオプショナルフィールドを正確に推論できるようにしてください。

よくある質問