Kotlin JSON: دليل تحليل JSON من الصفر إلى الاحتراف

مقدمة: لماذا JSON في Kotlin هو ألم وفرح في آن واحد

إذا كنت قد كتبت أي وقت مضى تطبيقات Android أو خوادم خلفية بلغة Kotlin، فبالتأكيد واجهت JSON. إنه مثل الهواء لمطور العصر الحديث: API، ملفات التكوين، قواعد البيانات - كل شيء يتحدث بهذه اللغة. لكن المفارقة هي: سؤال "How to parse JSON in Kotlin?" على Stack Overflow يحصل على آلاف المشاهدات كل شهر. لماذا؟ لأنه في Kotlin، على عكس Java، يوجد null safety، والمكتبات القديمة مثل Gson تبدأ في "التصرف بغرابة".

في هذا البرنامج التعليمي، سنشرح تحليل JSON في Kotlin من البسيط إلى المعقد. ستتعلم كيفية العمل مع Kotlinx Serialization وMoshi وGson الكلاسيكي. سنكتب كودًا حقيقيًا يمكنك نسخه مباشرة إلى مشروعك. هيا بنا!

ما هو JSON ولماذا لا يتوافق Kotlin معه بسهولة؟

JSON (JavaScript Object Notation) هو تنسيق نصي لتبادل البيانات. يبدو تقريبًا هكذا:

{\n  "name": "Kotlin",\n  "year": 2011,\n  "features": ["null safety", "coroutines"]\n}

قد يبدو الأمر بسيطًا، لكن في Kotlin هناك كتابة صارمة وnull safety. عندما تقوم بتحليل JSON، يجب عليك تحديد الحقول التي يمكن أن تكون null بوضوح، وأيها إلزامية. إذا لم تراعِ المكتبة ذلك، فستحصل على NullPointerException أو أخطاء غريبة.

لهذا السبب، اختيار المكتبة الصحيحة لـ تحليل JSON في Kotlin ليس مجرد "مكتبة حسب الذوق"، بل هو مسألة استقرار المشروع.

أفضل 3 مكتبات لتحليل JSON في Kotlin

سننظر في ثلاثة طرق رئيسية. لكل منها إيجابيات وسلبيات.

\n
• Kotlinx Serialization - المكتبة الرسمية من JetBrains. أفضل تكامل مع اللغة.
\n
• Moshi - مكتبة حديثة من Square. تعمل مع Java وKotlin.
\n
• Gson - المعيار القديم الجيد. لا يزال شائعًا، لكنه يتطلب الحذر مع Kotlin.
\n

1. Kotlinx Serialization - اختيار المحترفين

هذه مكتبة أصلية لـ Kotlin. تستخدم توليد الكود وتدعم بشكل كامل null safety. إذا كنت تكتب مشروعًا جديدًا بلغة Kotlin، فهذا هو اختيارك.

التثبيت: أضف البرنامج المساعد في build.gradle.kts:

plugins {\n    kotlin("plugin.serialization") version "1.9.0"\n}\n\ndependencies {\n    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.0")\n}

مثال على الكود:

import kotlinx.serialization.Serializable\nimport kotlinx.serialization.json.Json\n\n@Serializable\ndata class User(\n    val name: String,\n    val year: Int,\n    val features: List<String>\n)\n\nfun main() {\n    val jsonString = """\n        {\n            "name": "Kotlin",\n            "year": 2011,\n            "features": ["null safety", "coroutines"]\n        }\n    """.trimIndent()\n\n    val user = Json.decodeFromString<User>(jsonString)\n    println(user.name) // Kotlin\n    println(user.features[0]) // null safety\n}

لاحظ: Kotlinx Serialization تلتقط الأنواع تلقائيًا. إذا كان الحقل مفقودًا في JSON، ولم يتم وضع علامة عليه كـ nullable في data class، فستحصل على استثناء. هذا جيد - لن تفوتك أي خطأ.

2. Moshi - مرن وسريع

Moshi هي مكتبة من Square تم إنشاؤها مع مراعاة Kotlin. كما أنها تدعم توليد الكود وnull safety. على عكس Gson، لا تستخدم Moshi الانعكاس (reflection) افتراضيًا، مما يجعلها أسرع.

التثبيت:

dependencies {\n    implementation("com.squareup.moshi:moshi-kotlin:1.15.0")\n    ksp("com.squareup.moshi:moshi-kotlin-codegen:1.15.0")\n}

مثال على الكود:

im