1. 介绍

Goencoding/jsonjson对象
map和slice

1.1 Go和JSON数据类型

BooleanboolNumberfloat64StringstringArray[]interface{}Objectmap[string]interface{}NULLnil

1.2 结构体序列化规则

@注意：可导出的字段(首字母大写)，才能参与Json的序列化

json:"xx"json:"-"json:"xxx,omitempty"xxx,json:",omitempty"json:"xxx,string"xxx

a. 代码示例

type Student struct {
 // 指定json标签时,序列化的key为标签值:name
 Name string `json:"name"`
 // 不指定序列化标签时，key为原属性:Age
 Age  int
 // 当标签值为`json:"-"`,代表改字段会被忽略
 Home string `json:"-"`
 // 标签指定omitempty选项,代表该字段为空值时,会被忽略
 Phone string `json:"phone,omitempty"`
 // 标签指定string选项,代表输出类型会转化为字符串
 // 它只适用于字符串、浮点数、整数类型的字段
 Score float64 `json:"score,string"`
}

b. 运行效果

func TestMarshal(t *testing.T) {
 // 声明初始化结构体
 student1 := Student{
  Name:  "张三",
  Age:   18,
  Home:  "北京",
  Score:  90.5,
  Phone: "",
 }
 // 序列化
 json1, _ := json.Marshal(student1)
 fmt.Printf("序列化json:%s\n", json1)
}
/**输出
=== RUN   TestMarshal
序列化json: {"name":"张三","Age":18,"score":"90.5"}
--- PASS: TestMarshal (0.00s)
PASS
*/

2. 匿名字段序列化

JSON
a. 字段标签不重复

School.Name和StudentA.Name，Json标签不一致。

// 学校
type School struct {
 Name    string `json:"schoolName"`
 Address string `json:"schoolAddress"`
}
// 学生
type StudentA struct {
 Name string `json:"name"`
 // 匿名字段,而且没有json标签
 School 
}
// 序列化-匿名字段 (默认字段不冲突)
func TestAnonymousTagDifferent(t *testing.T) {
 var student = StudentA{
  Name: "小明",
  School:School{
   Name: "北京大学",
   Address: "北京海淀区",
  },
 }
 jsonByte, _ := json.Marshal(student)
 fmt.Printf("json: %s \n",jsonByte)
}
/** 输出
=== RUN   TestAnonymousTagDifferent
json: {"name":"小明","schoolName":"北京大学","schoolAddress":"北京海淀区"} 
--- PASS: TestAnonymousTagDifferent (0.00s)
PASS
*/

b. 字段标签重复
json:"name"
// 学生
type StudentB struct {
  // 标签名和班级名一样
 Name string `json:"name"` 
 // 匿名字段,而且没有json标签
 Class
}
// 班级
type Class struct {
  // 标签名和学生名一样
 Name string `json:"name"`
 Desc string `json:"desc"`
}
// 序列化-匿名字段 (字段标签冲突)
func TestAnonymousTagSame(t *testing.T) {
 var student = StudentB{
  Name: "小明",
  Class: Class{
   Name: "高二(1)班",
   Desc: "优秀班级",
  },
 }
 jsonByte, _ := json.Marshal(student)
 fmt.Printf("json: %s \n", jsonByte)
}
/** 输出
=== RUN   TestAnonymousTagSame
json: {"name":"小明","desc":"优秀班级"} 
--- PASS: TestAnonymousTagSame (0.00s)
PASS
*/

根据上面代码，得知如果字段标签冲突，冲突的匿名字段会被忽略。

JSON
json
a. 字段标签重复
type Bird struct {
  // json标签一样
 Name string `json:"name"`
 // 匿名字段，有json标签
 Category `json:"category"`
}
type Category struct {
  // json标签一样
 Name string `json:"name"`
}
// 序列化-匿名字段,有json标签
func TestAnonymousWithTag(t *testing.T) {
 b := Bird{
  Name: "喜鹊",
  Category:Category{Name: "鸟类"},
 }
 jsonByte, _ := json.Marshal(b)
 fmt.Printf("json: %s \n", jsonByte)
}
/** 输出
=== RUN   TestAnonymousWithTag
json: {"name":"喜鹊","category":{"name":"鸟类"}} 
--- PASS: TestAnonymousWithTag (0.00s)
PASS
*/

b. 字段标签不重复
type Bird struct {
 Name string `json:"name"`
 // 匿名字段，有json标签
 Category `json:"category"`
}
type Category struct {
 Name string `json:"categoryName"`
}
// 序列化-匿名字段,有json标签
func TestAnonymousWithTag(t *testing.T) {
 b := Bird{
  Name: "喜鹊",
  Category:Category{Name: "鸟类"},
 }
 jsonByte, _ := json.Marshal(b)
 fmt.Printf("json: %s \n", jsonByte)
}
/** 输出
=== RUN   TestAnonymousWithTag
json: {"name":"喜鹊","category":{"categoryName":"鸟类"}} 
--- PASS: TestAnonymousWithTag (0.00s)
PASS
*/

3. 匿名字段反序列化

JSON
a. 字段标签不重复
type BookClass struct {
 Name  string  `json:"className"`
 Company string `json:"company"`
}
type GoStudy struct {
 Name string `json:"name"`
 Desc string `json:"desc"`
  // 匿名字段无 json标签
 BookClass
}
func TestUnMarshal(t *testing.T) {
 jsonStr := `{"name":"Go语言高级编程","desc":"这是一本Go学习书籍","className":"IT行业书籍","company":"xxx出版社"}`
 var goStudy GoStudy
 err := json.Unmarshal([]byte(jsonStr), &goStudy)
 if err != nil {
  t.Error(err)
  return
 }
 fmt.Printf("反序列化结果: %+v\n",goStudy)
}
/** 输出
=== RUN   TestUnMarshal
反序列化结果: {Name:Go语言高级编程 Desc:这是一本Go学习书籍 BookClass:{Name:IT行业书籍 Company:xxx出版社}}
--- PASS: TestUnMarshal (0.00s)
PASS
*/

b. 字段标签重复
type BookClass struct {
  // 设置成标签都为 name
 Name  string  `json:"name"`
 Company string `json:"company"`
}
type GoStudy struct {
  //设置成标签都为 name
 Name string `json:"name"`
 Desc string `json:"desc"`
  // 匿名字段无 json标签
 BookClass
}
func TestUnMarshal(t *testing.T) {
 jsonStr := `{"desc":"这是一本Go学习书籍","company":"xxx出版社","name":"IT行业书籍"}`
 var goStudy GoStudy
 err := json.Unmarshal([]byte(jsonStr), &goStudy)
 if err != nil {
  t.Error(err)
  return
 }
 fmt.Printf("反序列化结果: %+v\n",goStudy)
}
/** 输出
=== RUN   TestUnMarshal
反序列化结果: {Name:IT行业书籍 Desc:这是一本Go学习书籍 BookClass:{Name: Company:xxx出版社}}
--- PASS: TestUnMarshal (0.00s)
PASS
*/

@注意: 当字段标签重复时,反序列化会优先给主属性字段赋值。

JSON
a. 字段标签重复
type BookClass struct {
 Name  string  `json:"name"`
 Company string `json:"company"`
}
type GoStudy struct {
 Name string `json:"name"`
 Desc string `json:"desc"`
 // 设置成有json标签
 BookClass `json:"bookClass"`
}
func TestUnMarshal(t *testing.T) {
 jsonStr1 := `{"name":"Go语言高级编程","desc":"这是一本Go学习书籍","company":"xxx出版社"}`
 jsonStr2 := `{"name":"Go语言高级编程","desc":"这是一本Go学习书籍","bookClass":{"name":"IT行业书籍","company":"xxx出版社"}}`
 var res1 GoStudy
 var res2 GoStudy
 _ = json.Unmarshal([]byte(jsonStr1), &res1)
 _ = json.Unmarshal([]byte(jsonStr2), &res2)
 fmt.Printf("res1结果: %+v\n", res1)
 fmt.Printf("res2结果: %+v\n", res2)
}
/** 输出
=== RUN   TestUnMarshal
res1结果: {Name:Go语言高级编程 Desc:这是一本Go学习书籍 BookClass:{Name: Company:}}
res2结果: {Name:Go语言高级编程 Desc:这是一本Go学习书籍 BookClass:{Name:IT行业书籍 Company:xxx出版社}}
--- PASS: TestUnMarshal (0.00s)
PASS
*/

b. 字段标签不重复
type BookClass struct {
 Name  string  `json:"bookName"`
 Company string `json:"company"`
}
type GoStudy struct {
 Name string `json:"name"`
 Desc string `json:"desc"`
 // 设置成有json标签
 BookClass `json:"bookClass"`
}
func TestUnMarshal(t *testing.T) {
 jsonStr1 := `{"bookName":"Go语言高级编程","desc":"这是一本Go学习书籍","company":"xxx出版社"}`
 jsonStr2 := `{"name":"Go语言高级编程","desc":"这是一本Go学习书籍","bookClass":{"bookName":"IT行业书籍","company":"xxx出版社"}}`
 var res1 GoStudy
 var res2 GoStudy
 _ = json.Unmarshal([]byte(jsonStr1), &res1)
 _ = json.Unmarshal([]byte(jsonStr2), &res2)
 fmt.Printf("res1结果: %+v\n", res1)
 fmt.Printf("res2结果: %+v\n", res2)
}
/** 输出
=== RUN   TestUnMarshal
res1结果: {Name: Desc:这是一本Go学习书籍 BookClass:{Name: Company:}}
res2结果: {Name:Go语言高级编程 Desc:这是一本Go学习书籍 BookClass:{Name:IT行业书籍 Company:xxx出版社}}
--- PASS: TestUnMarshal (0.00s)
PASS
*/

json

4.1 序列化

a. 匿名字段无标签
{"..":"..",..}
b. 匿名字段有标签
a{"..":"..","a":{"xx":"xx"}}

4.2 反序列化

a. 匿名字段无标签
JSON{"..":"..",..}
b. 匿名字段有标签
JSON{"..":"..","a":{"xx":"xx"}}

当结构体中嵌套匿名结构体字段时，在进行序列化和反序列时，推荐为匿名字段加上json标签。