الفصل 17 — JSON ونمذجة البيانات

المستوى: متوسط المدة المقدّرة: 6 ساعات المتطلبات المسبقة: الفصل 16 — تنظيم مشروع Dart (والفصول 9 و12 و13 و14) ما ستتمكن من فعله في نهاية الفصل: تحويل نص JSON إلى كائنات Dart مُحدَّدة الأنواع، وتحويل كائنات Dart إلى نص JSON، مع معالجة القيم المفقودة والأنواع غير المتسقة وأخطاء الصيغة معالجة سليمة.

17.0 — أهداف الفصل

في نهاية هذا الفصل، ستكون قادرًا على:

• شرح الغرض من JSON ولماذا يستخدمه الجميع؛
• التعرّف على أنواع القيم الستة في JSON؛
• قراءة كائن JSON ومصفوفة JSON وكتابتهما؛
• ذكر الفروق بين JSON وMap في Dart؛
• احترام قواعد صياغة JSON (علامات اقتباس مزدوجة، دون فاصلة أخيرة)؛
• فك ترميز النص باستخدام jsonDecode() وترميزه باستخدام jsonEncode()؛
• شرح سبب إرجاع jsonDecode() للنوع dynamic؛
• تحويل النتيجة (cast) إلى Map<String, dynamic> وإلى List<dynamic>؛
• كتابة فئة نموذج (model) تحتوي على fromJson() وtoJson()؛
• إجراء رحلة ذهاب وإياب كائن ← JSON ← كائن دون أي فقدان؛
• التعامل مع الكائنات المتداخلة وقوائم الكائنات المتداخلة؛
• كتابة شيفرة دفاعية في مواجهة القيم المفقودة والأنواع غير المتسقة؛
• التقاط FormatException عند وجود JSON غير صالح؛
• تحويل enum وDateTime إلى JSON والعكس؛
• حفظ لعبة وإعادة تحميلها من ملف JSON؛
• فهم الغرض من json_serializable؛
• ربط ذلك بواجهات REST API التي ستستهلكها في Flutter.