golang中json操作的完全指南

前言

JSON是一种轻量级的数据交换格式。易于阅读和编写。 golang 提供了 encoding/json 包来操作JSON数据。

1. 结构体与JSON互转

（1）使用 json.Marshal() 方法，把结构体转成 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("序列化错误 err=％v\n", err)
return
}
fmt.Println("序列化后: ", string(data))
}

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

（2）JSON字符串 转 结构体，可以使用 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("反序列化错误 err=％v\n", err)
return
}
fmt.Printf("反序列化后: Student=％v, Name=％v\n", stu2, stu2.Name)
}

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

（3）如何实现结构体序列化后key的名称能自定义

对于自定义key的名称，可以给 struct变量指定一个tag标签

type Student struct {
Name string   `json:"stu_name"`
Age int       `json:"stu_age"`
Skill string  // 也可以不指定 tag标签，默认就是 变量名称
}

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

打印后，可以看到 key的名称已经变成了我们指定的 tag标签 的名称

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

2. map与JSON互转

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

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

// Json字符串 转 map
str := `{"age":25,"name":"car"}`
err = json.Unmarshal([]byte(str), &m)
if err != nil {
fmt.Printf("反序列化错误 err=％v\n", err)
return
}
fmt.Printf("反序列化后: map=％v, name=％v\n", m, m["name"])
// 打印: 反序列化后: map=map[age:25 name:car], name=car
}

3. 结构体的变量不加tag标签能否正常转成json数据

如果变量首字母小写，则为private。因为取不到反射信息，不能转。

如果变量首字母大写，则为public。不管加不加 tag 都能正常转，加了tag的变量就按照tag的名称显示。

示例：

type User struct {
Name string    `json:"u_name"`
age int        `json:"u_age"`
Skill string   // 也可以不指定 tag标签，默认就是 变量名称
addr string
}

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

通过打印，我们发现小写的变量，如 age、addr 都没有转成 json数据。

总结：

首字母小写的不管加不加tag都不能转为json数据，而大写的加了tag可以取别名，不加tag则json内的字段跟结构体变量原名一致

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"`  // 临时添加额外的 Skill字段
}{
User: &user,
Skill: "football",
})

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

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

（3）合并两个 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()  {
   // 初始化两个 struct
user := User{"admin", "pwd", "user@163.com"}
person := Person{23, "上海"}

data, _ := json.Marshal(struct {
*User
*Person
}{
User: &user,
Person: &person,
})

fmt.Println("合并两个struct: ", string(data))
}

合并两个struct: {“u_name”:“admin”,“password”:“pwd”,“email”:“user@163.com”,“Age”:23,“addr”:“上海”}

（4）字符串传递给 int类型

emp := struct {                    // 创建匿名 struct
Num int `json:"num,string"`
}{15,}
data, _ := json.Marshal(&emp)
fmt.Println("数字转成字符串: ", string(data))       // 数字转成字符串: {"num":"15"}

str := `{"Num":"25"}`
_ = json.Unmarshal([]byte(str), &emp)
fmt.Printf("字符串转成数字: Emp.Num=％v\n", emp.Num) // 字符串转成数字: Emp.Num=25

（5）一个 json 分成两个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("分成两个struct: User=％v, Person=％v\n", user2, person2)

分成两个struct: User={system abc user2@163.com}, Person={23 杭州}

补充：GoLang json格式化输出

简单记录一下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")

输出：

来源：https://blog.csdn.net/grb123/article/details/123017658