前言:
JSON 解析是我们不可避免的常见问题,在 Go 语言中,我们可以借助 gjson 库来方便的进行 json 属性的提取与解析,本文和大家一起上手与梳理 gjson 库的使用。
1. 快速使用
快速安装:
go get github.com/tidwall/gjson
Get() 方法解析 json 字符串:
json := `{"name":{"first":"uncle","last":"suta"}}`
lastName := gjson.Get(json, "name.last")
fmt.Println(lastName.String()) // "uncle"
通过上面的例子,我们可以看到,使用 gjson 中的 Get() 方法,我们可以轻松愉快的进行 json 解析。
2. Get() 返回的 Result 结构体
Get() 方法在解析完 json 字符串后,返回的是一个 Result 结构体,其结构如下所示:
// Result represents a json value that is returned from Get().
type Result struct {
// Type is the json type
Type Type
// Raw is the raw json
Raw string
// Str is the json string
Str string
// Num is the json number
Num float64
// Index of raw value in original json, zero means index unknown
Index int
// Indexes of all the elements that match on a path containing the '#'
// query character.
Indexes []int
}
但是,我们解析 json 所需要的往往是基本数据类型,因此,Result 结构体本身为我们实现了如下所示的丰富的方法来进行类型转化:
String() string
Bool() bool
Int() int64
Uint() uint64
Float() float64
Time() time.Time
Array() []Result
IsObject() bool
IsArray() bool
ForEach(iterator func(key Result, value Result) bool)
Map() map[string]Result
Get(path string) Result
arrayOrMap(vc byte, valueize bool) (r arrayOrMapResult)
Exists() bool
Value() interface{}
Less(token Result, caseSensitive bool) bool
Paths(json string) []string
Path(json string) string
3. 键路径
在 gjson
中,键路径实际上是以.
分隔的一系列键。
gjson
支持在键中包含通配符*
和?
,*
匹配任意多个字符,?
匹配单个字符。 例如abc*
可以匹配abc1111/abc222/abc...
等以abc
开头的键,ab?
只能匹配ab1/ab2
等以ab
开头且后面只有一个字符的键。
数组使用键名 + .
+ 索引(索引从 0 开始)的方式读取元素,如果键a
对应的值是一个数组,那么a.0
读取数组的第一个元素,a.1
读取第二个元素。
数组长度使用键名 + .
+ #
获取,例如a.#
返回数组a
的长度。
如果键名中出现.
,那么需要使用\
进行转义。
4. json 数组遍历
gjson
还提供了通用的遍历数组和对象的方式。gjson.Get()
方法返回一个gjson.Result
类型的对象,json.Result
提供了ForEach()
方法用于遍历。该方法接受一个类型为func (key, value gjson.Result) bool
的回调函数。遍历对象时key
和value
分别为对象的键和值;遍历数组时,value
为数组元素,key
为空(不是索引)。回调返回false
时,遍历停止:
json := `{"list": ["a", "b", "c"]}`
list := gjson.Get(json, "list")
list.ForEach(func(_, element gjson.Result) bool {
fmt.Println(element)
return true
})
5. 其他
gjson.Valid()
可以对 json 字符串的合法性进行校验。
gjson.GetMany()
可以一次解析多个字段。
到此这篇关于Go 语言 json解析框架与 gjson 详解的文章就介绍到这了,更多相关Go json 内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网!