واجهات JSON

واجهات JSON — JSON APIs

معظم التطبيقات الحديثة تتواصل عبر JSON. Go تأتي مع حزمة encoding/json قوية تُحوّل بين Go structs و JSON بسلاسة.

تشفير JSON — Marshal

main.go

package main

import (
    "encoding/json"
    "fmt"
)

// مستخدم — User
type User struct {
    ID       int      `json:"id"`
    Name     string   `json:"name"`
    Email    string   `json:"email"`
    Age      int      `json:"age,omitempty"`      // يُحذف إذا صفر — Omit if zero
    Password string   `json:"-"`                   // لا يظهر في JSON أبداً — Never in JSON
    Tags     []string `json:"tags,omitempty"`
}

func main() {
    user := User{
        ID:       1,
        Name:     "أحمد",
        Email:    "ahmed@example.com",
        Age:      28,
        Password: "secret123",
        Tags:     []string{"مطور", "Go"},
    }

    // تحويل إلى JSON — Convert to JSON
    data, err := json.Marshal(user)
    if err != nil {
        fmt.Println("خطأ:", err)
        return
    }
    fmt.Println("JSON:", string(data))

    // تنسيق جميل — Pretty print
    pretty, _ := json.MarshalIndent(user, "", "  ")
    fmt.Println("\nJSON مُنسّق:")
    fmt.Println(string(pretty))

    // بدون عمر — Without age (omitempty)
    user2 := User{ID: 2, Name: "فاطمة", Email: "fatima@example.com"}
    data2, _ := json.Marshal(user2)
    fmt.Println("\nبدون عمر:", string(data2))
}

Output:

فك تشفير JSON — Unmarshal

main.go

package main

import (
    "encoding/json"
    "fmt"
)

type Product struct {
    ID    int     `json:"id"`
    Name  string  `json:"name"`
    Price float64 `json:"price"`
    InStock bool  `json:"in_stock"`
}

func main() {
    // JSON → struct
    jsonStr := `{"id": 1, "name": "كتاب Go", "price": 49.99, "in_stock": true}`

    var product Product
    err := json.Unmarshal([]byte(jsonStr), &product)
    if err != nil {
        fmt.Println("خطأ:", err)
        return
    }
    fmt.Printf("المنتج: %+v\n", product)
    fmt.Printf("الاسم: %s، السعر: %.2f\n", product.Name, product.Price)

    // مصفوفة JSON — JSON array
    jsonArray := `[
        {"id": 1, "name": "قلم", "price": 5.0, "in_stock": true},
        {"id": 2, "name": "دفتر", "price": 12.5, "in_stock": false}
    ]`

    var products []Product
    json.Unmarshal([]byte(jsonArray), &products)
    for _, p := range products {
        status := "متوفر ✅"
        if !p.InStock {
            status = "غير متوفر ❌"
        }
        fmt.Printf("  %s — %.2f ريال — %s\n", p.Name, p.Price, status)
    }

    // JSON ديناميكي — Dynamic JSON
    dynamic := `{"key": "value", "number": 42, "nested": {"a": 1}}`
    var result map[string]interface{}
    json.Unmarshal([]byte(dynamic), &result)
    fmt.Printf("\nJSON ديناميكي: %v\n", result)
}

Output:

بناء REST API كامل

main.go

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "strings"
)

// نموذج المهمة — Task model
type Task struct {
    ID     int    `json:"id"`
    Title  string `json:"title"`
    Done   bool   `json:"done"`
}

// استجابة API — API response
type APIResponse struct {
    Success bool        `json:"success"`
    Data    interface{} `json:"data,omitempty"`
    Error   string      `json:"error,omitempty"`
}

// مخزن بسيط — Simple store
var tasks = []Task{
    {ID: 1, Title: "تعلم Go", Done: true},
    {ID: 2, Title: "بناء API", Done: false},
    {ID: 3, Title: "نشر المشروع", Done: false},
}

// دالة مساعدة للـ JSON — JSON helper
func writeJSON(w http.ResponseWriter, status int, data interface{}) {
    w.Header().Set("Content-Type", "application/json; charset=utf-8")
    w.WriteHeader(status)
    json.NewEncoder(w).Encode(data)
}

// معالج المهام — Task handler
func taskHandler(w http.ResponseWriter, r *http.Request) {
    switch r.Method {
    case "GET":
        writeJSON(w, http.StatusOK, APIResponse{
            Success: true,
            Data:    tasks,
        })
    case "POST":
        var newTask Task
        if err := json.NewDecoder(r.Body).Decode(&newTask); err != nil {
            writeJSON(w, http.StatusBadRequest, APIResponse{
                Success: false,
                Error:   "بيانات غير صالحة",
            })
            return
        }
        newTask.ID = len(tasks) + 1
        tasks = append(tasks, newTask)
        writeJSON(w, http.StatusCreated, APIResponse{
            Success: true,
            Data:    newTask,
        })
    default:
        writeJSON(w, http.StatusMethodNotAllowed, APIResponse{
            Success: false,
            Error:   "أسلوب غير مسموح",
        })
    }
}

func main() {
    // محاكاة الاستجابة — Simulate response
    resp := APIResponse{
        Success: true,
        Data:    tasks,
    }
    data, _ := json.MarshalIndent(resp, "", "  ")
    fmt.Println("GET /api/tasks:")
    fmt.Println(string(data))

    // محاكاة إنشاء مهمة — Simulate creating task
    newTaskJSON := `{"title": "كتابة اختبارات", "done": false}`
    var newTask Task
    json.NewDecoder(strings.NewReader(newTaskJSON)).Decode(&newTask)
    newTask.ID = len(tasks) + 1
    tasks = append(tasks, newTask)

    fmt.Printf("\nPOST /api/tasks → أُنشئت مهمة %d: %s\n", newTask.ID, newTask.Title)
    fmt.Printf("المجموع الآن: %d مهام\n", len(tasks))

    _ = taskHandler // مُعرّف للاستخدام مع http.HandleFunc
}

Output:

وسوم JSON المهمة — JSON Tags

type Example struct {
    Field1 string `json:"field_1"`            // اسم مخصص
    Field2 int    `json:"field_2,omitempty"`   // حذف إذا صفر
    Field3 bool   `json:"-"`                   // تجاهل تماماً
    Field4 string `json:"field_4,string"`      // تشفير كنص
}

json.Encoder vs json.Marshal

// Marshal — يُنتج []byte — عندما تحتاج النتيجة كنص
data, err := json.Marshal(obj)

// Encoder — يكتب مباشرة لـ io.Writer — أفضل للـ HTTP
json.NewEncoder(w).Encode(obj)

// Decoder — يقرأ من io.Reader — أفضل لقراءة الطلب
json.NewDecoder(r.Body).Decode(&obj)

تحدي — Challenge

package main

import (
    "encoding/json"
    "fmt"
)

type Product struct {
    Name    string  `json:"name"`
    Price   float64 `json:"price"`
    InStock bool    `json:"in_stock"`
}

func main() {
    data := `{"name": "كتاب Go", "price": 49.99, "in_stock": true}`

    var p Product
    // فك تشفير JSON إلى p باستخدام json.Unmarshal — اكتب الكود هنا

    status := "متوفر"
    if !p.InStock {
        status = "غير متوفر"
    }
    fmt.Printf("المنتج: %s (%.2f ريال) - %s\n", p.Name, p.Price, status)
}