คุณ encode/decode JSON ใน Go อย่างไร?

Question

Accepted Answer

package **`encoding/json`** ของ standard library ใน Go จัดการการ serialize JSON (marshaling) และ deserialize (unmarshaling) โดยแมประหว่าง struct ของ Go กับ JSON **struct tag** ควบคุมการตั้งชื่อ field และมันคือกระดูกสันหลังของ Go web API ส่วนใหญ่

## Marshaling: struct ของ Go → 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 byte **เฉพาะ field ที่ export (ขึ้นต้นด้วยตัวพิมพ์ใหญ่) เท่านั้นที่ถูก serialize** field ที่ไม่ export จะถูกข้าม

## บทบาทของ struct tag

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

หากไม่มี tag คีย์ JSON จะใช้ชื่อ field ตรงตามเดิม (ขึ้นต้นด้วยตัวพิมพ์ใหญ่) tag ช่วยให้คุณควบคุมชื่อคีย์ JSON, ละเว้นค่าว่าง (`omitempty`) และยกเว้น field ทั้งหมด (`-`) ซึ่งจำเป็นสำหรับการให้ตรงกับ convention ของ API (เช่น JSON แบบ snake_case)

## Unmarshaling: JSON → struct ของ Go

```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` parse JSON ลงใน struct คุณต้องส่ง **pointer** เข้าไปเพื่อให้มัน populate struct ได้ field ถูกจับคู่ตาม tag/ชื่อ (โดยไม่สนตัวพิมพ์ใหญ่เล็ก)

## การทำงานกับ JSON ที่ไม่รู้โครงสร้าง/แบบ dynamic

```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 server `Encoder`/`Decoder` ทำงานกับ stream โดยตรง (request/response body) ซึ่งเป็น pattern ที่พบบ่อยใน handler

## ทำไมจึงสำคัญ

การ encode/decode JSON เป็นพื้นฐานของแทบทุกการพัฒนา Go web ทั้ง REST API, microservice และ configuration ล้วนพึ่งพาการแปลงระหว่าง struct ของ Go กับ JSON

package `encoding/json` (standard library ไม่มี dependency) เป็นเครื่องมือมาตรฐาน และการเข้าใจมันอย่างดีเป็นความรู้พื้นฐานที่จำเป็นในทุกวัน: marshaling/unmarshaling ทำงานอย่างไร, กฎสำคัญที่ว่า **เฉพาะ field ที่ export เท่านั้นที่ถูก serialize** และโดยเฉพาะ **struct tag** (การควบคุมชื่อคีย์ JSON ด้วย `json:"..."`, `omitempty` เพื่อข้ามค่าว่าง, `-` เพื่อยกเว้น) ซึ่งจำเป็นสำหรับการให้ตรงกับ convention ของ API ในโลกจริงอย่าง snake_case

การรู้ว่าต้องส่ง pointer ให้ `Unmarshal`, การจัดการ JSON แบบ dynamic ผ่าน map/`interface{}` (พร้อมข้อควรระวังที่ตัวเลข JSON ถูก decode เป็น `float64`) และการใช้ `Encoder`/`Decoder` แบบ streaming สำหรับ HTTP body ครอบคลุมความต้องการเชิงปฏิบัติในการสร้าง API

มันเป็นส่วนหนึ่งที่คงที่และเชิงปฏิบัติของงาน Go backend