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的时候需要注意的几点是：

1. 字段的tag是"-"，那么这个字段不会输出到JSON

2. tag中带有自定义名称，那么这个自定义名称会出现在JSON的字段名中

3. tag中如果带有"omitempty"选项，那么如果该字段值为空，就不会输出到JSON串中

4. 如果字段类型是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类型中都无效在该值上，不会产生任何错误。