JSON إلى Go
حوّل عينة JSON إلى أنواع بُنى Go مع وسوم json. تصبح أسماء الحقول أسماء Go مُصدّرة، مع كتابة الاختصارات الشائعة مثل ID وURL وAPI بأحرف كبيرة؛ وتحصل الكائنات المتداخلة على بُنى خاصة بها، وتُحاذى الأعمدة كما يفعل gofmt. ألصق استجابة API وانسخ بُنى يمكنك فك ترميز البيانات إليها باستخدام encoding/json.
الأسئلة الشائعة
كيف تُسمّى الكائنات المتداخلة؟
يصبح كل كائن متداخل نوع Go مستقلًا، وتُشتق تسميته من المفتاح الذي يحتويه بصيغة PascalCase، فيصبح address مثلًا Address. أما الكائنات داخل المصفوفات فتأخذ صيغة المفرد من اسم مفتاح المصفوفة، فيصبح users مثلًا User. وتتشارك الكائنات التي لها الحقول نفسها تمامًا نوعًا واحدًا.
متى يكون الحقل اختياريًا؟
عندما تحتوي المصفوفة على عدة كائنات ويغيب مفتاح عن بعضها، يصبح ذلك الحقل اختياريًا: يتحول إلى مؤشر ويحصل وسمه على omitempty. يكون المفتاح الموجود في كل العينات مطلوبًا. أما الكائن المنفرد فلا يوجد ما يقارنه به، لذا تكون كل مفاتيحه مطلوبة.
كيف تُعالَج القيم null؟
إذا كانت قيمة المفتاح null في بعض العينات وله قيمة في عينات أخرى، يصبح مؤشرًا، مثل *string. أما المفتاح الذي تكون قيمته null دائمًا فلا يوفر للأداة معلومات عن نوعه الحقيقي، لذا يصبح any؛ ألصق عينة تتضمن قيمة فعلية للحصول على نوع دقيق.
ما أنواع الأرقام المستخدمة؟
تصبح الأعداد الصحيحة int64، وتصبح الأعداد الكسرية float64. ويصبح الحقل الذي يحتوي على النوعين float64. غيّر int64 إلى int أو إلى حجم آخر يدويًا إذا كان API يضمن نطاقًا أصغر.
ماذا يحدث للمفاتيح التي ليست أسماء صالحة؟
يُعاد تكوين كل اسم حقل من كلمات المفتاح، فيصبح first-name هو FirstName وuser_id هو UserID، بينما يحتفظ وسم json بالمفتاح الأصلي. تتطلب Go أسماء مُصدّرة كي تتمكن encoding/json من تعبئة الحقل، لذا يبدأ كل اسم بحرف كبير.
هل يتم تحميل JSON الخاص بي أو تخزينه؟
يُرسل JSON إلى الخادم فقط لإنشاء الرمز لهذا الطلب، ولا يُخزّن. لا يقرأ المولّد سوى بنية عينتك وأنواع قيمها، لذا يمكنك استبدال القيم الحساسة بعناصر نائبة من النوع نفسه قبل لصقها.