Tag bidang dan JSON

Tag pada bidang struct adalah string metadata, dibaca melalui refleksi oleh perpustakaan seperti encoding/json, encoding/xml, validator, ORM. Mereka ditulis di antara backticks (string mentah) tepat setelah jenis kolom.

Sintaksis

type User struct {
    Name string `json:"nome"`
    Age  int    `json:"eta,omitempty"`
}

Konvensi format: key:"value" dipisahkan dengan spasi (BUKAN koma) untuk beberapa kunci:

type User struct {
    Email string `json:"email" validate:"required,email"`
}

tag json: opsi

Opsi paling umum adalah json, digunakan oleh encoding/json:

type User struct {
    Name     string `json:"nome"`
    Age      int    `json:"eta,omitempty"`
    Password string `json:"-"`
}

u := User{Name: "Ada", Age: 0, Password: "segreto"}
b, _ := json.Marshal(u)
fmt.Println(string(b))   // {"nome":"Ada"}

Age dihilangkan (nilai nol 0 + omitempty); Password adalah dikecualikan seluruhnya.

Marsekal dan Unmarshal

// struct -> JSON
b, err := json.Marshal(u)

// JSON -> struct (needs a POINTER)
var u2 User
err = json.Unmarshal(b, &u2)

Unmarshal hanya menerima pointer, karena harus ditulis ke dalam bidang nilai.

Tag umum lainnya

• xml:"..." — encoding/xml
• yaml:"..." — yaml.v3
• db:"..." — sqlx / halx
• validate:"..." — buka taman bermain/validator
• form:"..." — pengikatan gin / gema

Perpustakaan membacanya melalui refleksi (reflect.StructTag.Get("json")): itu hanyalah string sampai seseorang menafsirkannya.

Cobalah

u := User{Name: "Ada", Age: 36}
b, _ := json.Marshal(u)
fmt.Println(string(b))

Rekap

• Tag adalah string mentah di antara backtick: `key:"value" kunci2:"nilai2"`.
• json:"nama": rename. omitempty: omit if zero value. -: exclude.
• NON-exported (lowercase) fields are ignored by encoding/json.
• json.Marshal(v) ↔ json.Unmarshal(data, &v) (pointer).
• Same mechanism for xml, yaml, db, validasi, form, …