4. encoding-json包

4.1 struct与json

比如我们 Golang 要给 App 或者小程序提供 Api 接口数据，这个时候就需要涉及到结构体和Json 之间的相互转换。

• Golang JSON 序列化是指把结构体数据转化成 JSON 格式的字符串。
• Golang JSON 的反序列化是指把 JSON 数据转化成 Golang 中的结构体对象。
• Golang 中 的 序 列 化 和 反 序 列 化 主 要 通 过 "encoding/json" 包 中 的 ==json.Marshal()== 和 ==json.Unmarshal()== 方法实现。

4.1.1 struct转Json字符串

package main

import (
   "encoding/json"
   "fmt"
)

type Student struct {
   ID     int
   Gender string
   name   string //私有属性不能被 json 包访问
   Sno    string
}

func main() {
   var s1 = Student{
      ID:     1,
      Gender: "男",
      name:   "李四",
      Sno:    "s0001",
   }
   fmt.Printf("%#v\n", s1) // main.Student{ID:1, Gender:"男", name:"李四", Sno:"s0001"}
   var s, _ = json.Marshal(s1)
   jsonStr := string(s)
   fmt.Println(jsonStr) // {"ID":1,"Gender":"男","Sno":"s0001"}
}

4.1.2 Json字符串转struct

package main

import (
   "encoding/json"
   "fmt"
)

type Student struct {
   ID     int
   Gender string
   Name   string //私有属性不能被 json 包访问
   Sno    string
}

func main() {
   var jsonStr = `{"ID":1,"Gender":"男","Name":"李四","Sno":"s0001"}`
   var student Student //定义一个 Monster 实例
   err := json.Unmarshal([]byte(jsonStr), &student)
   if err != nil {
      fmt.Printf("unmarshal err=%v\n", err)
   }
   // 反序列化后 student=main.Student{ID:1, Gender:"男", Name:"李四", Sno:"s0001"} student.Name = 李四
   fmt.Printf("反序列化后 student=%#v student.Name=%v \n", student, student.Name)
}

4.2 struct tag

4.2.1 Tag标签说明

• Tag 是结构体的元信息，可以在运行的时候通过反射的机制读取出来。
• Tag 在结构体字段的后方定义，由一对反引号包裹起来。

具体的格式如下：

==key1:"value1" key2:"value2"==

结构体 tag 由一个或多个键值对组成。键与值使用冒号分隔，值用双引号括起来。

同一个结构体字段可以设置多个键值对 tag，不同的键值对之间使用空格分隔。

注意事项：

为结构体编写 Tag 时，必须严格遵守键值对的规则。

结构体标签解析代码的容错能力很差，一旦格式写错，编译和运行时都不会提示任何错误，通过反射也无法正确取值。

例如不要在 key 和 value 之间添加空格。

4.2.2 Tag结构体转化Json字符串

package main
import (
   "encoding/json"
   "fmt"
)
type Student struct {
   ID int `json:"id"` //通过指定 tag 实现 json 序列化该字段时的 key
   Gender string `json:"gender"`
   Name string
   Sno string
}
func main() {
   var s1 = Student{
      ID: 1,
      Gender: "男",
      Name: "李四",
      Sno: "s0001",
   }
   // main.Student{ID:1, Gender:"男", Name:"李四", Sno:"s0001"}
   fmt.Printf("%#v\n", s1)
   var s, _ = json.Marshal(s1)
   jsonStr := string(s)
   fmt.Println(jsonStr) // {"id":1,"gender":"男","Name":"李四","Sno":"s0001"}
}

4.2.3 Json字符串转成Tag结构体

package main

import (
   "encoding/json"
   "fmt"
)

type Student struct {
   ID     int    `json:"id"` //通过指定 tag 实现 json 序列化该字段时的 key
   Gender string `json:"gender"`
   Name   string
   Sno    string
}

func main() {
   var s2 Student
   var str = `{"id":1,"gender":"男","Name":"李四","Sno":"s0001"}`
   err := json.Unmarshal([]byte(str), &s2)
   if err != nil {
      fmt.Println(err)
   }
   // main.Student{ID:1, Gender:"男", Name:"李四", Sno:"s0001"}
   fmt.Printf("%#v", s2)
}