Balíček encoding/json ze standardní knihovny Go řeší serializaci JSON (marshaling) a deserializaci (unmarshaling), a mapuje mezi Go strukturami a JSON. Struct tagy kontrolují pojmenování polí a jsou páteří většiny Go webových API.
User {
Name
Email
Age
private
}
u := User{Name: , Email: , Age: }
data, err := json.Marshal(u)
fmt.Println((data))
json.Marshal konvertuje strukturu na JSON bytes. Serializují se pouze exportovaná (velká písmena) pole — neexportovaná pole se přeskakují.
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
}
Bez tagů se JSON klíče defaultně shodují s přesným (velkým) jménem pole. Tagy vám umožňují kontrolovat jméno JSON klíče, vynechat prázdné hodnoty (omitempty) a zcela vyloučit pole (-) — nezbytné pro shodu s konvencemi API (např. 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 parsuje JSON do struktury — musíte předat pointer, aby mohl strukturu vyplnit. Pole se spárují podle tagu/jména (bez rozlišení velkých a malých písmen).
// 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)
Pro webové servery Encoder/Decoder pracují přímo se streamy (request/response bodies) — běžný vzor v handlery.
Kódování/dekódování JSON je základní pro prakticky všechen Go webový vývoj — REST API, mikroslužby a konfigurace se všechny spoléhají na konverzi mezi Go strukturami a JSON.
Balíček encoding/json (standardní knihovna, bez závislostí) je standardní nástroj a dobré jeho pochopení je nezbytné každodenní znalostí: jak marshaling/unmarshaling funguje, kritické pravidlo, že serializují se pouze exportovaná pole, a zvláště struct tagy (kontrola JSON klíčů pomocí json:"...", omitempty pro přeskočení prázdných hodnot, - pro vyloučení) které jsou potřebné pro shodu se skutečnými konvencemi API jako snake_case.
Znalost toho, jak předat pointer na Unmarshal, zpracovat dynamický JSON přes mapy/interface{} (s gotchou, že JSON čísla se dekódují na float64), a používat streaming Encoder/Decoder pro HTTP bodies, pokrývá praktické potřeby budování API.
Je to konstantní, praktická součást Go backend práce.