encoding/json - JSON 序列化

---

介绍

• 官方文档地址
• 只对外部可见的(首字母大写)结构体和属性名进行编码

---

序列化与反序列化

package main

// 序列化 编码
// 反序列化 解码

import (
	"encoding/json"
	"fmt"
)

func main() {

	// 序列化
	m := map[string]int{
		"chinese": 100,
		"math":    99,
	}
	b, _ := json.Marshal(m)
	fmt.Println(string(b))

	// 反序列化, 传入[]byte
	// 如果是字符串需要先使用 []byte(str) 处理为 []byte
	b2 := []byte{123, 34, 99, 104, 105, 110, 101, 115, 101, 34, 58, 49, 48, 48, 44, 34, 109, 97, 116, 104, 34, 58, 57, 57, 125}
	var m2 map[string]int
	json.Unmarshal(b2, &m2)
	fmt.Printf("%+v\n", m2)  // 这样可以展示结构体的字段名和值
}

---

tag 标识符

• 定义结构体时，我们通常会定义 tag 标识符扩展 json 的信息
• 标识符常见的有两种， 一种是解析时的字段名，另一种是功能标识符
• 功能标识符包括: -, inline, omitempty

---

jsonName

• 定义json串中使用的key

// {"stu_name": "Aki", "stu_age": 19}

type Stu struct {
	Name  string `json:"stu_name"`
	Age   int    `json:"stu_age"`
}

---

-

• 指定字段不参与编码（无论是否有值）

type Stu struct {
	Name  string `json:"name"`
	Age   int    `json:"-"`
}

---

omitempty

• 如果字段为空, 则不参与编码
• 如果忽略的字段是嵌套结构体，则不生效。可修改嵌套类型为指针实现
• 可用作简化传输大小使用

package main

import (
	"encoding/json"
	"fmt"
)

type Stu struct {
	Name string `json:"name,omitempty"`
	Age  int    `json:"age"`
}

func main() {

	stu := Stu{
		Age: 18,
	}

	marshal, _ := json.Marshal(stu)
	fmt.Println(string(marshal))

  // name 字段为空
  // 如果未定义 omitempty，则结果为 {"name":"","age":18}
  // 如果定义了 omitempty，则结果为 {"age":18}
}

---

inline

• 解码时，支持嵌套匿名结构体的解析

package main

import (
	"encoding/json"
	"fmt"
)

type Stu struct {
	Name  string `json:"name,omitempty"`
	Age   int    `json:"age"`
	Score `json:",inline"`
}

type Score struct {
	English int `json:"english"`
	Chinese int `json:"chinese"`
	Math    int `json:"math"`
}

func main() {

	data := `{"name":"aki", "age":18, "english": 88, "math": 88}`

	var stu Stu
	json.Unmarshal([]byte(data), &stu)
	fmt.Printf("%+v\n", stu)
}

---

实用技巧

输出美观

package main

import (
	"encoding/json"
	"fmt"
)

func main() {

	// 序列化
	m := map[string]int{
		"chinese": 100,
		"math":    99,
	}
	b, _ := json.MarshalIndent(m, "", "    ")
	fmt.Println(string(b))
}

// 结果如下
// {
//  	"chinese": 100,
//  	"math": 99
// }

---

补充链接

• 匿名结构体 && 标签的组合场景