Ubah JSON menjadi struct Go!

Masukkan JSON untuk mengubahnya menjadi struct Go dengan tag json! Mendukung Go (Golang) struct, json tags.
JSON
Hasil

Ubah JSON menjadi struct Go!

Konversikan JSON menjadi definisi struct Go dengan tag encoding/json. Nama field mengikuti aturan nama ekspor Go dan daftar initialism golint (ID, URL, API, ...), dan kolom-kolomnya disejajarkan seolah kode sudah melewati gofmt.

Berguna ketika Anda butuh tipe untuk json.Unmarshal payload webhook atau respons API, struct body request untuk handler net/http, Gin, atau Echo, atau struct config untuk sebuah CLI.

Cara menggunakan

  1. Tempel JSON. Dengan array berisi beberapa baris, field yang tidak ada di sebagian baris terdeteksi dan diberi tag omitempty.
  2. Isi nama struct tingkat atas di Nama struct (default Root); nama ini tersimpan di URL sebagai ?name=.
  3. Tempel hasilnya ke file .go dan tambahkan klausa package. Jika ada field waktu yang ditemukan, import "time" ikut disertakan.
  4. Gunakan sebagai var ev WebhookEvent; err := json.Unmarshal(body, &ev).

Contoh

Input (JSON)
{
  "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
}
Output (Go)
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 menjadi EventID sesuai aturan initialism golint, dan created_at, sebuah string RFC 3339, disimpulkan sebagai time.Time, yang menambahkan import "time". retry_count bernilai null, jadi tipenya tidak diketahui: menjadi any dengan omitempty.

Fitur yang didukung

  • Tag json:"originalKey" di setiap field, ditambah ,omitempty untuk field yang tidak ada di sebagian baris atau berisi null.
  • Tipe nilai opsional (int, string, bool, struct, time.Time) menjadi pointer (*int) agar "tidak ada" berbeda dari zero value. Slice dan any sudah bisa nil sehingga tetap bukan pointer.
  • Angka: int untuk integer 32-bit, int64 jika melebihinya, float64 jika muncul desimal.
  • String RFC 3339 seperti 2024-05-01T03:15:00Z disimpulkan sebagai time.Time.
  • Initialism umum tetap huruf kapital (user_id → UserID, home_url → HomeURL); key yang diawali angka diberi prefix Field.
  • Key yang tidak bisa muncul di tag json Go, seperti "", dilewati dan dicantumkan di komentar di atas struct.
  • Array objek tingkat atas menjadi struct untuk elemennya ditambah komentar untuk unmarshal ke []Root.

Kasus penggunaan

Penerima webhook

Buat struct dari contoh event yang dikirim layanan pembayaran atau Git hosting dan decode dengan json.NewDecoder(r.Body).Decode(&ev), alih-alih type assertion berulang pada map[string]any.

Binding request di Gin atau Echo

Buat struct untuk c.ShouldBindJSON(&req) dari contoh request client, lalu tambahkan tag binding:"required" di tempat yang diperlukan.

CLI yang membaca config JSON

Ubah config.json menjadi struct sekali saja, dan satu json.Unmarshal setelah os.ReadFile memberi Anda seluruh config sebagai nilai bertipe.

Catatan dan batasan

  • time.Time hanya disimpulkan untuk string RFC 3339; nilai seperti 2024-05-01 03:15:00 atau Unix timestamp tetap string atau int.
  • json.Unmarshal secara default mengabaikan key yang tidak dikenal dan mencocokkan key tanpa membedakan huruf besar-kecil. Gunakan Decoder.DisallowUnknownFields() jika Anda ingin decoding yang ketat.
  • int berukuran 64-bit di platform 64-bit, tetapi int64 hanya ditulis jika nilai contoh melebihi 32 bit. Untuk ID yang bisa terus bertambah, lebih aman menggantinya sendiri ke int64.
  • Struct bersarang semuanya didefinisikan sebagai tipe tingkat atas yang terpisah; tidak ada anonymous inline struct.
  • Nilai bertipe campuran dan nilai yang selalu null menjadi any; ganti setelah tipe sebenarnya diketahui.

FAQ

Mengapa field opsional berupa pointer seperti *int?

Field int biasa bernilai 0 ketika key-nya tidak ada, sehingga tidak bisa dibedakan dari 0 yang sebenarnya. Pointer bernilai nil ketika key tidak ada atau null, dan bersama omitempty key tersebut dihilangkan saat Anda melakukan marshal lagi.

Bisakah nama field dibuat huruf kecil?

encoding/json hanya membaca dan menulis field yang diekspor (berhuruf kapital); field huruf kecil diabaikan meskipun diberi tag. Di Go, nama tetap berhuruf kapital dan key JSON ditaruh di tag.

Field null seperti retry_count keluar sebagai any.

Jika contoh hanya berisi null, tidak ada yang bisa dijadikan dasar penyimpulan tipe. Tambahkan respons lain yang punya nilai sebenarnya ke dalam array lalu konversikan keduanya, atau ubah manual menjadi sesuatu seperti *int.

Bisakah struct Go diubah kembali menjadi contoh JSON?

Bisa. Tempel struct ke tab Go struct → JSON di bagian atas; tab itu membaca tag dan menghasilkan contoh JSON.