تتعامل حزمة encoding/json في مكتبة Go القياسية مع تسلسل JSON (marshaling) وفك التسلسل (unmarshaling)، وتحويل البيانات بين بنى Go و JSON. علامات الهيكل (struct tags) تتحكم في تسمية الحقول، وهي تشكل العمود الفقري لمعظم واجهات برمجية الويب في Go.
User {
Name
Email
Age
private
}
u := User{Name: , Email: , Age: }
data, err := json.Marshal(u)
fmt.Println((data))
json.Marshal يحول بنية (struct) إلى بايتات JSON. فقط الحقول المُصدَّرة (المكتوبة بأحرف كبيرة) يتم تسلسلها — الحقول غير المُصدَّرة يتم تخطيها.
type Product struct {
ID int `json:"id"` // → "id"
Name string `json:"product_name"` // → "product_name" (rename)
Price float64 `json:"price,omitempty"` // omit if 0
Notes string `json:"-"` // "-" → NEVER serialize this field
}
بدون علامات، مفاتيح JSON تفترض افتراضياً اسم الحقل بالضبط (مكتوب بأحرف كبيرة). العلامات تتيح لك التحكم في اسم مفتاح JSON، وحذف القيم الفارغة (omitempty)، واستبعاد الحقول بالكامل (-) — وهذا أساسي لمطابقة اتفاقيات API (مثل snake_case في JSON).
jsonData := []byte(`{"name":"Bob","email":"[email protected]","age":25}`)
var user User
err := json.Unmarshal(jsonData, &user) // pass a POINTER to populate it
if err != nil { log.Fatal(err) }
fmt.Println(user.Name) // "Bob"
json.Unmarshal يحلل JSON إلى بنية (struct) — يجب أن تمرر مؤشراً (pointer) حتى يتمكن من ملء البنية. يتم مطابقة الحقول حسب العلامة/الاسم (بطريقة غير حساسة لحالة الأحرف).
// when the structure is unknown, unmarshal into a map or interface{}
var result map[string]interface{}
json.Unmarshal(data, &result)
name := result["name"].(string) // type-assert the value (JSON numbers → float64!)
// encode directly to an io.Writer (e.g. an HTTP response) — efficient, no intermediate buffer
json.NewEncoder(w).Encode(user)
// decode directly from an io.Reader (e.g. an HTTP request body)
json.NewDecoder(r.Body).Decode(&user)
بالنسبة لخوادم الويب، Encoder/Decoder تعمل مباشرة مع التدفقات (أجسام الطلب/الاستجابة) — وهذا هو النمط الشائع في المعالجات.
ترميز وفك ترميز JSON أساسي لكل تطوير ويب في Go تقريباً — واجهات برمجية REST، الخدمات الدقيقة، والتكوين — كل ذلك يعتمد على التحويل بين بنى Go و JSON.
حزمة encoding/json (من مكتبة قياسية، بدون تبعيات) هي الأداة القياسية، وفهمها بشكل جيد أمر أساسي للمعرفة اليومية: كيفية عمل marshaling/unmarshaling، القاعدة الحاسمة بأن فقط الحقول المُصدَّرة يتم تسلسلها، وخاصة علامات الهيكل (التحكم في أسماء مفاتيح JSON باستخدام json:"...", omitempty لتخطي القيم الفارغة، - للاستبعاد) وهي مطلوبة لمطابقة اتفاقيات API الحقيقية مثل snake_case.
معرفة تمرير مؤشر إلى Unmarshal، والتعامل مع JSON الديناميكي عبر الخرائط/interface{} (مع الحذر من أن أرقام JSON يتم فك ترميزها إلى float64)، واستخدام Encoder/Decoder للبث مع أجسام HTTP يغطي الاحتياجات العملية لبناء واجهات برمجية.
إنها جزء مستمر وعملي من عمل Go في الواجهة الخلفية.