תגי שדה ו-JSON

תגיות בשדות struct הם מחרוזות מטא נתונים, הנקראות באמצעות השתקפות על ידי ספריות כמו encoding/json, encoding/xml, מאמתים, ORMs. הם נכתבים בין הסמסים (מחרוזת גולמית) מיד אחרי סוג השדה.

תַחבִּיר

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

מוסכמות עיצוב: key:"value" מופרדים ברווחים (NOT פסיקים) עבור מספר מפתחות:

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

תג json: אפשרויות

האפשרות הנפוצה ביותר היא json, בשימוש על ידי 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 מושמט (ערך אפס 0 + omitempty); Password הוא לא נכלל לחלוטין.

מרשל ואנמרשל

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

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

Unmarshal מקבל רק מצביע, מכיוון שהוא חייב לכתוב ב- השדות של הערך.

תגים נפוצים אחרים

• xml:"..." — encoding/xml
• yaml:"..." — yaml.v3
• db:"..." — sqlx / pgx
• validate:"..." - מגרש משחקים/תיקוף
• form:"..." - כריכת ג'ין / אקו

ספריות קוראים אותן באמצעות השתקפות (reflect.StructTag.Get("json")): הם רק מחרוזות עד שמישהו יפרש אותם.

נסה את זה

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

לְסַכֵּם

• תגים הם מחרוזות גולמיות בין סימנים לאחור: `key:"value" key2:"value2"`.
• json:"nome": rename. omitempty__PROTECTED_INLINE_ 28__-: exclude.
• NON-exported (lowercase) fields are ignored by encoding/json.
• json.Marshal(v) ↔ json.Unmarshal(data, &v) (pointer).
• Same mechanism for xml, yaml, db, validate, form, …