□ 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字符串
代码语言:javascript复制// 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等
代码语言:javascript复制// 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 的处理:
代码语言:javascript复制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字符串
实例代码:
代码语言:javascript复制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
代码语言:javascript复制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字符串解码到相应的数据结构。
代码语言:javascript复制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("%Tn",a) // map[string]interface {}
}
Unmarshal (解组器) 解析JSON编码的数据并存储结果到 v
指向的值中。
如果v
为nil
或不是指针,Unmarshal 返回InvalidUnmarshalError
。
要将JSON解组到结构中,Unmarshal (解组) 匹配传入对象 Marshaling(编组) 处理使用的键的键(结构字段名或其标记),更喜欢精确匹配,但也接受不区分大小写的匹配。 通过默认情况下,没有相应结构字段的对象键是已忽略(也就是说你有的字段,就解析给你(如字段Age);你没有的字段,就忽略(如字段Sex);它没有的字段,你就为默认值(如字段S))。
而且,你给的结构(例如结构体)如果字段已经被赋值了,是无法通过Unmarshal (解组) 去覆盖原值的。
例如:
代码语言:javascript复制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("%#vn",a) // main.Test{Name:"", Age:12, S:0}
var b Test = Test{"12",12,2} // 如果解析到b里
_ := json.Unmarshal(val,&b)
fmt.Printf("%#vn",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。
代码语言:javascript复制源码中写的:
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类型中都无效在该值上,不会产生任何错误。