Paketa standarde e Go encoding/json përdoret për serijalizimin (marshaling) dhe dé-serijalizimin (unmarshaling) të JSON, duke hartuar lidhjen mes strukturave Go dhe JSON. Struct tags kontrollojnë emërtimin e fushave, dhe është themeli i shumicës së API-ve web Go.
User {
Name
Email
Age
private
}
u := User{Name: , Email: , Age: }
data, err := json.Marshal(u)
fmt.Println((data))
json.Marshal konverton një strukturë në bajt JSON. Vetëm fushat e eksportuara (me shkronjë të madhe) serijalizohen — fushat e paeksportuara përjashtohen.
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
}
Pa tag, çelësat JSON parazgjedhje merren nga emri i saktë i fushës (me shkronjë të madhe). Tag-et të lejojnë të kontrolloni emrin e çelësit JSON, të hiqni vlerat boshe (omitempty), dhe të përjashtoni fushat plotësisht (-) — thelbësore për të përputhur konvencionet e API-ve (p.sh. 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 i analizon JSON në një strukturë — duhet të kaloni një pointer në mënyrë që të mund të populloni strukturën. Fushat përputhen sipas tag/emrit (pa dallim madhësie të shkronjave).
// 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)
Për serverët web, Encoder/Decoder punojnë drejtpërdrejt me rrjedhat (request/response bodies) — modeli i zakonshëm në handlers.
Kodimi/dekodimi i JSON është themelor për praktikisht të gjithë zhvillimin e web në Go — REST API, microservices, dhe konfigurimi — të gjitha mbështeten në konvertimin mes strukturave Go dhe JSON.
Paketa encoding/json (biblioteka standarde, pa varësi të jashtme) është mjeti standard, dhe të kuptoni atë mirë është njohuri esenciale e përditshme: si funksionon marshaling/unmarshaling, rregulla kritike se vetëm fushat e eksportuara serijalizohen, dhe veçanërisht struct tags (kontrollimi i emrave të çelësave JSON me json:"...", omitempty për të anashkaluar vlerat boshe, - për të përjashtuar) të cilat janë të nevojshme për të përputhur konvencionet e botës reale të API-ve si snake_case.
Të dini të kaloni një pointer në Unmarshal, të trajtoni JSON dinamik përmes map/interface{} (me gotcha-n se numrat JSON dekodohen si float64), dhe të përdorni streaming Encoder/Decoder për HTTP bodies mbuloni nevojat praktike të ndërtimit të API-ve.
Ishte një pjesë e vazhdueshme dhe praktike e punës në backend të Go.