酷Go推荐 快且灵活的 JSON 解析器-Jsoniter

hausliu · 2021年07月23日 · 最后由 Ky 回复于 2021年07月26日 · 221 次阅读

快且灵活的 JSON 解析器-Jsoniter

一、简介

什么是 jsoniter?

jsoniter(json-iterator)是一款快且灵活的 JSON 解析器,同时提供 Java 和 Go 两个版本。从 dsljson 和 jsonparser 借鉴了大量代码。

根据官网介绍:Jsoniter 的 Golang 版本可以比标准库(encoding/json)快 6 倍之多。而且这个性能是在不使用代码生成的前提下获得的。 benchmark

同时官网还提供了完整的 性能评测报告性能优化 是怎么做的的详尽解释。

为什么用 jsoniter?

这是一个悲伤的故事,在工作的时候碰到了上游接口返回的 json 包括了两个时间格式(时间戳和字符串),分别用"createtime"和"createTime" 作为 key。众所周知 Go 的 json 是大小写不敏感的,而这两个字段类型又不同。当我同时解析这两个字段的时候是可以的,但是当我只解析其中一个字段时就会产生 error。当时妥协选择了两个字段同时解析,后来又选择了更合适的 jsoniter 来控制大小写敏感。

二、原生 json 演示

通过下面的例子我们可以复现我当时出现的问题。 只解析 createtime

package main

import (
    "encoding/json"
    "fmt"
)

const jsonText = "{\"createtime\":\"2021-04-03T17:41:48\",\"createTime\":1617442908}\n"

func main() {
    type co struct {
        Createtime string `json:"createtime"`
        //CreateTime int    `json:"createTime"`
    }
    var data co
    text := []byte(jsonText)
    err := json.Unmarshal(text, &data)
    fmt.Println(err)
    fmt.Printf("%+v", data)
}

打印结果为:

json: cannot unmarshal number into Go struct field co.createtime of type string
{Createtime:2021-04-03T17:41:48}

只解析 createTime

type co struct {
    //Createtime string `json:"createtime"`
    CreateTime int `json:"createTime"`
}

打印结果为:

json: cannot unmarshal string into Go struct field co.createTime of type int
{CreateTime:1617442908}

两个都解析

type co struct {
    Createtime string `json:"createtime"`
    CreateTime int    `json:"createTime"`
}

打印结果为:

<nil>
{Createtime:2021-04-03T17:41:48 CreateTime:1617442908}

三、jsoniter 演示

默认不区分大小写

只解析 createtime

package main

import (
    "fmt"

    jsoniter "github.com/json-iterator/go"
)

const jsonText = "{\"createtime\":\"2021-04-03T17:41:48\",\"createTime\":1617442908}\n"

func main() {
    type co struct {
        Createtime string `json:"createtime"`
        //CreateTime int    `json:"createTime"`
    }
    var data co
    text := []byte(jsonText)
    err := jsoniter.Unmarshal(text, &data)
    fmt.Println(err)
    fmt.Printf("%+v", data)
}

打印结果为:

main.co.Createtime: ReadString: expects " or n, but found 1, error found in #10 byte of ...|ateTime":1617442908}|..., bigger context ...|{"createtime":"2021-04-03T17:41:48","createTime":1617442908}
|...
{Createtime:}

由此我们还可以看出 json 虽然大小写不敏感,只解析其中一个字段时也会报错,但是可以解析正确的结果,jsoniter 默认是无法解析的。

设置为区分大小写

package main

import (
    "fmt"

    jsoniter "github.com/json-iterator/go"
)

const jsonText = "{\"createtime\":\"2021-04-03T17:41:48\",\"createTime\":1617442908}\n"

func main() {
    type co struct {
        Createtime string `json:"createtime"`
        //CreateTime int    `json:"createTime"`
    }
    var data co
    text := []byte(jsonText)
    json := jsoniter.Config{CaseSensitive: true}.Froze()
    err := json.Unmarshal(text, &data)
    fmt.Println(err)
    fmt.Printf("%+v", data)
}

打印结果为:

<nil>
{Createtime:2021-04-03T17:41:48}

最后总结一下区别

解析器 解析字段 结果 err == nil
json createtime {Createtime:2021-04-03T17:41:48} false
json createTime {CreateTime:1617442908} false
json createtime、createTime {Createtime:2021-04-03T17:41:48 CreateTime:1617442908} true
jsoniter createtime {Createtime:} false
jsoniter createTime {CreateTime:0} false
jsoniter createtime、createTime {Createtime:2021-04-03T17:41:48 CreateTime:1617442908} true
jsoniter
(区分大小写)
createtime {Createtime:2021-04-03T17:41:48} true
jsoniter
(区分大小写)
createTime {CreateTime:1617442908} true
jsoniter
(区分大小写)
createtime、createTime {Createtime:2021-04-03T17:41:48 CreateTime:1617442908} true

四、jsoniter 用法

除了像上面这种 jsoniter 自定义的特性,我们还可以将 jsoniter 替代 encoding/json 使用

import "encoding/json"
json.Marshal(&data)

替换为

import jsoniter "github.com/json-iterator/go"

var json = jsoniter.ConfigCompatibleWithStandardLibrary
json.Marshal(&data)

import "encoding/json"
json.Unmarshal(input, &data)

替换为

import jsoniter "github.com/json-iterator/go"

var json = jsoniter.ConfigCompatibleWithStandardLibrary
json.Unmarshal(input, &data)

更多用法点此查看

参考文档:

欢迎加入我们 GOLANG 中国社区:https://gocn.vip/

更多原创文章干货分享,请关注公众号
  • 加微信实战群请加微信(注明:实战群):gocnio

别推荐了,已经基本不维护了

需要 登录 后方可回复, 如果你还没有账号请点击这里 注册