تحويل JSON إلى Kotlin
تحويل JSON إلى كلاسات بيانات Kotlin لتطوير تطبيقات Android وKotlin
إدخال JSON
مخرجات Kotlin
ما هو تحويل JSON إلى Kotlin؟
تستخدم Kotlin كلاسات البيانات للبيانات المنظمة. عند تحليل JSON باستخدام kotlinx.serialization أو Gson، تحتاج إلى أنواع Kotlin مناسبة. تُولِّد هذه الأداة كلاسات بيانات Kotlin من بنية JSON للاستخدام مع Json.decodeFromString أو Gson.fromJson.
تتم عملية التحويل في متصفحك. حدد اسم كلاس البيانات والحزمة في الإعداد. فعِّل Data Class للحصول على بنية <code>data class</code> والأنواع القابلة للفارغة للحقول الاختيارية. لا يُرسل أي شيء إلى الخادم.
كيفية استخدام هذه الأداة
الصق أو ارفع JSON
الصق JSON الخاص بك في المحرر الأيسر أو ارفع ملفاً. استخدم <strong>تحميل مثال</strong> للحصول على بيانات نموذجية. حدد اسم كلاس البيانات الرئيسي والحزمة في الإعداد. فعِّل Data Class والأنواع القابلة للفارغة حسب الحاجة.
مراجعة الأنواع المُولَّدة
تعرض اللوحة اليمنى كلاسات بيانات Kotlin. تصبح الكائنات المتداخلة أنواعاً متداخلة. تصبح المصفوفات <code>List<T></code>. استخدم <code>@SerializedName</code> أو <code>@Json</code> إذا اختلفت مفاتيح JSON عن أسماء الخصائص. للـ JSON غير الصالح، استخدم منسق JSON أو التحقق من JSON أولاً.
نسخ أو تنزيل
استخدم <strong>نسخ</strong> أو <strong>تنزيل</strong>. الصق في مشروع Android أو Kotlin. لتنسيق JSON أولاً استخدم منسق JSON. للتحقق استخدم التحقق من JSON.
أمثلة JSON إلى Kotlin
إليك مثالاً على توليد كلاسات بيانات Kotlin من كائن JSON.
مثال: سجل مشترك
إدخال JSON:
مخرجات Kotlin المُولَّدة:
متى يكون تحويل JSON إلى Kotlin مفيداً
عند بناء تطبيقات Android أو خدمات Kotlin الخلفية التي تستهلك واجهات REST البرمجية، تحتاج إلى كلاسات بيانات مكتوبة بنوع محدد. الصق استجابة نموذجية هنا للحصول على نماذج Kotlin لـ Retrofit أو Gson أو kotlinx.serialization.
الأسئلة الشائعة
Data class مقابل كلاس عادي؟
تُوفِّر كلاسات البيانات equals وhashCode وtoString وcopy تلقائياً. هي المفضَّلة لكائنات DTO. فعِّل Data Class في الإعداد للحصول على بنية data class.
أنواع قابلة للقيمة الفارغة؟
فعِّل الأنواع القابلة للفارغة للحقول الاختيارية في JSON. تستخدم Kotlin Type? للقيم القابلة للفارغة. مفيد عندما يمكن أن يكون الحقل فارغاً أو غائباً في استجابة الواجهة البرمجية.
هل يتم إرسال بياناتي إلى أي مكان؟
لا. تتم عملية التوليد بالكامل في متصفحك. لا يُرسل أي JSON أو كود إلى أي خادم.
Gson أم kotlinx.serialization؟
كلاهما يعمل مع كلاسات البيانات المُولَّدة. تستخدم Gson @SerializedName لأسماء المفاتيح المخصصة. تستخدم kotlinx.serialization @SerialName. أضف التعليقات التوضيحية المناسبة إذا اختلفت مفاتيح JSON عن أسماء الخصائص.
هل يمكنني استخدامه مع Retrofit؟
نعم. يعمل Retrofit مع Gson أو kotlinx.serialization. ولِّد كلاسات البيانات هنا ثم استخدمها كأنواع استجابة في واجهة API الخاصة بك.
أدوات ذات صلة
لـ JSON في Kotlin، انظر kotlinx.serialization وGson. لـ JSON، انظر مواصفة JSON وRFC 8259.