تحويل JSON إلى كود
فئات لتسع لغات

ما الذي يوفّره لك تحويل JSON إلى كود

تتلقى استجابة JSON من واجهة API. الآن تحتاج إلى فئة تحملها. أيضًا، كتابة هذه الفئة يدويًا بطيئة وممِلّة. وخطأ مطبعي في اسم حقل واحد يكسر كل شيء.

يتولى محوّل تحويل JSON إلى كود هذا الجزء الممل. الصق مثالًا، واختر لغة، فتظهر الفئات. في الواقع، انسخها إلى مشروعك وامضِ.

يقرأ المثال كله، لا العنصر الأول فقط. فيصبح الحقل الغائب عن بعض العناصر اختياريًا. ويصبح الحقل الذي فيه أعداد صحيحة وعشرية double. كذلك، وتجعل قيمة null الحقل يقبل الفراغ.

لا يُرفع شيء. قد يحوي مثالك بيانات عملاء حقيقية. ولأن متصفحك يؤدي العمل، لا يصل شيء منها إلى هذا الموقع.

فكّر في يوم عادي. يضيف زميل حقلًا إلى API. عندها يفشل تطبيقك في الاختبار، لأن الفئة لا تعرف الحقل. أيضًا، مع النماذج المولّدة تلصق الاستجابة الجديدة وتنسخ الفئة، ويستغرق الإصلاح دقيقة. كما يمكنك مقارنة الكود القديم بالجديد لترى بالضبط ما تغيّر.

JSON إلى فئة C# أونلاين

اختر C# فتحصل على فئات بسيطة بخصائص get; set;. اختر System.Text.Json أو Newtonsoft.Json فتضيف الأداة السمة الصحيحة إلى كل خاصية. تصبح مفاتيح مثل first-name هي FirstName، وتحتفظ السمة بالاسم الأصلي.

تصبح التواريخ بصيغة ISO من نوع DateTime. وتصبح الحقول الاختيارية أنواعًا تقبل الفراغ، فيبقى كودك صريحًا بشأن ما قد يغيب.

كما تكتب الأداة قيمة افتراضية للنصوص المطلوبة، فلا يصطدم كودك بـnull على غفلة. ثم يمكنك إضافة منطقك الخاص حول الفئة.

لمزيد من التفاصيل، راجع: RFC 8259, the JSON standard.

JSON إلى فئة Java أونلاين

تحصل Java على حقول خاصة مع دوال get وset، وهي الشكل الكلاسيكي للـbean. أضف Jackson فيحمل كل حقل تعليقًا توضيحيًا @JsonProperty. أو اختر Lombok فتكتب الأداة @Data بدل دوال الوصول الطويلة.

تستخدم الأرقام الأنواع المغلّفة، مثل Integer وDouble. في الواقع، وهكذا يمكن للقيمة الغائبة أن تكون null.

السجلات خيار آخر في Java الحديثة، لكن الـbeans تعمل في كل مكان. لذلك تكتب هذه الأداة شكل الـbean. ثم يمكنك تحويله إلى سجل يدويًا إن شئت.

TypeScript وKotlin وGo وغيرها

تحصل TypeScript على واجهات، أو أنواع إن فضّلت. ويحصل الحقل الاختياري على علامة استفهام. وتحصل Kotlin على فئات بيانات، مع kotlinx.serialization إن أردت.

تحصل Go على بنى بوسوم JSON، وتحصل الحقول الاختيارية على omitempty. كذلك، وتحصل Python على dataclasses أو نماذج Pydantic أو TypedDict. وتحصل PHP على فئات مكتوبة بخصائص مرقّاة. وتحصل Swift على بنى Codable، وتحصل Rust على بنى serde.

الحقول الاختيارية وقيم null

البيانات الحقيقية فوضوية. طلب فيه قسيمة والطلب التالي بلا قسيمة. أيضًا، تقارن الأداة كل عنصر في القائمة. وإذا غاب مفتاح عن أي منها، فالحقل اختياري.

المفتاح الذي قيمته null في المثال يصبح قابلًا للفراغ. ويمكنك إيقاف قاعدة الاختياري إذا كانت واجهتك ترسل كل حقل دائمًا.

لماذا يهم هذا؟ لأن المحلّل الذي يرى مفتاحًا غائبًا قد يرمي خطأ، أو يملأ قيمة افتراضية لم تتوقعها. لذلك تُوضّح الأنواع القابلة للفراغ القصد. في الواقع، عندها يجب أن يتعامل كودك مع الحالة الفارغة.

أنواع ذكية من القيم الحقيقية

تصبح الأعداد الصحيحة int. وتصبح الأعداد الصحيحة الأكبر من int هي long. وكل ما فيه كسر يصبح double. كذلك، والنص الذي يشبه تاريخ ISO يصبح نوع تاريخ حيث تملك اللغة واحدًا.

أسماء آمنة

قد تكسر المفاتيح لغةً. class وnew كلمتان محجوزتان. وfirst-name فيه شرطة. تعيد الأداة تسميتها بأمان، وتحتفظ بصلة بالمفتاح الحقيقي فتبقى البيانات مطابقة.

مثلًا يصبح مفتاح اسمه 123 هو _123 في C#، لأن الاسم لا يجوز أن يبدأ برقم.