README
¶
高效的 JSON 字符串生成器
forked from darjun/json-gen
使用原始数据项生成 JSON, 类似字符拼接, 支持常用类型.
性能比结构体序列化方式快挺多.
改动
- 增加使用
bytespool - 增加添加原始 JSON 数据方法:
RawStringRawBytes- map:
m.PutRawStringm.PutRawBytesm.PutRawStringArraym.PutRawBytesArray - array:
a.AppendRawStringa.AppendRawBytesa.AppendRawStringArraya.AppendRawBytesArray
- map:
- 减少一些不必要的转换
使用
package main
import (
"fmt"
"github.com/fufuok/utils/xjson/jsongen"
)
func main() {
js := jsongen.NewMap()
js.PutString("s", `a"b"\c`)
js.PutFloat("f", 3.14)
js.PutBool("b", false)
jsArr := jsongen.NewArray()
jsArr.AppendInt(7)
jsArr.AppendStringArray([]string{"A", "B"})
js.PutArray("sub", jsArr)
js.PutRawString("raw", `{"n":null,"m":[1,"ff"]}`)
data := js.Serialize(nil)
fmt.Printf("len: %d == %d\n", js.Size(), len(data))
fmt.Printf("%s\n", data)
// Output:
// len: 86 == 86
// {"s":"a\"b\"\\c","f":3.14,"b":false,"sub":[7,["A","B"]],"raw":{"n":null,"m":[1,"ff"]}}
}
json-gen
起源
游戏服务端的很多操作（包括玩家的和非玩家的）需要传给公司中台收集汇总，根据运营的需求分析数据。中台那边要求传过去的数据为 JSON 格式。开始使用 Golang 标准库中的encoding/json，发现性能不够理想（因为序列化使用了反射，涉及多次内存分配）。由于数据原始格式都是map[string]interface{}，且需要自己一个字段一个字段构造，于是我想可以在构造过程中就计算出最终 JSON 串的长度，那么就只需要一次内存分配了。
使用
下载：
$ go get github.com/darjun/json-gen
引入：
import (
jsongen "github.com/darjun/json-gen"
)
构造数组或映射：
// 数组
a := jsongen.NewArray()
a.AppendUint(123)
a.AppendInt(-456)
data := a.Serialize(nil)
// string(data) == "[123,-456]"
// 映射
m := jsongen.NewMap()
m.PutUint("uintkey", 123)
m.PutInt("intkey", -456)
data := m.Serialize(nil)
// string(data) == `{"uintkey":123,"intkey":-456}`
当然类型可以无限嵌套：
subm := jsongen.NewMap()
subm.PutString("stringkey", "test string")
m := jsongen.NewMap()
m.PutUint("uintkey", 123)
m.PutUintArray("uintarray", []uint64{123,456,789})
m.PutMap("subm", subm)
data := m.Serialize(nil)
// string(data) == `{"uintkey":123,"uintarray":[123,456,789],"subm":{"stringkey":"test string"}}`
Benchmark
| Library | Time/op(ns) | B/op | allocs/op |
|---|---|---|---|
| encoding/json | 22209 | 6673 | 127 |
| darjun/json-gen | 3300 | 1152 | 1 |
通常情况下，json-gen生成 JSON 串的性能是标准 JSON 库的10。
Documentation
¶
Overview ¶
Package jsongen forked from darjun/json-gen
Package jsongen Copyright 2024 Joshua J Baker. All rights reserved. Use of this source code is governed by an MIT-style license that can be found in the LICENSE file.
Index ¶
- Variables
- func AppendJSONString(dst []byte, s string) []byte
- func EscapeString(s string) string
- type Array
- func (a *Array) AppendArray(vv ...*Array)
- func (a *Array) AppendArrayArray(vv []*Array)
- func (a *Array) AppendBool(vv ...bool)
- func (a *Array) AppendBoolArray(vv []bool)
- func (a *Array) AppendFloat(vv ...float64)
- func (a *Array) AppendFloatArray(vv []float64)
- func (a *Array) AppendInt(vv ...int64)
- func (a *Array) AppendIntArray(vv []int64)
- func (a *Array) AppendMap(vv ...*Map)
- func (a *Array) AppendMapArray(vv []*Map)
- func (a *Array) AppendRawBytes(bb ...[]byte)
- func (a *Array) AppendRawBytesArray(vv [][]byte)
- func (a *Array) AppendRawString(ss ...string)
- func (a *Array) AppendRawStringArray(ss []string)
- func (a *Array) AppendString(vv ...string)
- func (a *Array) AppendStringArray(vv []string)
- func (a *Array) AppendUint(vv ...uint64)
- func (a *Array) AppendUintArray(vv []uint64)
- func (a *Array) Serialize(buf []byte) []byte
- func (a *Array) Size() int
- type Map
- func (m *Map) PutArray(key string, oa *Array)
- func (m *Map) PutBool(key string, b bool)
- func (m *Map) PutBoolArray(key string, b []bool)
- func (m *Map) PutFloat(key string, f float64)
- func (m *Map) PutFloatArray(key string, f []float64)
- func (m *Map) PutInt(key string, i int64)
- func (m *Map) PutIntArray(key string, i []int64)
- func (m *Map) PutMap(key string, om *Map)
- func (m *Map) PutRawBytes(key string, b []byte)
- func (m *Map) PutRawBytesArray(key string, bs [][]byte)
- func (m *Map) PutRawString(key, s string)
- func (m *Map) PutRawStringArray(key string, ss []string)
- func (m *Map) PutString(key, s string)
- func (m *Map) PutStringArray(key string, s []string)
- func (m *Map) PutUint(key string, u uint64)
- func (m *Map) PutUintArray(key string, u []uint64)
- func (m *Map) Serialize(buf []byte) []byte
- func (m *Map) Size() int
- type RawBytes
- type RawString
- type V
- type Value
Constants ¶
This section is empty.
Variables ¶
var DisableEscapeHTML = false
DisableEscapeHTML will disable the automatic escaping of certain "problamatic" HTML characters when encoding to JSON. These character include '>', '<' and '&', which get escaped to \u003e, \u0026, and \u003c respectively.
This is a global flag and will affect all further gjson operations. Ideally, if used, it should be set one time before other gjson functions are called.
Functions ¶
func AppendJSONString ¶ added in v1.3.0
AppendJSONString is a convenience function that converts the provided string to a valid JSON string and appends it to dst.
Types ¶
type Array ¶
type Array struct {
// contains filtered or unexported fields
}
Array 数组类的 JSON 数据
func (*Array) AppendArray ¶
AppendArray 追加单个或多个 array 到数组: [1,2] => [1,2,[{"A":1}],[true]]
func (*Array) AppendArrayArray ¶ added in v1.3.0
AppendArrayArray 追加 array 数组: [1,2] => [1,2,[[3],[4],[{"b":true}]]]
func (*Array) AppendBool ¶
AppendBool 追加单个或多个 bool 到数组: [1,2] => [1,2,true,false]
func (*Array) AppendBoolArray ¶
AppendBoolArray 追加 bool 数组: [1,2] => [1,2,[true,false]]
func (*Array) AppendFloat ¶
AppendFloat 追加单个或多个 float64 到数组: [1,2] => [1,2,3.1,4]
func (*Array) AppendFloatArray ¶
AppendFloatArray 追加 float64 数组: [1,2] => [1,2,[3,4.1,5]]
func (*Array) AppendIntArray ¶
AppendIntArray 追加 int64 数组: [1,2] => [1,2,[3,4,5]]
func (*Array) AppendMapArray ¶
AppendMapArray 追加 map 数组: [1,2] => [1,2,[{"A":1},{"b":true}]]
func (*Array) AppendRawBytes ¶
AppendRawBytes 追加单个或多个原生 JSON 数据
func (*Array) AppendRawBytesArray ¶
AppendRawBytesArray 追加原生 JSON 数据数组
func (*Array) AppendRawString ¶
AppendRawString 追加单个或多个原生 JSON 字符串, 如: [1,2] => [1,2,[2,{"A":1}]] a.AppendRawString(`[2,{"A":1}]`)
func (*Array) AppendRawStringArray ¶
AppendRawStringArray 追加原生 JSON 字符串数组: [1,2] => [1,2,["x",[4],[{"b":true}]]] a.AppendRawStringArray([]string{`"x"`, `[4]`, `[{"b":true}]`})
func (*Array) AppendString ¶
AppendString 追加单个或多个 string 到数组: [1,2] => [1,2,"A","b"] a.AppendString("A", "b")
func (*Array) AppendStringArray ¶
AppendStringArray 追加 string 数组: [1,2] => [1,2,["A","b"]] a.AppendStringArray([]string{"A","b"})
func (*Array) AppendUint ¶
AppendUint 追加单个或多个 uint64 到数组: [1,2] => [1,2,3,4]
func (*Array) AppendUintArray ¶
AppendUintArray 追加 uint64 数组: [1,2] => [1,2,[3,4,5]]
type Map ¶
type Map struct {
// contains filtered or unexported fields
}
Map 对象类(字典) JSON 数据
func (*Map) PutBoolArray ¶
func (*Map) PutFloatArray ¶
func (*Map) PutIntArray ¶
func (*Map) PutRawBytes ¶
func (*Map) PutRawBytesArray ¶
func (*Map) PutRawString ¶
func (*Map) PutRawStringArray ¶
func (*Map) PutStringArray ¶
func (*Map) PutUintArray ¶
PutUintArray 添加 uint64 数组数据项: {"A":[1,2]}
Source Files