Go中JSON處理方法是什么

Go語言內建對JSON的支持。使用Go語言內置的encoding/json標準庫，開發者可以輕松使用Go程序生成和解析JSON格式的數據。在Go語言實現JSON的編碼和解碼時，遵循RFC4627協議標準。

基本的序列化

首先我們來看一下Go語言中json.Marshal()（系列化）與json.Unmarshal（反序列化）的基本用法。

type Person struct {
Name  string
Age  int64
Weight float64
}

func main() {
p1 := Person{
Name:  "小明",
Age:  18,
Weight: 71.5,
}
// struct -> json string
b, err := json.Marshal(p1)if err != nil {
fmt.Printf("json.Marshal failed, err:%v\n", err)return}
fmt.Printf("str:%s\n", b)
// json string -> struct
var p2 Person
err = json.Unmarshal(b, &p2)if err != nil {
fmt.Printf("json.Unmarshal failed, err:%v\n", err)return}
fmt.Printf("p2:%#v\n", p2)
}

輸出： str:{“Name”:”小明”,”Age”:18,”Weight”:71.5} p2:main.Person{Name:”小明”, Age:18, Weight:71.5}

結構體tag介紹

Tag是結構體的元信息，可以在運行的時候通過反射的機制讀取出來。 Tag在結構體字段的后方定義，由一對反引號包裹起來，具體的格式如下：

`key1:"value1" key2:"value2"`

結構體tag由一個或多個鍵值對組成。鍵與值使用冒號分隔，值用雙引號括起來。 同一個結構體字段可以設置多個鍵值對tag，不同的鍵值對之間使用空格分隔。

使用json tag指定字段名

序列化與反序列化默認情況下使用結構體的字段名，我們可以通過給結構體字段添加tag來指定json序列化生成的字段名。

// 使用json tag指定序列化與反序列化時的行為type Person struct {
Name  string `json:"name"` // 指定json序列化/反序列化時使用小寫name
Age  int64
Weight float64
}

忽略某個字段

如果你想在json序列化/反序列化的時候忽略掉結構體中的某個字段，可以按如下方式在tag中添加-。

// 使用json tag指定json序列化與反序列化時的行為type Person struct {
Name  string `json:"name"` // 指定json序列化/反序列化時使用小寫name
Age  int64
Weight float64 `json:"-"` // 指定json序列化/反序列化時忽略此字段
}

忽略空值字段

當 struct 中的字段沒有值時， json.Marshal() 序列化的時候不會忽略這些字段，而是默認輸出字段的類型零值（例如int和float類型零值是 0，string類型零值是””，對象類型零值是 nil）。如果想要在序列序列化時忽略這些沒有值的字段時，可以在對應字段添加omitempty tag。 舉個例子：

type User struct {
Name string  `json:"name"`
Email string  `json:"email"`
Hobby []string `json:"hobby"`
}

func omitemptyDemo() {
u1 := User{
Name: "小明",
}
// struct -> json string
b, err := json.Marshal(u1)if err != nil {
fmt.Printf("json.Marshal failed, err:%v\n", err)return}
fmt.Printf("str:%s\n", b)
}

輸出結果： str:{“name”:”小明”,”email”:””,”hobby”:null}

如果想要在最終的序列化結果中去掉空值字段，可以像下面這樣定義結構體：

// 在tag中添加omitempty忽略空值
// 注意這里 hobby,omitempty 合起來是json tag值，中間用英文逗號分隔type User struct {
Name string  `json:"name"`
Email string  `json:"email,omitempty"`
Hobby []string `json:"hobby,omitempty"`
}

此時，再執行上述的omitemptyDemo，輸出結果如下： str:{“name”:”小明”} // 序列化結果中沒有email和hobby字段

說句題外話，我們使用gorm操作數據庫的話，經常會遇到想忽略指定字段修改的問題，比如結構體中的關聯實體，只想json展示，form提交時忽略實體，這種問題我會單獨整理一篇出來。

忽略嵌套結構體空值字段

首先來看幾種結構體嵌套的示例：

type User struct {
Name string  `json:"name"`
Email string  `json:"email,omitempty"`
Hobby []string `json:"hobby,omitempty"`
Profile
}type Profile struct {
Website string `json:"site"`
Slogan string `json:"slogan"`
}

func nestedStructDemo() {
u1 := User{
Name: "小明",
Hobby: []string{"足球", "籃球"},
}
b, err := json.Marshal(u1)if err != nil {
fmt.Printf("json.Marshal failed, err:%v\n", err)return}
fmt.Printf("str:%s\n", b)
}

匿名嵌套Profile時序列化后的json串為單層的： str:{“name”:”小明”,”hobby”:[“足球”,”藍球”],”site”:””,”slogan”:””}

想要變成嵌套的json串，需要改為具名嵌套或定義字段tag：

type User struct {
Name  string  `json:"name"`
Email  string  `json:"email,omitempty"`
Hobby  []string `json:"hobby,omitempty"`
Profile `json:"profile"`
}
// str:{"name":"小明","hobby":["足球","籃球"],"profile":{"site":"","slogan":""}}

想要在嵌套的結構體為空值時，忽略該字段，僅添加omitempty是不夠的：

type User struct {
Name   string  `json:"name"`
Email  string  `json:"email,omitempty"`
Hobby  []string `json:"hobby,omitempty"`
Profile `json:"profile,omitempty"`
}
// str:{"name":"小明","hobby":["足球","籃球"],"profile":{"site":"","slogan":""}}

還需要使用嵌套的結構體指針：

type User struct {
Name   string  `json:"name"`
Email  string  `json:"email,omitempty"`
Hobby  []string `json:"hobby,omitempty"`
*Profile `json:"profile,omitempty"` //這里是重點
}
// str:{"name":"小明","hobby":["足球","籃球"]}

不修改原結構體忽略空值字段

我們需要json序列化User，但是不想把密碼也序列化，又不想修改User結構體，這個時候我們就可以使用創建另外一個結構體PublicUser匿名嵌套原User，同時指定Password字段為匿名結構體指針類型，并添加omitemptytag，示例代碼如下：

type User struct {
Name   string `json:"name"`
Password string `json:"password"`
}type PublicUser struct {
*User       // 匿名嵌套
Password *struct{} `json:"password,omitempty"`
}

func omitPasswordDemo() {
u1 := User{
Name:   "小明",
Password: "123456",
}
b, err := json.Marshal(PublicUser{User: &u1})if err != nil {
fmt.Printf("json.Marshal u1 failed, err:%v\n", err)return}
fmt.Printf("str:%s\n", b) // str:{"name":"小明"}
}

優雅處理字符串格式的數字

有時候，前端在傳遞來的json數據中可能會使用字符串類型的數字，這個時候可以在結構體tag中添加string來告訴json包從字符串中解析相應字段的數據：

type Card struct {
ID  int64  `json:"id,string"`  // 添加string tag
Score float64 `json:"score,string"` // 添加string tag
}

func intAndStringDemo() {
jsonStr1 := `{"id": "1234567","score": "88.50"}`
var c1 Cardif err := json.Unmarshal([]byte(jsonStr1), &c1); err != nil {
fmt.Printf("json.Unmarsha jsonStr1 failed, err:%v\n", err)return}
fmt.Printf("c1:%#v\n", c1) // c1:main.Card{ID:1234567, Score:88.5}
}