JSON إلى Go Struct

ما هو JSON إلى Go Struct؟

ولّد تعريفات struct في Go بأسلوب اللغة المتعارف عليه من عيّنة JSON. تكون أسماء الحقول مصدَّرة بنمط PascalCase مع المختصرات المتعارف عليها في Go (ID وURL وAPI…)، ويحمل كل حقل وسم json:"…" بالمفتاح الأصلي، وتتحول الكائنات المتداخلة إلى هياكل مسماة منفصلة.

كيفية استخدام JSON إلى Go Struct

1. الصق عيّنة JSON في إدخال JSON (أو انقر تحميل مثال / فتح ملف).
2. اضبط اسم النوع الجذر (الافتراضي Root).
3. أبقِ إضافة omitempty للحقول الاختيارية والقابلة لأن تكون null أو ألغِها.
4. انسخ شيفرة Go الناتجة أو تنزيل كملف.

مثال

{"id":1,"name":"A","tags":["x"]}

type Root struct {
	ID   int64    `json:"id"`
	Name string   `json:"name"`
	Tags []string `json:"tags"`
}

متى تستخدم JSON إلى Go Struct

استخدمه لفك استجابات API بواسطة encoding/json. لا يولّد أنواعًا مخصصة لقيم الوقت أو التعدادات؛ غيّر string إلى time.Time بنفسك حيث يناسب.

كيف يعمل JSON إلى Go Struct

تُجتاز العيّنة تكراريًا ويجمع كل موضع الأنواع التي رآها. تُدمج مصفوفات الكائنات في نوع واحد: فالمفتاح الغائب من بعض العناصر يصبح اختياريًا، والمفتاح الذي يكون null في موضع ما يصبح قابلًا لـ null، والأعداد الصحيحة المختلطة بكسرية تصبح نوع الفاصلة العائمة، وأي خلط آخر للأنواع يعود إلى نوع ديناميكي. وتصبح الكائنات المتداخلة أنواعًا مسماة (PascalCase للمفتاح مع إفراد مفاتيح المصفوفات: orders ← Order) مع لواحق رقمية عند تعارض الأسماء. يستخدم ناتج Go النوع int64 للأعداد الصحيحة وfloat64 للكسرية وstring وbool وشرائح (slices) للمصفوفات ومؤشرًا (*T) للقيم القابلة لـ null وany للقيم الديناميكية أو التي هي null فقط. وتُحاذى الأعمدة كما في ناتج gofmt.

حالات الاستخدام الشائعة

• ✓ نمذجة استجابة REST للاستخدام مع json.Unmarshal
• ✓ إنشاء هياكل إعداد من ملف JSON
• ✓ تسريع كتابة كائنات نقل البيانات (DTO) لخدمة Go مصغّرة
• ✓ مقارنة تسمية الحقول بين JSON وشيفرة Go

الأسئلة الشائعة

الخطوات التالية المقترحة

استكشف المزيد من الفئات