GJSON的使用
GJSON的使用
简介 什么是 Gjson:
GJSON 是一个 Golang 包,它提供了一种快速,简单的方法来从 json 格式文档中获取值。它拥有比如单行检索,用 "." 符号来寻找路径,迭代和解析多行 json 的功能。
个人理解
Gjson 实际上就是一个比原生 json 解析更快更简单的一种工具,对于 API 来说,我不关心这个 json 格式是否有错,我只需要关心这个 json 里面有没有我想要的数据,快速格式化成我想要的格式
安装
GO MOD 模式下,执行:
$ go get -u github.com/tidwall/gjson
直接获取值
我还是会由浅入深的给大家介绍这个库的使用方法,如果我们拿到了一个 json 字符串的时候应该这样做:
package main import ( "fmt" "github.com/tidwall/gjson" ) func main() { exampleJsonString := `{ "code":"000", "data":{ "all_count":441353, "lists":[ { "id":441353, "job_name":"经营日报-同步职位信息", "job_recall_time":"2021-03-13 15:05:04", "job_recall_content":"请求成功:great", "create_time":"2021-03-13 15:05:04" }, { "id":441352, "job_name":"经营日报-Check张继学列表", "job_recall_time":"2021-03-13 15:05:00", "job_recall_content":"请求成功:OK", "create_time":"2021-03-13 15:05:00" } ] }, "msg":"获取列表成功", "success":true }` jsonCode := gjson.Get(exampleJsonString, "code") //这个后面你可以继续跟想要的结果类型,不加的话会是json字符串的类型 fmt.Println(jsonCode) // 结果 000 jsonOneJobName := gjson.Get(exampleJsonString,"data.lists.#.job_name").Array() //比如我这里就希望返回是一个切片类型 fmt.Println(jsonOneJobName) // 结果 [经营日报-同步职位信息 经营日报-Check张继学列表] }
上面的同学开始疑问了,如果我自己写错了怎么办,或者没有那个 key 字段怎么办,没关系,你在获取到了后,加上自己想要的判断类型,再判断一次是否为空即可。
我都不需要定义任何结构体,用最简单的办法获取到我想要的内容
路径语法的快速概述:
路径语法的快速概述,以上面 json 字符串为例
还有一些路径通配符,比如你有模糊查询或者想在 json 取值时有判断的需求,可查看官方文档:https://github.com/tidwall/gjson
返回函数
列举一些常用的返回函数使用
package main // ... // ... fmt.Println(gjson.Get(exampleJsonString,"data.lists.1.create_time").Exists()) // 查看当前路径的值是否存在 结果 true fmt.Println(gjson.Get(exampleJsonString,"data.lists").IsArray()) //查看当前路径是否是json数组 结果 true fmt.Println(gjson.Get(exampleJsonString,"data.lists.0").IsObject()) //查看当前路径是否是一个json对象 结果 true gjson.Get(exampleJsonString,"data.lists.1").ForEach(func(key, value gjson.Result) bool { fmt.Println(value) return true }) //获取到路径结果后,遍历取值(其实觉得自己遍历可读性更高) fmt.Println(gjson.Get(exampleJsonString,"data.lists.1.id").Float()) //所有标准类型都可以获取到,比如 Bool,Int,Value(这个是接口类型),Unit,String
直接解析 bytes 类型
实际上,很多时候我们拿到的 JSON 数据都是从 API 中获得,比如从 http 请求中获得了 body,之后 ioutil.ReadAll 获得了 [] byte 类型的数据
package main import ( "fmt" "github.com/tidwall/gjson" ) func main() { exampleJsonByte := []byte(`{ "code":"000", "data":{ "all_count":441353, "lists":[ { "id":441353, "job_name":"经营日报-同步职位信息", "job_recall_time":"2021-03-13 15:05:04", "job_recall_content":"请求成功:great", "create_time":"2021-03-13 15:05:04" }, { "id":441352, "job_name":"经营日报-Check张继学列表", "job_recall_time":"2021-03-13 15:05:00", "job_recall_content":"请求成功:OK", "create_time":"2021-03-13 15:05:00" } ] }, "msg":"获取列表成功", "success":true }`) fmt.Println(gjson.GetBytes(exampleJsonByte, "data.lists.#.job_name").Array()) //好吧,结果一样 [经营日报-同步职位信息 经营日报-Check张继学列表] }
总结
GJSON 真的太简单了,可以说是小白 golang 解析 json 数据的必备良品,如果涉及到多人开发,需要用到同样的接口结构体,我建议还是老老实实的写结构体,毕竟数据模型的搭建是多人协同开发基础之一。