# JSON إلى Kotlin

حوّل عينة JSON إلى فئات بيانات Kotlin مشروحة لدعم kotlinx.serialization. تصبح أسماء الخصائص بصيغة camelCase، مع استخدام @SerialName للمفاتيح المختلفة؛ وتحصل الكائنات المتداخلة على فئات خاصة بها، وتكون القيمة الافتراضية للحقول الاختيارية null، بينما تصبح القيم مختلطة النوع JsonElement. ألصق استجابة API وفك ترميزها باستخدام Json.decodeFromString.

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

### كيف تُسمّى الكائنات المتداخلة؟

يصبح كل كائن متداخل نوع Kotlin مستقلًا، وتُشتق تسميته من المفتاح الذي يحتويه بصيغة PascalCase، فيصبح address مثلًا Address. أما الكائنات داخل المصفوفات فتأخذ صيغة المفرد من اسم مفتاح المصفوفة، فيصبح users مثلًا User. وتتشارك الكائنات التي لها الحقول نفسها تمامًا نوعًا واحدًا.

### متى يكون الحقل اختياريًا؟

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

### كيف تُعالَج القيم null؟

إذا كانت قيمة المفتاح null في بعض العينات وله قيمة في عينات أخرى، يصبح نوعًا قابلًا لـ null، مثل String?. أما المفتاح الذي تكون قيمته null دائمًا فلا يوفر للأداة معلومات عن نوعه الحقيقي، لذا يصبح JsonElement?؛ ألصق عينة تتضمن قيمة فعلية للحصول على نوع دقيق.

### ما أنواع الأرقام المستخدمة؟

تصبح الأعداد الصحيحة Long، وتصبح الأعداد الكسرية Double. ويصبح الحقل الذي يحتوي على النوعين Double.

### ماذا يحدث للمفاتيح التي ليست أسماء صالحة؟

تُحوّل أسماء الخصائص إلى camelCase، وتُضاف إليها @SerialName مع المفتاح الأصلي متى اختلفا. أما الأسماء التي تكون كلمات Kotlin محجوزة، مثل object، فتُكتب بين علامتي اقتباس خلفيتين.

### هل يتم تحميل JSON الخاص بي أو تخزينه؟

يُرسل JSON إلى الخادم فقط لإنشاء الرمز لهذا الطلب، ولا يُخزّن. لا يقرأ المولّد سوى بنية عينتك وأنواع قيمها، لذا يمكنك استبدال القيم الحساسة بعناصر نائبة من النوع نفسه قبل لصقها.

إعلانك هنا؟

[راسلنا عبر البريد الإلكتروني](mailto:hi@dennn.is?subject=%D8%A7%D9%84%D8%A5%D8%B9%D9%84%D8%A7%D9%86%20%D8%B9%D9%84%D9%89%20OneClick%20Pro)

[إعلان 433 أداة لوكلاء الذكاء الاصطناعي عبر خادم MCP واحد.](https://multitaskai.com/ar/?ref=oneclickpro)
