JSON to Go: بنيات يتم فك تنظيمها من المحاولة الأولى

الشكل المتولد

يقوم المحول بتحويل كل كائن إلى بنية، وكل مصفوفة إلى شريحة، ويستنتج نوع Go لكل قيمة. تصبح الكائنات المتداخلة أنواعًا مسماة بدلاً من النقط المجهولة، مما يجعل توقيع رمز فك التشفير الخاص بك قابلاً للقراءة:

                type Container struct {
  Name  string `json:"name"`
  Image string `json:"image"`
  Ports []struct {
    ContainerPort int `json:"containerPort"`
  } `json:"ports"`
}
              

ال`json`العلامات هي الجزء المهم. وحدة فك ترميز Go غير حساسة لحالة الأحرف عند مطابقة أسماء الحقول، ولكن`containerPort`و`ContainerPort`لا تتم المحاذاة بدون علامة، وأي مفتاح ليس معرف Go صالحًا -`app.kubernetes.io/name`، على سبيل المثال - لا يمكن مطابقته على الإطلاق بدون واحد.

الأرقام والأصفار والفخاخين الكلاسيكيين

• الأرقام - يُنتج الاستدلال `int` للقيم الكاملة، لكن JSON لا يحتوي على نوع عدد صحيح. الحقل الذي يبلغ `3` اليوم قد يصبح `3.5` غدًا، لذا تكون المعرفات والأموال أكثر أمانًا مثل `float64` أو `string` أو `json.Number` حسب احتياجاتك.
• القيم الخالية - المفتاح الذي يمكن أن يكون `null` يجب أن يكون مؤشرًا (`*string`) حتى تتمكن من التمييز بين "غائب" و"فارغ".
• الطوابع الزمنية - يتم فك تشفير سلسلة RFC 3339 بشكل نظيف إلى `time.Time`; رقم عصر Unix لا يحدث ذلك، لذا احتفظ به كـ `int64` وقم بتحويله بشكل صريح.
• الحقول غير المعروفة — `json.Decoder` تتجاهل الإضافات بشكل افتراضي؛ استخدم `DisallowUnknownFields` عندما تفضل الفشل بصوت عالٍ.

أنشئ من إجابتين أو ثلاث استجابات عندما تستطيع ذلك. الحقول التي تكون مفقودة في بعض الأحيان تصبح مؤشرات، ومن الأسهل بكثير اتخاذ هذا القرار من الأدلة بدلاً من الذاكرة.

من الهيكل إلى رمز العمل

مع وجود الهياكل في مكانها الصحيح، يكون فك التشفير عبارة عن ثلاثة أسطر ويقوم المترجم بفرض مسارات الوصول من هناك. النمط الشائع هو فك التشفير في البنية التي تم إنشاؤها، ثم تعيينها في نوع المجال الخاص بك بحيث يمكن تغيير شكل JSON دون التمدد عبر التطبيق. قم بوضع علامة على الملف الذي تم إنشاؤه بنقطة النهاية التي جاء منها، وأعد الإنشاء عندما تتغير الاستجابة بدلاً من تحريره يدويًا - الكود الذي تم إنشاؤه يدويًا هو الإصدار الذي لا يجرؤ أحد على تجديده لاحقًا.

توليد محليا

عادةً ما تكون الحمولات التي تستحق إنشاء بنيات Go منها استجابات حقيقية لواجهة برمجة التطبيقات (API)، وتحمل الاستجابات الحقيقية الرموز المميزة وبيانات العميل. يحافظ تحويل JSON to Go المستند إلى المتصفح على الحمولة في علامة التبويب - بدون تحميل، ولا سؤال للاحتفاظ - مما يجعل الإنشاء من بيانات الإنتاج خطوة عادية وليس استثناءً للسياسة.