Golang中 json tag 標簽的作用和用法講解

結構體的tag

tag是結構體的元信息，運行時通過反射機制讀取。結構體的tag一般定義在相應字段的后面，格式為：

fieldName fieldType  `key1:"value1" key2:"value2"`

同一個結構體字段可以設置多個鍵值對tag，不同的鍵值對之間使用空格分隔。

json tag

默認情況下序列化與反序列化使用的都是結構體的原生字段名，可以通過給結構體字段添加json tag來指定序列化后的字段名。標簽冒號前是類型，后面是標簽名。
例如代碼：

// Product _
type Product struct {
    Name      string  `json:"name"`
    ProductID int64   `json:"-"` // 表示不進行序列化
    Number    int     `json:"number"`
    Price     float64 `json:"price"`
    IsOnSale  bool    `json:"is_on_sale,string"`
}
 
// 序列化過后，可以看見
   {"name":"Xiao mi 6","number":10000,"price":2499,"is_on_sale":"false"}

omitempty，tag里面加上omitempy，可以在序列化的時候忽略0值或者空值。注意此時在“omitempty”前一定指定一個字段名，否則“omitempty”將作為字段名處理。

注意： `json:"product_id,omitempty"` ，omitempty前面和逗號之間不能有空格！

package main
 
import (
    "encoding/json"
    "fmt"
)
 
// Product _
type Product struct {
    Name      string  `json:"name"`
    ProductID int64   `json:"product_id,omitempty"`
    Number    int     `json:"number"`
    Price     float64 `json:"price"`
    IsOnSale  bool    `json:"is_on_sale,omitempty"`
}
 
func main() {
    p := &Product{}
    p.Name = "Xiao mi 6"
    p.IsOnSale = false
    p.Number = 10000
    p.Price = 2499.00
    p.ProductID = 0
 
    data, _ := json.Marshal(p)
    fmt.Println(string(data))
}
// 結果（省略掉了p.IsOnSale 和 p.ProductID）
{"name":"Xiao mi 6","number":10000,"price":2499}

若要在被嵌套結構體整體為空時使其在序列化結果中被忽略，不僅要在被嵌套結構體字段后加上json:"fileName,omitempty"，還要將其改為結構體指針。如：

package main

import (
    "encoding/json"
    "fmt"
)

type BodyInfo struct {
    Weight float64
    Height float64
}

type Student struct {
    Name      string `json:"name"`
    Age       int64
    *BodyInfo `json:"bodyinfo,omitempty"`
}

func main() {
    s1 := Student{
        Name: "jack",
        Age:  20,
    }

    data, _ := json.Marshal(s1)
    fmt.Println(string(data))
}

//結果
{"name":"jack","Age":20}

`json:",inline"`通常作用於內嵌的結構體類型，具體用法看下面這個例子：

package main

import (
    "encoding/json"
    "fmt"
)

type Project struct {
    Key   string `json:"key"`
    Value string `json:"value"`
}

type JiraHttpReqField struct {
    Project     `json:"project"`   // `json:",inline"`
    Summary     string `json:"summary"`
    Description string `json:"description"`
}

func main() {
    dataProject := Project{
        Key:   "name",
        Value: "zhangsan",
    }
    dataJiraHttpReqField := &JiraHttpReqField{
        Project:     dataProject,
        Summary:     "my summary",
        Description: "my description",
    }
    data, _ := json.Marshal(dataJiraHttpReqField)
    fmt.Println(string(data))
}

14行為`json:"project"`時的輸出結果：
{"project":{"key":"name","value":"zhangsan"},"summary":"my summary","description":"my description"}

14行為`json:",inline"`時的輸出結果：
{"key":"name","value":"zhangsan","summary":"my summary","description":"my description"}

 

type，有些時候，我們在序列化或者反序列化的時候，可能結構體類型和需要的類型不一致，這個時候可以指定,支持string,number和boolean

package main
 
import (
    "encoding/json"
    "fmt"
)
 
// Product _
type Product struct {
    Name      string  `json:"name"`
    ProductID int64   `json:"product_id,string"`
    Number    int     `json:"number,string"`
    Price     float64 `json:"price,string"`
    IsOnSale  bool    `json:"is_on_sale,string"`
}
 
func main() {
 
    var data = `{"name":"Xiao mi 6","product_id":"10","number":"10000","price":"2499","is_on_sale":"true"}`
    p := &Product{}
    err := json.Unmarshal([]byte(data), p)
    fmt.Println(err)
    fmt.Println(*p)
}
// 結果
<nil>
{Xiao mi 6 10 10000 2499 true}

 

參考文章：

GO--Json tag標簽的作用，json用法講解：https://blog.csdn.net/qq_33679504/article/details/100533703

golang-json使用（json tag）：https://blog.csdn.net/somanlee/article/details/106925278