Go语言——Json处理
□ JSON处理
JSON （JavaScript Object Notation）是一种比XML更轻量级的数据交换格式，在易于人们阅读和编写的同时，也易于程序解析和生成。
尽管JSON是JavaScript的一个子集，但JSON采用完全独立于编程语言的文本格式，且表现为键/值对集合的文本描述形式（类似一些编程语言中的字典结构），这使它成为较为理想的、跨平台、跨语言的数据交换语言。
开发者可以用 JSON 传输简单的字符串、数字、布尔值，也可以传输一个数组，或者一个更复杂的复合结构。
在 Web 开发领域中， JSON被广泛应用于 Web 服务端程序和客户端之间的数据通信。
Go语言内建对JSON的支持。使用Go语言内置的encoding/json 标准库，开发者可以轻松使用Go程序生成和解析JSON格式的数据。
JSON官方网站：http://www.json.org/
在线格式化：http://www.json.cn/
1. 编码JSON （编组|封送 Marshaling）
1. Marhsal()
将数据编码成json字符串
// func Marshal(v interface{}) ([]byte, error){}
// 示例代码：
// Test11 go json.Marshal时，结构体字段需要大写 否则Marshal时不显示
type Test11 struct {
Name string
age string
}
func main() {
t1 := Test11{"sb", "12"}
//生成一段JSON格式的文本
//如果编码成功， err 将赋于零值 nil，变量b 将会是一个进行JSON格式化之后的[]byte类型
b, err := json.Marshal(t1)
if err != nil {
fmt.Println(err)
} else {
fmt.Println(b) // [123 34 78 97...]
fmt.Println(string(b)) // {"Name":"sb"}
}
}2. MarshalIndent
将数据编码成json字符串 例如map stuct等
// MarshalIndent 很像 Marshal，只是用缩进对输出进行格式化
func MarshalIndent(v interface{}, prefix, indent string) ([]byte, error)
// v: 想要编码成json的结构体|map
// prefix: 前缀,通常就设置为""即可。
// indent：缩进,通常设置为制表符\t即可
//示例代码：
func main() {
t1 := Test11{"sb", 12}
b,_ := json.MarshalIndent(t1,"","\t")
fmt.Println(string(b))
// {
// "Name": "sb",
// "Age": 12
// }
}MarshalIndent相比于Marhsal()的区别就在于读结果做了Indent 的处理：
Indent 的代码有点长，简单说就是对Json 多了一些格式处理。3. struct tag
我们看到上面的输出字段名的首字母都是大写的，如果你想用小写的首字母怎么办呢？把结构体的字段名改成首字母小写的？
JSON输出的时候必须注意，只有导出的字段(首字母是大写)才会被输出，如果修改字段名，那么就会发现什么都不会输出，所以必须通过struct tag定义来实现。
针对JSON的输出，我们在定义struct tag的时候需要注意的几点是：
- 字段的tag是"-"，那么这个字段不会输出到JSON
- tag中带有自定义名称，那么这个自定义名称会出现在JSON的字段名中
- tag中如果带有"omitempty"选项，那么如果该字段值为空，就不会输出到JSON串中
- 如果字段类型是bool, string, int, int64等，而tag中带有",string"选项，那么这个字段在输出到JSON的时候会把该字段对应的值转换成JSON字符串
实例代码：
type Test11 struct {
// 1. 字段的tag是"-"，那么这个字段不会输出到JSON
Name string `json:"-"`
// 2. 转换为字符串，再输出
Age int `json:",string"` // --- "Age": "12",
// Age int `json:"Age"` // --- "Age": 12,
// 3. Subjects 的值会进行二次JSON编码
Sex string `json:"Sex"`
// 4. 如果 Height 为空，则不输出到JSON串中 没有这个tag 会显示 Height:""
Height string `json:"Height,omitempty"`
// 5. tag中带有自定义名称，那么这个自定义名称会出现在JSON的字段名中
Score int `json:"成绩"`
}
func main() {
t1 := Test11{Name: "sb", Age:12,Sex:"男",Score: 98}
b,_ := json.MarshalIndent(t1,"","\t")
fmt.Println(string(b))
}
4. 通过map生成JSON
func main() {
m:= map[string]string{"one":"你好","two":"我是","three":"汪汪队"}
v,err :=json.MarshalIndent(m,"","\t")
if err!=nil{
fmt.Println(err) //错误信息
}else{
fmt.Println(string(v))
}
// {
// "one": "你好",
// "three": "汪汪队",
// "two": "我是"
// }
}2. 解码JSON（解组|解封送：Unmarshaling）
Json Unmarshal：将json字符串解码到相应的数据结构。
func Unmarshal(data []byte, v interface{}) error
// data：想要json解码的[]byte类型数据
// v：将data Json解码到v（可以为结构体|map）里
// 实例代码
func main() {
t1 := Test11{Name: "sb", Age:12,Sex:"男",Score: 98}
val,_ := json.MarshalIndent(t1,"","\t")
fmt.Println(string(val)) // 上回的json
// {
// "Age": "12",
// "Sex": "男",
// "成绩": 98
// }
var a interface{}
err := json.Unmarshal(val,&a)
if err!=nil {
fmt.Println(err)
}
fmt.Println(a) // map[Age:12 Sex:男 成绩:98]
fmt.Printf("%T\n",a) // map[string]interface {}
}Unmarshal (解组器) 解析JSON编码的数据并存储结果到 v指向的值中。
如果v为nil或不是指针，Unmarshal 返回InvalidUnmarshalError。
要将JSON解组到结构中，Unmarshal (解组) 匹配传入对象 Marshaling(编组) 处理使用的键的键（结构字段名或其标记），更喜欢精确匹配，但也接受不区分大小写的匹配。 通过默认情况下，没有相应结构字段的对象键是已忽略（也就是说你有的字段，就解析给你(如字段Age)；你没有的字段，就忽略(如字段Sex)；它没有的字段，你就为默认值(如字段S)）。
而且，你给的结构（例如结构体）如果字段已经被赋值了，是无法通过Unmarshal (解组) 去覆盖原值的。
例如：
type Test struct {
Name string `json:"Name"`
Age int `json:",string,age"`
S int `json:"S"`
}
func main() {
// 使用的Json编码val是上面代码里的
// {
// "Age": "12",
// "Sex": "男",
// "成绩": 98
// }
var a Test
_ := json.Unmarshal(val,&a)
fmt.Printf("%#v\n",a) // main.Test{Name:"", Age:12, S:0}
var b Test = Test{"12",12,2} // 如果解析到b里
_ := json.Unmarshal(val,&b)
fmt.Printf("%#v\n",a) // main.Test{Name:"12", Age:12, S:2}可以看出来 已经赋值过的字段是不会被覆盖的。
}要将JSON Unmarshal (解组) 为 interface value，Unmarshal (解组) 将其中一个存储在接口值中：
bool——用于JSON布尔值 float64——用于JSON数字 字符串——用于JSON字符串 [ ]interface{}——用于JSON数组 map[string]interface{}——用于JSON对象 (常用) ---->这就是为啥上面解析到空接口中，出来的却是map[string]interface nil——表示JSON null
解组到切片Slice 要将JSON数组 Unmarshal (解组) 到切片中，解组将重置切片长度设置为零，然后将每个元素附加到切片。 作为一种特殊情况，要将空JSON数组解组到切片中，解组将使用新的空切片替换切片。
解组到数组Array 要将JSON数组 解组 为Go数组，解组解码JSON数组元素转换为相应的Go数组元素。 如果Go数组小于JSON数组，其他JSON数组元素将被丢弃。 如果JSON数组小于Go数组，附加的Go数组元素设置为零值。
解组到map
要将JSON对象解组到map中，Unmarshal (解组) 首先建立到的map使用。
如果map为nil，则Unmarshal (解组) 分配一个新map。
否则，就Unmarshal (解组) 重用现有map，保留现有条目（即保存你现在已经赋过的值）。
然后Unmarshal (解组) 存储从JSON对象到map的键值对。 | map的键类型必须为可以是任何字符串类型，也可以是int，implement json.Unmarshaler。
源码中写的：
The map's key type must either be any string type, an integer,
implement json.Unmarshaler,
or implement encoding.TextUnmarshaler.如果JSON值不适合给定的目标类型，或者，如果JSON编号溢出了目标类型，则取消编组（Marshal）跳过该字段并尽可能完成Unmarshal (解组)。
如果没有遇到更严重的错误，则Unmarshal (解组)返回描述最早此类错误的Unmarshal (解组)类型错误。
空值解组 JSON空值Unmarshal (解组)为interface{}、map、指针或切片通过将Go值设置为nil。 因为null在JSON中经常用来表示`not present '，将JSON null解组到任何其他Go类型中都无效在该值上，不会产生任何错误。
腾讯云开发者
