golang中json操作的完全指南

更新時(shí)間：2022年07月14日 11:58:00 作者：grb123

golang標(biāo)準(zhǔn)庫有一個(gè)名叫encoding/json的包,包含了JSON的序列化(Marshal)和反序列化(Unmarshal)的能力,下面這篇文章主要給大家介紹了關(guān)于golang中json操作的相關(guān)資料,需要的朋友可以參考下

前言

JSON是一種輕量級(jí)的數(shù)據(jù)交換格式。易于閱讀和編寫。 golang 提供了 encoding/json 包來操作JSON數(shù)據(jù)。

1. 結(jié)構(gòu)體與JSON互轉(zhuǎn)

（1）使用 json.Marshal() 方法，把結(jié)構(gòu)體轉(zhuǎn)成 JSON字符串

import (
	"encoding/json"
	"fmt"
)

type Student struct {
	Name string
	Age int
	Skill string
}

func main()  {
	stu := Student{"tom", 12, "football"}
	data, err := json.Marshal(&stu)
	if err != nil {
		fmt.Printf("序列化錯(cuò)誤 err=%v\n", err)
		return
	}
	fmt.Println("序列化后: ", string(data))
}

打?。?序列化后: {“Name”:“tom”,“Age”:12,“Skill”:“football”}

（2）JSON字符串轉(zhuǎn) 結(jié)構(gòu)體，可以使用 json.Unmarshal()方法

func main()  {
	str := `{"Name":"tom","Age":12,"Skill":"football"}`
	var stu2 Student
	err := json.Unmarshal([]byte(str), &stu2)
	if err != nil {
		fmt.Printf("反序列化錯(cuò)誤 err=%v\n", err)
		return
	}
	fmt.Printf("反序列化后: Student=%v, Name=%v\n", stu2, stu2.Name)
}

打印: 反序列化后: Student={tom 12 football}, Name=tom

（3）如何實(shí)現(xiàn)結(jié)構(gòu)體序列化后key的名稱能自定義

對(duì)于自定義key的名稱，可以給 struct變量指定一個(gè)tag標(biāo)簽

type Student struct {
	Name string   `json:"stu_name"`
	Age int       `json:"stu_age"`
	Skill string  // 也可以不指定 tag標(biāo)簽，默認(rèn)就是 變量名稱
}

func main()  {
	stu := Student{"tom", 12, "football"}
	data, err := json.Marshal(&stu)
	if err != nil {
		fmt.Printf("序列化錯(cuò)誤 err=%v\n", err)
		return
	}
	fmt.Println("序列化后: ", string(data))
}

打印后，可以看到 key的名稱已經(jīng)變成了我們指定的 tag標(biāo)簽的名稱

序列化后: {“stu_name”:“tom”,“stu_age”:12,“Skill”:“football”}

2. map與JSON互轉(zhuǎn)

func main()  {
	// map 轉(zhuǎn) Json字符串
	m := make(map[string]interface{})
	m["name"] = "jetty"
	m["age"] = 16

	data, err := json.Marshal(&m)
	if err != nil {
		fmt.Printf("序列化錯(cuò)誤 err=%v\n", err)
		return
	}
	fmt.Println("序列化后: ", string(data))    // 打印: 序列化后:  {"age":16,"name":"jetty"}

	// Json字符串 轉(zhuǎn) map
	str := `{"age":25,"name":"car"}`
	err = json.Unmarshal([]byte(str), &m)
	if err != nil {
		fmt.Printf("反序列化錯(cuò)誤 err=%v\n", err)
		return
	}
	fmt.Printf("反序列化后: map=%v, name=%v\n", m, m["name"])
	// 打印: 反序列化后: map=map[age:25 name:car], name=car
}

3. 結(jié)構(gòu)體的變量不加tag標(biāo)簽?zāi)芊裾＾D(zhuǎn)成json數(shù)據(jù)

如果變量首字母小寫，則為private。因?yàn)槿〔坏椒瓷湫畔?，不能轉(zhuǎn)。

如果變量首字母大寫，則為public。不管加不加 tag 都能正常轉(zhuǎn)，加了tag的變量就按照tag的名稱顯示。

示例：

type User struct {
	Name string    `json:"u_name"`
	age int        `json:"u_age"`
	Skill string   // 也可以不指定 tag標(biāo)簽，默認(rèn)就是 變量名稱
	addr string
}

func main()  {
	user := User{"admin", 23, "football", "上海"}
	data, err := json.Marshal(&user)
	if err != nil {
		fmt.Printf("序列化錯(cuò)誤 err=%v\n", err)
		return
	}
	fmt.Println("序列化后: ", string(data))  // 打印: 序列化后:  {"u_name":"admin","Skill":"football"}
}

通過打印，我們發(fā)現(xiàn)小寫的變量，如 age、addr 都沒有轉(zhuǎn)成 json數(shù)據(jù)。

總結(jié)：

首字母小寫的不管加不加tag都不能轉(zhuǎn)為json數(shù)據(jù)，而大寫的加了tag可以取別名，不加tag則json內(nèi)的字段跟結(jié)構(gòu)體變量原名一致

4. JSON操作的一些小技巧

（1）忽略掉 struct 指定字段

type User struct {
	Name string    `json:"u_name"`
	Password string `json:"password"`
	Email string `json:"email"`
}

func main()  {
	user := User{"admin", "pwd", "user@163.com"}
	person := Person{23, "上海"}
	// 忽略掉 Password 字段
	data, _ := json.Marshal(struct {
		*User
		Password string `json:"password,omitempty"`
	}{User: &user})
	fmt.Println("忽略字段: ", string(data))  // 打印: 忽略字段: {"u_name":"admin","email":"user@163.com"}
}

忽略字段: {“u_name”:“admin”,“email”:“user@163.com”}}

（2）添加額外的字段

data, _ = json.Marshal(struct {
	*User
	Skill string `json:"skill"`  // 臨時(shí)添加額外的 Skill字段
}{
	User: &user,
	Skill: "football",
})

fmt.Println("添加額外字段: ", string(data))

添加額外字段: {“u_name”:“admin”,“password”:“pwd”,“email”:“user@163.com”,“skill”:“football”}

（3）合并兩個(gè) struct

type User struct {
	Name string    `json:"u_name"`
	Password string `json:"password"`
	Email string `json:"email"`
}

type Person struct {
	Age int
	Addr string `json:"addr"`
}

func main()  {
    // 初始化兩個(gè) struct
	user := User{"admin", "pwd", "user@163.com"}
	person := Person{23, "上海"}
	
	data, _ := json.Marshal(struct {
		*User
		*Person
	}{
		User: &user,
		Person: &person,
	})
	
	fmt.Println("合并兩個(gè)struct: ", string(data))
}

合并兩個(gè)struct: {“u_name”:“admin”,“password”:“pwd”,“email”:“user@163.com”,“Age”:23,“addr”:“上海”}

（4）字符串傳遞給 int類型

emp := struct {                    // 創(chuàng)建匿名 struct
	Num int `json:"num,string"`
}{15,}
data, _ := json.Marshal(&emp)
fmt.Println("數(shù)字轉(zhuǎn)成字符串: ", string(data))       // 數(shù)字轉(zhuǎn)成字符串: {"num":"15"}

str := `{"Num":"25"}`
_ = json.Unmarshal([]byte(str), &emp)
fmt.Printf("字符串轉(zhuǎn)成數(shù)字: Emp.Num=%v\n", emp.Num) // 字符串轉(zhuǎn)成數(shù)字: Emp.Num=25

（5）一個(gè) json 分成兩個(gè)struct

str = ` {"u_name":"system","password":"abc","email":"user2@163.com","Age":23,"addr":"杭州"}`
var user2 User
var person2 Person
_ := json.Unmarshal([]byte(str), &struct {
	*User
	*Person
}{
	User: &user2,
	Person: &person2,
})

fmt.Printf("分成兩個(gè)struct: User=%v, Person=%v\n", user2, person2)

分成兩個(gè)struct: User={system abc user2@163.com}, Person={23 杭州}

補(bǔ)充：GoLang json格式化輸出

簡(jiǎn)單記錄一下go語言json格式化輸出的辦法

import (
?? ?"bytes"
?? ?"encoding/json"
?? ?"fmt"
?? ?"os"
)

type Complex_Type struct{
?? ?Age int `json:"age"`
?? ?Name string `json:"name"`
?? ?Grades map[string]int `json:"grade"`
?? ?Parents []string `json:"parents"`
}

?? ?grades := map[string]int{
?? ??? ?"math" : 96,
?? ??? ?"chinese" : 87,
?? ??? ?"english" : 93,
?? ?}

?? ?parents := []string{
?? ??? ?"minato",
?? ??? ?"kushina",
?? ?}

?? ?complex_type := Complex_Type{
?? ??? ?Age: 18,
?? ??? ?Name: "Naruto",
?? ??? ?Grades : grades,
?? ??? ?Parents: parents,
?? ?}
?? ?res,err := json.Marshal(complex_type)
?? ?exitOnError(err)
?? ?var out bytes.Buffer
?? ?err = json.Indent(&out,res,"","\t")
?? ?out.WriteTo(os.Stdout)
?? ?fmt.Printf("\n")

輸出：