README
¶
simplejson.go
simplejson-go is a simple and powerful Go module for JSON parsing.
Overview
This module provides the most friendly way to use JSON in golang.
Features
- Easy load to json and dump to string
- Load and dump with file is supported
- Modify the json data is simple
- One line retrieval with MustXXX
- Get by dot notation key is supported
Installation
go get -u github.com/likexian/simplejson-go
Importing
import (
"github.com/likexian/simplejson-go"
)
Documentation
Visit the docs on GoDoc
Example
Dump the struct data to JSON string
// Define Status struct
type Status struct {
Code int64 `json:"code"`
Message string `json:"message"`
}
// Init status
status := Status{1, "Success"}
// Dump status to json string
j := simplejson.New(status)
s, err := j.Dumps()
if err == nil {
fmt.Println("Json text is:", s)
}
// OR dumps using the easy way
s, err := simplejson.Dumps(status)
if err == nil {
fmt.Println("Json text is:", s)
}
Dump the map data to JSON string
// Init a map data
data := map[string]interface{}{
"code": 1,
"message": "success",
"result": {
"Name": "Li Kexian"
}
}
// Dump to string in the easy way
s, err := simplejson.Dumps(status)
if err == nil {
fmt.Println("Json text is:", s)
}
Load the JSON string
// Json strig
text := `{"Code": 1, "Message": "Success", "Result": {"Student": [{"Name": "Li Kexian"}]}}`
// Load json string
j, err := simplejson.Loads(text)
if err == nil {
fmt.Println("Code is:", j.Get("Code").MustInt(0))
fmt.Println("Message is:", j.Get("Message").MustString(""))
fmt.Println("First Student name is:", j.Get("Result.Student.0.Name").MustString("-"))
}
LICENSE
Copyright 2012-2019 Li Kexian
Licensed under the Apache License 2.0
About
DONATE
Documentation
¶
Index ¶
- func Author() string
- func Dump(path string, data interface{}) error
- func Dumps(data interface{}) (string, error)
- func License() string
- func PrettyDumps(data interface{}) (string, error)
- func Version() string
- type Json
- func (j *Json) Array() (result []interface{}, err error)
- func (j *Json) Bool() (result bool, err error)
- func (j *Json) Del(key string)
- func (j *Json) Dump(path string) (err error)
- func (j *Json) Dumps() (result string, err error)
- func (j *Json) Float64() (result float64, err error)
- func (j *Json) Get(key string) *Json
- func (j *Json) Has(key string) bool
- func (j *Json) Index(i int) *Json
- func (j *Json) Int() (result int, err error)
- func (j *Json) Int64() (result int64, err error)
- func (j *Json) IsArray() bool
- func (j *Json) IsMap() bool
- func (j *Json) Len() int
- func (j *Json) Load(path string) error
- func (j *Json) Loads(text string) error
- func (j *Json) Map() (result map[string]interface{}, err error)
- func (j *Json) MustArray(args ...[]interface{}) []interface{}
- func (j *Json) MustBool(args ...bool) bool
- func (j *Json) MustFloat64(args ...float64) float64
- func (j *Json) MustInt(args ...int) int
- func (j *Json) MustInt64(args ...int64) int64
- func (j *Json) MustMap(args ...map[string]interface{}) map[string]interface{}
- func (j *Json) MustString(args ...string) string
- func (j *Json) MustStringArray(args ...[]string) []string
- func (j *Json) MustTime(args ...interface{}) time.Time
- func (j *Json) MustUint64(args ...uint64) uint64
- func (j *Json) PrettyDumps() (result string, err error)
- func (j *Json) Set(key string, value interface{})
- func (j *Json) SetHtmlEscape(escape bool)
- func (j *Json) String() (result string, err error)
- func (j *Json) StringArray() (result []string, err error)
- func (j *Json) Time(args ...string) (result time.Time, err error)
- func (j *Json) Uint64() (result uint64, err error)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func PrettyDumps ¶
PrettyDumps marshal json object to string, with identation
Types ¶
type Json ¶
type Json struct {
// contains filtered or unexported fields
}
Json storing json data
func New ¶
func New(args ...interface{}) *Json
New returns a pointer to a new Json object
data_json := New()
data_json := New(type Data struct{data string}{"zzz"})
data_json := New(map[string]interface{}{"iam": "Li Kexian"})
func (*Json) Del ¶
Del delete key-value from json object, dot(.) separated key is supported
json.Del("status")
json.Del("status.code")
! NOT SUPPORTED json.Del("result.intlist.3")
func (*Json) Get ¶
Get returns the pointer to json object by key, dot(.) separated key is supported
json.Get("status").Int()
json.Get("status.code").Int()
json.Get("result.intlist.3").Int()
func (*Json) Has ¶
Has check json object has key, dot(.) separated key is supported
json.Has("status")
json.Has("status.code")
json.Has("result.intlist.3")
func (*Json) Index ¶
Index returns a pointer to the index of json object
json.Get("int_list").Index(1).Int()
func (*Json) MustArray ¶
func (j *Json) MustArray(args ...[]interface{}) []interface{}
MustArray returns as array from json object with optional default value if error return default(if set) or panic
func (*Json) MustBool ¶
MustBool returns as bool from json object with optional default value if error return default(if set) or panic
func (*Json) MustFloat64 ¶
MustFloat64 returns as float64 from json object with optional default value if error return default(if set) or panic
func (*Json) MustInt ¶
MustInt returns as int from json object with optional default value if error return default(if set) or panic
func (*Json) MustInt64 ¶
MustInt64 returns as int64 from json object with optional default value if error return default(if set) or panic
func (*Json) MustMap ¶
MustMap returns as map from json object with optional default value if error return default(if set) or panic
func (*Json) MustString ¶
MustString returns as string from json object with optional default value if error return default(if set) or panic
func (*Json) MustStringArray ¶
MustStringArray returns as string from json object with optional default value if error return default(if set) or panic
func (*Json) MustTime ¶
MustTime returns as time.Time from json object if error return default(if set) or panic
json.Time() // No format, No default
json.Time("2006-01-02 15:04:05") // Has format, No default
json.Time(time.Unix(1548907870, 0)) // No format, Has default
json.Time("2006-01-02 15:04:05", time.Unix(1548907870, 0)) // Has format, Has default
func (*Json) MustUint64 ¶
MustUint64 returns as uint64 from json object with optional default value if error return default(if set) or panic
func (*Json) PrettyDumps ¶
PrettyDumps marshal json object to string, with identation
func (*Json) Set ¶
Set set key-value to json object, dot(.) separated key is supported
json.Set("status", 1)
json.Set("status.code", 1)
! NOT SUPPORTED json.Set("result.intlist.3", 666)
func (*Json) SetHtmlEscape ¶
SetHtmlEscape set html escape for escaping of <, >, and & in JSON strings
func (*Json) StringArray ¶
StringArray returns as string array from json object
Source Files