Chuyển JSON thành định nghĩa struct Go kèm tag encoding/json. Tên field theo quy tắc tên export của Go và danh sách từ viết tắt của golint (ID, URL, API, ...), các cột được căn thẳng như thể code đã qua gofmt.
Công cụ hữu ích khi bạn cần một kiểu để json.Unmarshal payload webhook hay response API vào, một struct body request cho handler net/http, Gin hoặc Echo, hay một struct cấu hình cho CLI.
omitempty.Tên struct (mặc định Root); nó được giữ trong URL dưới dạng ?name=..go và thêm mệnh đề package. Nếu phát hiện field thời gian, import "time" sẽ được thêm vào.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"`
}
event_id thành EventID theo quy tắc từ viết tắt của golint, còn created_at, một chuỗi RFC 3339, được suy ra là time.Time, kéo theo import "time". retry_count là null nên không rõ kiểu: nó thành any kèm omitempty.
json:"originalKey" trên mọi field, cộng thêm ,omitempty cho field thiếu ở một số dòng hoặc chứa null.int, string, bool, struct, time.Time) thành con trỏ (*int) để "không có" khác với giá trị zero. Slice và any vốn đã có thể nil nên không thành con trỏ.int cho số nguyên 32 bit, int64 khi vượt quá, float64 khi có số thập phân.2024-05-01T03:15:00Z được suy ra là time.Time.user_id → UserID, home_url → HomeURL); key bắt đầu bằng chữ số nhận tiền tố Field."", bị bỏ qua và được liệt kê trong comment phía trên struct.[]Root.Dựng struct từ một event mẫu do dịch vụ thanh toán hay Git hosting gửi đến và decode bằng json.NewDecoder(r.Body).Decode(&ev), thay vì type assertion liên tục trên map[string]any.
Tạo struct cho c.ShouldBindJSON(&req) từ request mẫu của client, rồi thêm tag binding:"required" ở chỗ cần.
Biến config.json thành struct một lần, rồi chỉ một lời gọi json.Unmarshal sau os.ReadFile là có toàn bộ cấu hình dưới dạng giá trị có kiểu.
time.Time chỉ được suy ra cho chuỗi RFC 3339; giá trị như 2024-05-01 03:15:00 hay Unix timestamp vẫn là string hoặc int.json.Unmarshal mặc định bỏ qua key lạ và so khớp key không phân biệt hoa/thường. Dùng Decoder.DisallowUnknownFields() nếu muốn decode chặt chẽ.int là 64 bit trên nền tảng 64 bit, nhưng int64 chỉ được ghi khi giá trị mẫu vượt 32 bit. Với ID có thể tăng lớn, tự đổi sang int64 sẽ an toàn hơn.null thành any; hãy thay khi đã biết kiểu thật.*int?Field int thường sẽ là 0 khi thiếu key, không phân biệt được với số 0 thật. Con trỏ là nil khi key vắng mặt hoặc là null, và cùng với omitempty, key sẽ bị bỏ ra khi bạn marshal lại.
encoding/json chỉ đọc và ghi field đã export (viết hoa); field chữ thường bị bỏ qua kể cả khi có tag. Trong Go, tên vẫn viết hoa còn key JSON nằm trong tag.
null như retry_count lại ra any.Khi mẫu chỉ có null thì không có gì để suy ra kiểu. Thêm một response khác có giá trị thật vào mảng rồi chuyển cả hai, hoặc tự đổi thành kiểu như *int.
Được. Dán struct vào tab Go struct → JSON ở phía trên; nó đọc tag và tạo JSON ví dụ.