Searching...

gjson

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

特点: 1. 支持数据层级检索; 2. 支持运行时数据修改; 3. 支持JSONXMLYAML/YMLTOMLStruct数据格式相互转换;

使用方式:

import "gitee.com/johng/gf/g/encoding/gjson"

方法列表: godoc.org/github.com/johng-cn/gf/g/encoding/gjson

func Decode(b []byte) (interface{}, error)
func DecodeTo(b []byte, v interface{}) error
func Encode(v interface{}) ([]byte, error)
type Json
    func DecodeToJson(b []byte) (*Json, error)
    func Load(path string) (*Json, error)
    func LoadContent(data []byte, dataType ...string) (*Json, error)
    func New(value interface{}, safe ...bool) *Json
    func NewUnsafe(value ...interface{}) *Json
    func (j *Json) Append(pattern string, value interface{}) error
    func (j *Json) Dump() error
    func (j *Json) Get(pattern ...string) interface{}
    func (j *Json) GetArray(pattern string) []interface{}
    func (j *Json) GetBool(pattern string) bool
    func (j *Json) GetFloat32(pattern string) float32
    func (j *Json) GetFloat64(pattern string) float64
    func (j *Json) GetFloats(pattern string) []float64
    func (j *Json) GetInt(pattern string) int
    func (j *Json) GetInt16(pattern string) int16
    func (j *Json) GetInt32(pattern string) int32
    func (j *Json) GetInt64(pattern string) int64
    func (j *Json) GetInt8(pattern string) int8
    func (j *Json) GetInterfaces(pattern string) []interface{}
    func (j *Json) GetInts(pattern string) []int
    func (j *Json) GetJson(pattern string) *Json
    func (j *Json) GetMap(pattern string) map[string]interface{}
    func (j *Json) GetString(pattern string) string
    func (j *Json) GetStrings(pattern string) []string
    func (j *Json) GetTime(pattern string, format ...string) time.Time
    func (j *Json) GetTimeDuration(pattern string) time.Duration
    func (j *Json) GetToStruct(pattern string, objPointer interface{}) error
    func (j *Json) GetToVar(pattern string, v interface{}) error
    func (j *Json) GetUint(pattern string) uint
    func (j *Json) GetUint16(pattern string) uint16
    func (j *Json) GetUint32(pattern string) uint32
    func (j *Json) GetUint64(pattern string) uint64
    func (j *Json) GetUint8(pattern string) uint8
    func (j *Json) Len(pattern string) int
    func (j *Json) Remove(pattern string) error
    func (j *Json) Set(pattern string, value interface{}) error
    func (j *Json) SetSplitChar(char byte)
    func (j *Json) SetViolenceCheck(check bool)
    func (j *Json) ToArray() []interface{}
    func (j *Json) ToJson() ([]byte, error)
    func (j *Json) ToJsonIndent() ([]byte, error)
    func (j *Json) ToMap() map[string]interface{}
    func (j *Json) ToStruct(o interface{}) error
    func (j *Json) ToToml() ([]byte, error)
    func (j *Json) ToXml(rootTag ...string) ([]byte, error)
    func (j *Json) ToXmlIndent(rootTag ...string) ([]byte, error)
    func (j *Json) ToYaml() ([]byte, error)

示例1,数据层级检索

data :=
    `{
        "users" : {
            "count" : 100,
            "list"  : [
                {"name" : "小明",  "score" : 60},
                {"name" : "John", "score" : 99.5}
            ]
        }
    }`
ifj, err := gjson.DecodeToJson([]byte(data)); err != nil {
    glog.Error(err)
} else {
    fmt.Println("John Score:", j.GetFloat32("users.list.1.score"))
}

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

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

data :=
    `{
        "users" : {
            "count" : 100
        },
        "users.count" : 101
    }`
if j, err := gjson.DecodeToJson([]byte(data)); err != nil {
    glog.Error(err)
} else {
    j.SetViolenceCheck(true)
    fmt.Println("Users Count:", j.GetInt("users.count"))
}

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

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

data :=
    `{
        "users" : {
            "count" : 100
        }
    }`
if j, err := gjson.DecodeToJson([]byte(data)); err != nil {
    glog.Error(err)
} else {
    j.Set("users.count",  2)
    j.Set("users.list",  []string{"John", "小明"})
    c, _ := j.ToJson()
    fmt.Println(string(c))
}

执行后输出结果为: {"users":{"count":1,"list":["John","小明"]}}JSON数据通过gjson包读取后,可以通过Set方法改变内部变量的内容,当然也可以新增/删除内容,当需要删除内容时,设定的值为nil即可。gjson包的数据运行时修改特性非常强大,在该特性的支持下,各种数据结构的编码/解析显得异常的灵活方便。

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

data :=
    `{
        "users" : {
            "count" : 100,
            "list"  : ["John", "小明"]
        }
    }`
if j, err := gjson.DecodeToJson([]byte(data)); err != nil {
    glog.Error(err)
} else {
    c, _ := j.ToJson()
    fmt.Println("JSON:")
    fmt.Println(string(c))
    fmt.Println("======================")

    fmt.Println("XML:")
    c, _ = j.ToXmlIndent()
    fmt.Println(string(c))
    fmt.Println("======================")

    fmt.Println("YAML:")
    c, _ = j.ToYaml()
    fmt.Println(string(c))
    fmt.Println("======================")

    fmt.Println("TOML:")
    c, _ = j.ToToml()
    fmt.Println(string(c))
}

gjson支持将JSON转换为其他常见的数据格式,目前支持:JSONXMLYAML/YMLTOML、Struct数据格式之间的相互转换。