gjson

gjson模块实现了强大的JSON编码/解析，支持层级检索、运行时修改、常用数据格式转换等特点。

特点：

  1. 支持数据层级检索；
  2. 支持运行时数据修改；
  3. 支持JSON、XML、YAML/YML、TOML、Struct数据格式相互转换；

使用方式：

  1. import "github.com/gogf/gf/encoding/gjson"

接口文档：

https://godoc.org/github.com/gogf/gf/encoding/gjson

示例1，数据层级检索

  1. data :=
  2.     `{
  3.         "users" : {
  4.             "count" : 100,
  5.             "list"  : [
  6.                 {"name" : "小明",  "score" : 60},
  7.                 {"name" : "John", "score" : 99.5}
  8.             ]
  9.         }
  10.     }`
  11. if j, err := gjson.DecodeToJson([]byte(data)); err != nil {
  12.     glog.Error(err)
  13. } else {
  14.     fmt.Println("John Score:", j.GetFloat32("users.list.1.score"))
  15. }

可以看到，gjson.Json对象可以通过非常灵活的层级筛选功能(j.GetFloat32("users.list.1.score"))检索到对应的变量信息。这是gjson包的一大特色。

示例2，处理键名本身带有层级符号”.“的情况

  1. data :=
  2.     `{
  3.         "users" : {
  4.             "count" : 100
  5.         },
  6.         "users.count" : 101
  7.     }`
  8. if j, err := gjson.DecodeToJson([]byte(data)); err != nil {
  9.     glog.Error(err)
  10. } else {
  11.     j.SetViolenceCheck(true)
  12.     fmt.Println("Users Count:", j.GetInt("users.count"))
  13. }

运行之后打印出的结果为101。当键名存在”.”号时，检索优先级：键名->层级，因此并不会引起歧义。

示例3，支持运行时的数据修改

  1. data :=
  2.     `{
  3.         "users" : {
  4.             "count" : 100
  5.         }
  6.     }`
  7. if j, err := gjson.DecodeToJson([]byte(data)); err != nil {
  8.     glog.Error(err)
  9. } else {
  10.     j.Set("users.count",  2)
  11.     j.Set("users.list",  []string{"John", "小明"})
  12.     c, _ := j.ToJson()
  13.     fmt.Println(string(c))
  14. }

执行后输出结果为：

  1. {"users":{"count":1,"list":["John","小明"]}}

当JSON数据通过gjson包读取后，可以通过Set方法改变内部变量的内容，当然也可以新增/删除内容，当需要删除内容时，设定的值为nil即可。gjson包的数据运行时修改特性非常强大，在该特性的支持下，各种数据结构的编码/解析显得异常的灵活方便。

示例4，JSON转换为其他数据格式

  1. data :=
  2.     `{
  3.         "users" : {
  4.             "count" : 100,
  5.             "list"  : ["John", "小明"]
  6.         }
  7.     }`
  8. if j, err := gjson.DecodeToJson([]byte(data)); err != nil {
  9.     glog.Error(err)
  10. } else {
  11.     c, _ := j.ToJson()
  12.     fmt.Println("JSON:")
  13.     fmt.Println(string(c))
  14.     fmt.Println("======================")
  16.     fmt.Println("XML:")
  17.     c, _ = j.ToXmlIndent()
  18.     fmt.Println(string(c))
  19.     fmt.Println("======================")
  21.     fmt.Println("YAML:")
  22.     c, _ = j.ToYaml()
  23.     fmt.Println(string(c))
  24.     fmt.Println("======================")
  26.     fmt.Println("TOML:")
  27.     c, _ = j.ToToml()
  28.     fmt.Println(string(c))
  29. }

gjson支持将JSON转换为其他常见的数据格式，目前支持：JSON、XML、YAML/YML、TOML、Struct数据格式之间的相互转换。