আপনি কীভাবে Go-তে JSON এনকোড/ডিকোড করবেন?

Question

Accepted Answer

Go-এর স্ট্যান্ডার্ড লাইব্রেরি **`encoding/json`** প্যাকেজ JSON সিরিয়ালাইজেশন (মার্শালিং) এবং ডিসিরিয়ালাইজেশন (আনমার্শালিং) পরিচালনা করে, Go স্ট্রাক্ট এবং JSON এর মধ্যে ম্যাপিং করে। **Struct ট্যাগ** ফিল্ড নেমিং নিয়ন্ত্রণ করে, এবং এটি বেশিরভাগ Go ওয়েব API-এর মেরুদণ্ড।

## 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 বাইটে রূপান্তরিত করে। **শুধুমাত্র এক্সপোর্টেড (বড় অক্ষর দিয়ে শুরু) ফিল্ড সিরিয়ালাইজ করা হয়** — আনএক্সপোর্টেড ফিল্ড বাদ দেওয়া হয়।

## Struct ট্যাগের ভূমিকা

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

ট্যাগ ছাড়াই, JSON কী ডিফল্টভাবে সঠিক (বড় অক্ষর দিয়ে শুরু) ফিল্ড নামের সাথে ম্যাপ হয়। ট্যাগ আপনাকে JSON কী নাম নিয়ন্ত্রণ করতে, খালি মান বাদ দিতে (`omitempty`), এবং ফিল্ড সম্পূর্ণভাবে বাদ দিতে (`-`) দেয় — API কনভেনশন ম্যাচ করার জন্য অপরিহার্য (যেমন snake_case JSON)।

## 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-এ পার্স করে — আপনাকে একটি **পয়েন্টার** পাস করতে হবে যাতে এটি struct পপুলেট করতে পারে। ফিল্ড ট্যাগ/নাম দ্বারা ম্যাচ করা হয় (case-insensitively)।

## অজানা/ডায়নামিক 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 with 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)
```

ওয়েব সার্ভারের জন্য, `Encoder`/`Decoder` সরাসরি স্ট্রীমের সাথে কাজ করে (রিকোয়েস্ট/রেসপন্স বডি) — এটি হ্যান্ডলারে সাধারণ প্যাটার্ন।

## এটি কেন গুরুত্বপূর্ণ

JSON এনকোডিং/ডিকোডিং প্রায় সমস্ত Go ওয়েব ডেভেলপমেন্টের জন্য মৌলিক — REST API, মাইক্রোসার্ভিসেস, এবং কনফিগারেশন সবই Go স্ট্রাক্ট এবং JSON এর মধ্যে কনভার্সনের উপর নির্ভর করে।

`encoding/json` প্যাকেজ (স্ট্যান্ডার্ড লাইব্রেরি, কোনো নির্ভরতা নেই) স্ট্যান্ডার্ড টুল, এবং এটি ভালভাবে বোঝা অপরিহার্য দৈনন্দিন জ্ঞান: মার্শালিং/আনমার্শালিং কীভাবে কাজ করে, গুরুত্বপূর্ণ নিয়ম যে **শুধুমাত্র এক্সপোর্টেড ফিল্ড সিরিয়ালাইজ করা হয়**, এবং বিশেষত **struct ট্যাগ** (JSON কী নাম নিয়ন্ত্রণ করে `json:"..."` দিয়ে, `omitempty` দিয়ে খালি মান স্কিপ করতে, `-` দিয়ে এক্সক্লুড করতে) যা বাস্তব-বিশ্বের API কনভেনশন ম্যাচ করার জন্য প্রয়োজন যেমন snake_case।

`Unmarshal` এ পয়েন্টার পাস করা জানা, ডায়নামিক JSON ম্যাপ/`interface{}` এর মাধ্যমে পরিচালনা করা (JSON নম্বর `float64` তে ডিকোড হওয়ার সমস্যা সহ), এবং HTTP বডির জন্য স্ট্রীমিং `Encoder`/`Decoder` ব্যবহার করা API বিল্ডিংয়ের প্রায়োগিক চাহিদা কভার করে।

এটি Go ব্যাকএন্ড কাজের একটি ধ্রুবক, প্রায়োগিক অংশ।