Go语言——Json处理

2023-04-16 15:04:14 浏览数 (1)

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

  1. 字段的tag是"-",那么这个字段不会输出到JSON
  2. tag中带有自定义名称,那么这个自定义名称会出现在JSON的字段名中
  3. tag中如果带有"omitempty"选项,那么如果该字段值为空,就不会输出到JSON串中
  4. 如果字段类型是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指向的值中。

如果vnil或不是指针,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类型中都无效在该值上,不会产生任何错误。

0 人点赞