forked from github/multus-cni
ac21a96804
gomodule is still in progress to migrate for now, hence multus team decide to keep vendor directory to support build without gomodule.
92 lines
2.9 KiB
Markdown
92 lines
2.9 KiB
Markdown
[](https://sourcegraph.com/github.com/json-iterator/go?badge)
|
||
[](http://godoc.org/github.com/json-iterator/go)
|
||
[](https://travis-ci.org/json-iterator/go)
|
||
[](https://codecov.io/gh/json-iterator/go)
|
||
[](https://goreportcard.com/report/github.com/json-iterator/go)
|
||
[](https://raw.githubusercontent.com/json-iterator/go/master/LICENSE)
|
||
[](https://gitter.im/json-iterator/Lobby)
|
||
|
||
A high-performance 100% compatible drop-in replacement of "encoding/json"
|
||
|
||
You can also use thrift like JSON using [thrift-iterator](https://github.com/thrift-iterator/go)
|
||
|
||
```
|
||
Go开发者们请加入我们，滴滴出行平台技术部 taowen@didichuxing.com
|
||
```
|
||
|
||
# Benchmark
|
||
|
||
|
||
|
||
Source code: https://github.com/json-iterator/go-benchmark/blob/master/src/github.com/json-iterator/go-benchmark/benchmark_medium_payload_test.go
|
||
|
||
Raw Result (easyjson requires static code generation)
|
||
|
||
| | ns/op | allocation bytes | allocation times |
|
||
| --- | --- | --- | --- |
|
||
| std decode | 35510 ns/op | 1960 B/op | 99 allocs/op |
|
||
| easyjson decode | 8499 ns/op | 160 B/op | 4 allocs/op |
|
||
| jsoniter decode | 5623 ns/op | 160 B/op | 3 allocs/op |
|
||
| std encode | 2213 ns/op | 712 B/op | 5 allocs/op |
|
||
| easyjson encode | 883 ns/op | 576 B/op | 3 allocs/op |
|
||
| jsoniter encode | 837 ns/op | 384 B/op | 4 allocs/op |
|
||
|
||
Always benchmark with your own workload.
|
||
The result depends heavily on the data input.
|
||
|
||
# Usage
|
||
|
||
100% compatibility with standard lib
|
||
|
||
Replace
|
||
|
||
```go
|
||
import "encoding/json"
|
||
json.Marshal(&data)
|
||
```
|
||
|
||
with
|
||
|
||
```go
|
||
import "github.com/json-iterator/go"
|
||
|
||
var json = jsoniter.ConfigCompatibleWithStandardLibrary
|
||
json.Marshal(&data)
|
||
```
|
||
|
||
Replace
|
||
|
||
```go
|
||
import "encoding/json"
|
||
json.Unmarshal(input, &data)
|
||
```
|
||
|
||
with
|
||
|
||
```go
|
||
import "github.com/json-iterator/go"
|
||
|
||
var json = jsoniter.ConfigCompatibleWithStandardLibrary
|
||
json.Unmarshal(input, &data)
|
||
```
|
||
|
||
[More documentation](http://jsoniter.com/migrate-from-go-std.html)
|
||
|
||
# How to get
|
||
|
||
```
|
||
go get github.com/json-iterator/go
|
||
```
|
||
|
||
# Contribution Welcomed !
|
||
|
||
Contributors
|
||
|
||
* [thockin](https://github.com/thockin)
|
||
* [mattn](https://github.com/mattn)
|
||
* [cch123](https://github.com/cch123)
|
||
* [Oleg Shaldybin](https://github.com/olegshaldybin)
|
||
* [Jason Toffaletti](https://github.com/toffaletti)
|
||
|
||
Report issue or pull request, or email taowen@gmail.com, or [](https://gitter.im/json-iterator/Lobby)
|