آپ Go میں JSON کو encode/decode کیسے کرتے ہیں؟

Question

Accepted Answer

Go کی معیاری لائبریری **`encoding/json`** پیکج JSON سیریلائزیشن (marshaling) اور ڈیسیریلائزیشن (unmarshaling) کو سنبھالتا ہے، Go structs اور JSON کے درمیان mapping کرتا ہے۔ **Struct tags** فیلڈ naming کو کنٹرول کرتے ہیں، اور یہ زیادہ تر Go web APIs کی بنیاد ہے۔

## Marshaling: Go struct → JSON

```go
type User struct {
    Name    string `json:"name"`              // tag maps the field to a JSON key
    Email   string `json:"email"`
    Age     int    `json:"age,omitempty"`     // omitempty → skip if zero/empty
    private string                             // unexported → NOT serialized (lowercase)
}

u := User{Name: "Ann", Email: "ann@x.com", Age: 30}
data, err := json.Marshal(u)
fmt.Println(string(data))   // {"name":"Ann","email":"ann@x.com","age":30}
```

`json.Marshal` ایک struct کو JSON bytes میں تبدیل کرتا ہے۔ **صرف exported (capitalized) فیلڈز سیریلائز ہوتے ہیں** — unexported فیلڈز کو چھوڑ دیا جاتا ہے۔

## Struct tags کا کردار

```go
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
}
```

بغیر tags کے، JSON keys بالکل (capitalized) فیلڈ name کو default کریں گے۔ Tags آپ کو JSON key name کو کنٹرول کرنے، خالی values کو omit کرنے (`omitempty`)، اور فیلڈز کو مکمل طور پر exclude کرنے (`-`) دیتے ہیں — API conventions (مثلاً snake_case JSON) سے match کرنے کے لیے ضروری۔

## Unmarshaling: JSON → Go struct

```go
jsonData := []byte(`{"name":"Bob","email":"bob@x.com","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 میں parse کرتا ہے — آپ کو **pointer** pass کرنا چاہیے تاکہ یہ struct کو populate کر سکے۔ Fields کو tag/name سے match کیا جاتا ہے (case-insensitively)۔

## Unknown/dynamic JSON کے ساتھ کام کرنا

```go
// 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!)
```

## Streaming کے ساتھ Encoder/Decoder (I/O کے لیے)

```go
// 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)
```

Web servers کے لیے، `Encoder`/`Decoder` براہ راست streams (request/response bodies) کے ساتھ کام کرتے ہیں — handlers میں عام pattern۔

## اہمیت کیوں رکھتی ہے

JSON encoding/decoding تقریباً تمام Go web development کے لیے بنیادی ہے — REST APIs، microservices، اور configuration سب Go structs اور JSON کے درمیان تبدیلی پر منحصر ہیں۔

`encoding/json` پیکج (معیاری لائبریری، کوئی dependency نہیں) معیاری ٹول ہے، اور اسے اچھی طرح سمجھنا ضروری روزمرہ کا علم ہے: کہ marshaling/unmarshaling کیسے کام کرتے ہیں، اہم اصول کہ **صرف exported fields سیریلائز ہوتے ہیں**، اور خاص طور پر **struct tags** (JSON key names کو `json:"..."` کے ساتھ کنٹرول کرتے ہوئے، `omitempty` خالی values کو skip کرنے کے لیے، `-` exclude کرنے کے لیے) جو snake_case جیسی real-world API conventions سے match کرنے کے لیے ضروری ہیں۔

`Unmarshal` کو pointer pass کرنا، dynamic JSON کو maps/`interface{}` کے ذریعے handle کرنا (gotcha کے ساتھ کہ JSON numbers `float64` میں decode ہوتے ہیں)، اور HTTP bodies کے لیے streaming `Encoder`/`Decoder` استعمال کرنا APIs بنانے کی عملی ضروریات کو cover کرتا ہے۔

یہ Go backend کام کا مسلسل، عملی حصہ ہے۔