محوّل JSON إلى بنية Rust

ما هو تحويل JSON إلى 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، وDebug وClone، أو رؤية pub لتطابق نمط الـcrate لديك.

3. 3

   انسخ أو حمّل

   خذ Rust المُولَّد بنقرة واحدة والصقه مباشرة في مشروعك.

Common Use Cases

عملاء API مكتوبو الأنواع

حوّل عيّنة استجابة REST أو GraphQL إلى بنى serde لعميل reqwest أو مشابه دون كتابة كود فكّ التسلسل النمطي يدوياً.

تحليل الإعدادات والتجهيزات

ولّد بنى لملفات إعداد JSON أو تجهيزات الاختبار أو حمولات webhook التي تحتاج إلى فكّ تسلسلها بـserde_json.

النمذجة السريعة

الصق حمولة غير مألوفة لترى شكلها فوراً كأنواع Rust — طريقة سريعة لاستكشاف API جديد قبل ربطه.

كيف يعمل التحويل

الاستنتاج البنيوي

يصبح كل كائن بنية مسماة؛ وتُزال تكرارات الأشكال المتطابقة فتحصل على بنية واحدة لا نسخ. تُدمج مصفوفات الكائنات مفتاحاً بمفتاح، والمفاتيح الغائبة من بعض العناصر تصبح Option<T>.

كتابة أنواع الأرقام الصحيحة

تُعيَّن الأعداد الصحيحة إلى i64، وتترقّى إلى u64 بعد i64::MAX، وتعود إلى f64 بعد u64. تُكتشف الأعداد العشرية من الرمز (1.0، 2e3) فلا يفشل فكّ تسلسل serde أبداً بسبب عدم تطابق عدد عشري مع حقل صحيح.

معرّفات اصطلاحية قابلة للتصريف

تصبح المفاتيح حقول snake_case مع #[serde(rename)] يعود إلى المفتاح الأصلي؛ وتُنظَّف الكلمات المفتاحية في Rust والأسماء المكرّرة والمفاتيح غير المعرّفات فيُصرَّف الإخراج دائماً.

100% على جانب المتصفح

يجري التحليل والتوليد في متصفحك دون أي طلبات شبكة، فتبقى بياناتك خاصة.

نصائح لبنى Rust نظيفة

سمِّ بنيتك الجذرية

عيّن اسماً جذرياً ذا معنى (مثل User أو ApiResponse) بدلاً من الافتراضي Root لكود مقروء.

أضف serde_json عند الحاجة فقط

يظهر serde_json::Value مع المصفوفات الفارغة أو المختلطة الأنواع والحقول الفارغة فقط. أعطِ تلك الحقول نوعاً محدّداً من عيّنة أغنى إن استطعت، أو أضف serde_json إلى Cargo.toml.

راجع Option مقابل المطلوب

تُعلَّم الحقول Option<T> فقط عندما تحذفها عيّنة. الصق حمولة تمثيلية كي تستنتج الأداة الحقول المطلوبة والاختيارية بدقة.

الأسئلة الشائعة