I-convert ang JSON sa mga Go struct definition na may encoding/json tag. Sinusunod ng mga field name ang exported-name rule ng Go at ang initialism list ng golint (ID, URL, API, ...), at naka-align ang mga column na para bang dumaan na sa gofmt ang code.
Magagamit ito kapag kailangan mo ng type na paglalagyan ng json.Unmarshal para sa isang webhook payload o API response, ng request-body struct para sa mga handler ng net/http, Gin o Echo, o ng config struct para sa isang CLI.
omitempty.Pangalan ng struct ang pangalan ng top-level struct (default Root); nananatili ito sa URL bilang ?name=..go file at magdagdag ng package clause. Kung may nakitang time field, kasama na ang import "time".var ev WebhookEvent; err := json.Unmarshal(body, &ev).{
"event_id": "evt_1Pq",
"type": "invoice.paid",
"created_at": "2024-05-01T03:15:00Z",
"amount_cents": 4999,
"customer": { "id": "cus_9", "email": "kim@example.com" },
"retry_count": null
}import "time"
type WebhookEvent struct {
EventID string `json:"event_id"`
Type string `json:"type"`
CreatedAt time.Time `json:"created_at"`
AmountCents int `json:"amount_cents"`
Customer Customer `json:"customer"`
RetryCount any `json:"retry_count,omitempty"`
}
type Customer struct {
ID string `json:"id"`
Email string `json:"email"`
}
Nagiging EventID ang event_id ayon sa initialism rule ng golint, at ini-infer bilang time.Time ang created_at, na isang RFC 3339 string, kaya naidadagdag ang import "time". null ang retry_count, kaya hindi alam ang type nito: nagiging any ito na may omitempty.
json:"originalKey" ang bawat field, at may ,omitempty ang mga field na wala sa ilang row o may laman na null.*int) ang mga optional na value type (int, string, bool, mga struct, time.Time) para maiba ang "wala" sa zero value. Nilable na ang mga slice at any kaya hindi sila ginagawang pointer.int para sa 32-bit na integer, int64 kapag lampas doon, float64 kapag may decimal.time.Time ang mga RFC 3339 string gaya ng 2024-05-01T03:15:00Z.user_id → UserID, home_url → HomeURL); nilalagyan ng prefix na Field ang mga key na nagsisimula sa digit."", at inililista sila sa isang comment sa itaas ng struct.[]Root.Bumuo ng struct mula sa sample event na ipinadala ng isang payment o Git hosting service at i-decode ito gamit ang json.NewDecoder(r.Body).Decode(&ev), sa halip na paulit-ulit na type assertion sa map[string]any.
I-generate ang struct para sa c.ShouldBindJSON(&req) mula sa isang client request sample, saka idagdag ang mga tag na binding:"required" kung saan kailangan.
Gawing struct ang config.json nang isang beses, at sa iisang json.Unmarshal pagkatapos ng os.ReadFile, makukuha mo ang buong config bilang mga typed na value.
time.Time; nananatiling string o int ang mga value gaya ng 2024-05-01 03:15:00 o mga Unix timestamp.json.Unmarshal ang mga hindi kilalang key at case-insensitive ang pag-match ng mga key. Gamitin ang Decoder.DisallowUnknownFields() kung gusto mo ng mahigpit na decoding.int sa mga 64-bit na platform, pero isinusulat lang ang int64 kapag lampas sa 32 bits ang isang sample value. Para sa mga ID na puwedeng lumaki, mas ligtas na ikaw na mismo ang magpalit sa int64.any ang mga value na halo ang type at ang mga value na laging null lang; palitan sila kapag alam na ang totoong type.*int ang mga optional na field?Ang simpleng int field ay 0 kapag nawawala ang key, kaya hindi ito maiba sa totoong 0. nil naman ang pointer kapag wala ang key o null ito, at kasama ang omitempty, hindi na isinasama ang key kapag nag-marshal ulit.
Mga exported (naka-capital) na field lang ang binabasa at sinusulat ng encoding/json; hindi pinapansin ang mga lowercase na field kahit may tag. Sa Go, naka-capital ang mga pangalan at nasa tag ang JSON key.
any ang isang null field gaya ng retry_count.Kapag null lang ang nasa sample, walang mapagbabatayan ng type. Magdagdag sa isang array ng isa pang response na may totoong value at i-convert silang dalawa, o mano-manong palitan ito ng gaya ng *int.
Oo. I-paste ang struct sa tab na Go struct → JSON sa itaas; binabasa nito ang mga tag at gumagawa ng halimbawang JSON.