تحويل JSON إلى Swift
تحويل JSON إلى هياكل Swift لتطوير تطبيقات iOS وmacOS
إدخال JSON
مخرجات Swift
ما هو تحويل JSON إلى Swift؟
تستخدم Swift الهياكل والكلاسات مع Codable لترميز JSON وفك ترميزه. تُولِّد هذه الأداة أنواع Swift من بنية JSON الخاصة بك حتى تتمكن من استخدام JSONDecoder وCodable للتحليل الآمن من حيث النوع. تُعرِّف مواصفة JSON تنسيق الإدخال.
تتم عملية التحويل في متصفحك. يمكنك تحديد اسم الهيكل وتفعيل استخدام Codable والأنواع الاختيارية. لا يتم إرسال أي شيء إلى خادم. الأنواع المُولَّدة نقطة بداية لمشاريع iOS أو macOS أو Swift على جانب الخادم.
متى يساعد تحويل JSON إلى Swift
عند بناء تطبيقات iOS أو macOS التي تستهلك واجهات REST البرمجية، أنشئ هياكل Codable هنا. استخدم JSONDecoder للتحليل. الصق استجابة نموذجية للحصول على نماذج مكتوبة.
كيفية استخدام هذه الأداة
الصق أو ارفع JSON
الصق JSON الخاص بك في المحرر الأيسر أو ارفع ملفاً. استخدم تحميل مثال للبيانات النموذجية. حدد اسم الهيكل الجذري في الإعداد. فعِّل استخدام Codable للامتثال لـCodable والأنواع الاختيارية للحقول الاختيارية.
مراجعة الأنواع المُولَّدة
تعرض اللوحة اليمنى هياكل أو كلاسات Swift. تصبح الكائنات المتداخلة أنواعاً متداخلة. استخدم <code>JSONDecoder().decode(YourType.self, from: data)</code> للتحليل. أضف <code>CodingKeys</code> إذا اختلفت مفاتيح JSON عن أسماء الخصائص. لـ JSON غير الصالح، استخدم أولاً التحقق من JSON.
نسخ أو تنزيل
استخدم <strong>نسخ</strong> أو <strong>تنزيل</strong>. لتنسيق JSON أولاً، استخدم منسق JSON. للتحقق من الصحة، استخدم التحقق من JSON.
أمثلة JSON إلى Swift
إليك مثالاً على توليد هياكل Swift من كائن JSON.
مثال: سجل مشترك
إدخال JSON:
مخرجات Swift المُولَّدة:
متى يساعد تحويل JSON إلى Swift
عند بناء تطبيقات iOS أو macOS التي تستهلك واجهات REST البرمجية، تحتاج إلى أنواع Swift لحمولة الاستجابة. لصق استجابة نموذجية هنا يمنحك هياكل Codable يمكن استخدامها مع URLSession أو Alamofire. تستفيد Swift على جانب الخادم (Vapor، Kitura) من نفس سير العمل. كتابة الهياكل يدوياً لـ JSON المتداخل المعقد عرضة للأخطاء؛ تستنتج هذه الأداة البنية من نموذجك.
الأسئلة الشائعة
دعم Codable؟
يُنتج المولِّد عادةً أنواع Codable. استخدم JSONDecoder وJSONEncoder للتسلسل. أضف CodingKeys إذا اختلفت مفاتيح JSON عن أسماء الخصائص. انظر دليل Apple لـ Codable.
الحقول الاختيارية؟
تُعيَّن حقول JSON الاختيارية إلى Optional<T> أو T?. فعِّل الأنواع الاختيارية في الإعداد للحقول التي يمكن أن تكون فارغة أو غائبة.
Struct مقابل Class؟
الهياكل (Structs) أنواع قيمة وتُفضَّل لكائنات DTO في Swift. يُنتج المولِّد عادةً هياكل. استخدم الكلاسات إذا كنت بحاجة إلى دلالات المرجع أو الوراثة.
هل بياناتي خاصة؟
نعم. تعمل عملية التوليد بالكامل في متصفحك. لا يتم إرسال أي JSON أو كود إلى أي خادم.
هل يمكنني استخدامه مع Alamofire؟
نعم. معالجات استجابة Alamofire تعمل مع أنواع Codable. ولِّد الهياكل هنا، ثم مررها إلى responseDecodable(of: YourType.self).