I-convert ang mga Go struct sa JSON!

Maglagay ng Go struct para gumawa ng halimbawang JSON ayon sa mga json tag nito! Sinusuportahan ang Go (Golang) struct, json tags. Magagamit sa API docs at test request body (mock request body).
Go struct
Resulta
 

I-convert ang mga Go struct sa JSON!

I-paste ang mga Go struct definition at makakakuha ka ng halimbawang JSON document na binuo gamit ang parehong rules na ina-apply ng encoding/json sa pag-marshal: mga tag name na json:"...", mga field na itinago gamit ang -, ang ,string option, mga unexported na lowercase field at mga flattened na embedded struct.

Magagamit ito sa paggawa ng curl body mula sa isang Gin, Echo o net/http request struct, sa paghahanda ng sample para sa gRPC-Gateway o REST docs, at sa pagtukoy ng mga field na hindi lumalabas ang key na inaasahan mo dahil sa tag nila.

Paano gamitin

  1. I-paste ang mga declaration na type Xxx struct { ... }. Ayos lang ang mga grouped na type ( ... ) block at maraming struct nang sabay.
  2. Kung gumagamit ang isang field ng ibang struct, isama rin ang definition nito. Nagiging null ang mga type mula sa external package na wala sa input (gaya ng decimal.Decimal).
  3. Walang option: ang unang struct na hindi nire-reference ng ibang type ang top-level na JSON, kaya ilagay sa unahan ang gusto mo o huwag isama ang mga walang kaugnayang struct.
  4. Kopyahin ang resulta papunta sa curl -d, Postman body o isang handler test na batay sa httptest.

Halimbawa

Input (Go struct)
type Base struct {
	ID        string    `json:"id"`
	CreatedAt time.Time `json:"created_at"`
}

type Job struct {
	Base
	Queue      string            `json:"queue"`
	Attempts   int               `json:"attempts,string"`
	Labels     map[string]string `json:"labels,omitempty"`
	TimeoutSec *int              `json:"timeout_sec,omitempty"`
	Token      string            `json:"-"`
	Done       bool
	lastErr    error
}
Output (JSON)
{
  "id": "",
  "created_at": "0001-01-01T00:00:00Z",
  "queue": "",
  "attempts": "0",
  "labels": {
    "key": ""
  },
  "timeout_sec": 0,
  "Done": false
}

Direktang nag-aambag ng id at created_at sa Job ang embedded na Base, at nagiging string na "0" sa halip na numero ang Attempts na may tag na ,string. Tinatanggal ang Token (tag na -) at ang unexported na lastErr, habang napapanatili ng walang tag na Done ang Go field name nito bilang key. Ipinapakita ng time.Time ang zero value ng Go, 0001-01-01T00:00:00Z.

Mga sinusuportahang feature

  • Ginagamit ang tag na json:"name" bilang key, at bumabalik sa eksaktong field name kapag walang tag.
  • Nilalaktawan ang mga field na json:"-" at mga unexported na lowercase field; pinapanatili ng json:"-," ang field sa ilalim ng literal na key na -.
  • Kapag may ,string, binabalot bilang string ang mga numeric at boolean field, gaya ng "0" at "false".
  • Fina-flatten sa parent ang mga embedded struct na walang tag, at nananaig ang mga outer field kapag nagkapareho ang pangalan; nagiging nested object sa ilalim ng pangalang iyon ang embedded struct na may tag.
  • Pinupunan ng type na tinuturo ang mga pointer (*int, *Profile), at sinusunod ng mga defined type gaya ng type Status string ang underlying type nila.
  • Nagiging Base64 (empty) string ang []byte, gumagamit ng key na "0" ang map[int]T, ang time.Duration ay ang nanosecond integer na 0, at null ang interface{}/any.
  • Humihinto sa empty array ang mga self-referencing struct gaya ng Children []Node. Suportado ang mga anonymous na nested struct field.

Mga gamit

Mga request body para sa handler test

I-paste ang struct na bina-bind mo gamit ang c.ShouldBindJSON(&req), i-generate ang body, at tawagin ang endpoint gamit ang httptest.NewRequest o curl. Dahil direktang galing sa mga tag ang mga key, mas maliit ang tsansa ng binding mismatch.

Paghahanap ng mga mali sa tag

Agad na halata sa output ang halo-halong tag na json:"user_id" at json:"userId", o ang nakalimutang tag na naglalabas ng uppercase na key na UserID.

Pagbabahagi ng schema sa mga client sa ibang language

Ibigay sa mga frontend o Python consumer ang JSON mula sa Go response struct mo; maibabalik nila ito sa mga model gamit ang mga tool gaya ng JSON → TypeScript o JSON → Python.

Mga paalala at limitasyon

  • Laging ipinapakita sa sample ang mga field na may omitempty; sa totoong marshaling, tinatanggal sila kapag zero value ang laman.
  • Nagma-marshal bilang null ang isang nil pointer, pero ang kasong may laman ang ipinapakita ng sample.
  • Hindi malalaman at hindi naipapakita ang mga type na may custom na MarshalJSON() at ang totoong laman ng json.RawMessage.
  • Hindi sakop ang mga mas bagong option gaya ng omitzero ng Go 1.24 at ang behavior ng encoding/json/v2.

Mga madalas itanong

Anong key ang nakukuha ng field na walang tag?

Ginagamit ng encoding/json ang exported na field name nang eksakto, kaya nagiging "Done" ang Done bool. Case-insensitive ang matching kapag nagde-decode sa Go, pero hindi ganoon ang mga client sa ibang language, kaya mas ligtas ang mga explicit na tag.

Bakit taong 0001 ang naka-set sa time.Time?

Ang zero na time.Time ng Go ay 0001-01-01 00:00:00 UTC, na nagma-marshal sa RFC 3339 bilang 0001-01-01T00:00:00Z. Kaya iba ito sa mga petsang 1970 sa ibang page na → JSON.

Kailan magagamit ang json:",string"?

Kadalasan para sa malalaking int64 ID na hindi eksaktong kayang i-represent ng JavaScript, kaya ipinapadala sila bilang string. "0" ang ipinapakita ng sample, kaya malinaw sa mga client na string ang matatanggap nila.

Ang kabaligtaran ang gusto ko: Go struct mula sa JSON.

Gamitin ang page na JSON → Go struct. Kapag ibinalik ang output nito sa page na ito, mabilis mong masusuri kung napapanatili ng round trip ang mga orihinal na key.