Go JSON编码与解码?
JSON简介
1. 什么是JSON?
JSON全称为Javascript Object Notation,一种数据结构化交互的标准协议,易于阅读与编写,所以在数据交互时广泛使用。
2. JSON中的数据类型
- 数字:有十进制和科学记数学两种表示方式。
- 字符串:使用双引号表示的Unicode字符序列。
- 布尔:true或者false。
- 对象:花括号(
{}
)括起来的一个或多个键值对(key/value),用逗号(,)
隔开,最后一个键值对后面不能有逗号,键必是双引号(""
)引起来的字符串,而值则可是作意类型(布尔、数字、对象、数组、字符串)。 - 数组:中括号(
[]
)括号值的集合,这些值可是任意类型(布尔、数字、对象、数组、字符串)。
下面的示例,是一个数组中包括两个对象。
[{"id":1,"username":"xiaoming","gender":1,"email":"[email protected]"},{"id":2,"username":"xiaohong","gender":2,"email":"[email protected]"}]
JSON与GO结合
使用encoding/json处理JSON编码与解码时,就必须处理好JSON数据类型与Go语言数据类型的对应关系。
- JSON的数字、字符串、布尔等在Go语言中相应内置数据类型一一对应。
- JSON的数组则对应Go的数组或Slice(切片)。
- JSON的对象则对应Go的struct(结构体)或map。
编码一个结构体时,结构体中只有首字母大写的成员才会被编码,首字母小写的成员会被忽略,另外,结构体中字段后面允许使用反引号声明成员的Tag,用于说明成员的元信息。
type Member struct {
Id int `json:"id"`
Username string `json:"username"`
Sex uint `json:"gender"`
Email string `json:"email"`
}
上面的结构体Member中,我们定义了四个成员,并声明了每个成员的Tag信息, 其中Sex的Tag信息声明为gender,所以编码后的结果为:
[{"id":1,"username":"xiaoming","gender":1,"email":"[email protected]"},{"id":2,"username":"xiaohong","gender":2,"email":"[email protected]"}]
编码
将Go语言的数据序列化为JSON字符串的操作,称为编码;编码后的结果为一个JSON格式的字符串。
1. json.Marshal函数
使用json.Marshal函数可以直接编码任意数据类型。
import (
"encoding/json"
"fmt"
)
func main() {
members := []Member{
{
Id:1,
Username:"小明",
Sex:1,
Email:"[email protected]",
},
{
Id:2,
Username:"小红",
Sex:1,
Email:"[email protected]",
},
{
Id:3,
Username:"小华",
Sex:2,
Email:"[email protected]",
},
}
data,_ := json.Marshal(members)
fmt.Printf("%s",data)
}
运行结果:
[{"id":1,"username":"小明","gender":1,"email":"[email protected]"},{"id":2,"username":"小红","gender":1,"email":"[email protected]"},{"id":3,"username":"小华","gender":2,"email":"[email protected]"}]
json.Encoder
json.Marshal实际上只是对json.Encoder的封装,因此使用json.Encoder同样可以编码JSON。
案例1
func main(){
b := &bytes.Buffer{}
encoder := json.NewEncoder(b)
err := encoder.Encode(members)
if err != nil{
panic(err)
}
fmt.Println(b.String())
}
案例 2
import (
"encoding/json"
"os"
)
type person struct {
First string
Last string
Age int
notExported int
}
func main() {
p1 := person{"James", "Bond", 20, 007}
json.NewEncoder(os.Stdout).Encode(p1)
}
解码
将JSON字符串反序列化为Go相对应类型的作品,称为解码。
1. json.Unmarshal函数
json.Unmarshal与json.Marshal函数相反,用于解码JSON字符串。
案例3
func main() {
str := `[
{
"id": 1,
"username": "小明",
"gender": 1,
"email": "[email protected]"
},
{
"id": 2,
"username": "小红",
"gender": 1,
"email": "[email protected]"
},
{
"id": 3,
"username": "小华",
"gender": 2,
"email": "[email protected]"
}
]`
b := bytes.NewBufferString(str)
var members []Member
err := json.Unmarshal(b.Bytes(),&members)
if err != nil{
panic(err)
}
fmt.Println(members)
}
运行结果:
[{1 小明 1 [email protected]}
{2 小红 1 [email protected]}
{3 小华 2 [email protected]}]
2. json.Decoder
func main(){
b := bytes.NewBufferString(str)
var members []Member
decoder := json.NewDecoder(b)
err = decoder.Decode(&members)
if err != nil{
panic(err)
}
fmt.Println(members)
}
案例4
package main
import (
"encoding/json"
"fmt"
"strings"
)
type person struct {
First string
Last string
Age int
notExported int
}
func main() {
var p1 person
rdr := strings.NewReader(`{"First":"James", "Last":"Bond", "Age":20}`)
json.NewDecoder(rdr).Decode(&p1)
fmt.Println(p1.First)
fmt.Println(p1.Last)
fmt.Println(p1.Age)
}
结构体转json
import (
"encoding/json"
"fmt"
)
type person struct {
First string `json:"first"`
Last string `json:"last"`
Age int `json:"wisdom score"`
}
func main() {
p1 := person{"James", "Bond", 20}
fmt.Println(p1) //{James Bond 20}
bs, _ := json.Marshal(p1)
fmt.Println(string(bs)) // {"first":"James","last":"Bond","wisdom score":20}
}
json转结构体
import (
"encoding/json"
"fmt"
)
type person struct {
First string
Last string
Age int
}
func main() {
var p1 person
bs := []byte(`{"First":"James", "Last":"Bond", "Age":20}`)
json.Unmarshal(bs, &p1)
fmt.Println("--------------")
fmt.Println(p1.First) // James
fmt.Println(p1.Last) //Bond
fmt.Println(p1.Age) //20
fmt.Printf("%v \n", p1) //{James Bond 20}
fmt.Printf("%T \n", p1) // main.person
}