Go Book / 1 Go Basics / 21 Go 文件 I O (二): J S O N操作

21 Go 文件 I O (二): J S O N操作

一、JSON概述

JSON是JavaScript Object Notation的缩写,它是一种数据交换格式。其数据结构完全是JavaScript的子集,由于其非常轻量,现在许多项目开发已经使用JSON替代XML作为数据传输格式。

其结构示例如下:

{"name":"fun","age":11,"hobbit":["旅游","读书","撸代码"]}

JSON被其设计者作为JavaScript的子集,除JavaScript对其类型兼容外,其他各种语言使用json都需要解析,由于其格式对机器和人都十分友好,所以这种类型转化还是合理的。

Go标准库提供encoding包支持数据交换格式的编解码和序列化操作,除json外还支持xml、base64、pem等编码格式。由于JSON比较流行,这里只拿JSON作为演示,其他类型的编码操作也差不多,有需求需要编解码特定类型可自行参考go标准库文档。

二、Go Json操作演示

1.序列与反序列化

序列化和反序列化为Go内置类型和json类型之间的转换。

示例一:json序列化 —— go数据类型转json字符串 【结构体|map|切片】
import (
	"encoding/json"
	"fmt"
	"os"
)


type Person struct {
	Name   string   `json:"name"`
	Age    int      `json:"age"`
	Hobbit []string `json:"hobbit"`
}

func BaseJson01() {

	//基础数据
	funPerson := Person{"fun", 11, []string{"旅游", "读书", "撸代码"}}
	johnPerson := Person{"john", 10, []string{"吃饭", "睡觉", "打豆豆"}}
	jackPerson := Person{"jack", 2, []string{"吃饭", "睡觉"}}
	//创建一个切片容器
	familySlice := make([]Person, 0)
	familySlice = append(familySlice, funPerson, johnPerson, jackPerson)

	mapPerson := make(map[string]interface{}, 0)
	mapPerson["name"] = "lee"
	mapPerson["age"] = 19
	mapPerson["hobbit"] = []string{"aaa", "bbb", "ccc"}

	//结构体转json字符串
	bytes, e := json.Marshal(funPerson)
	if e != nil {
		fmt.Println("序列化出现错误:", e)
		return
	} else {
		fmt.Println(funPerson)
		fmt.Println(string(bytes))
	}

	//map转json字符串
	mapBytes, e1 := json.Marshal(mapPerson)
	if e1 != nil {
		fmt.Println("序列化出现错误:", e1)
		return
	} else {
		fmt.Println(mapPerson)
		fmt.Println(string(mapBytes))
	}

	//slice转json字符串
	familyBytes, e2 := json.Marshal(familySlice)
	if e2 != nil {
		fmt.Println("序列化出现错误:", e2)
		return
	} else {
		fmt.Println(familySlice)
		fmt.Println(string(familyBytes))
	}
}
示例二:反序列化json — json字符串转go数据类型 【结构体|map|切片】
func BaseJson02() {
	//示例数据
	funPersonJson := `{"name":"fun","age":11,"hobbit":["旅游","读书","撸代码"]}`
	familySliceJson := `[{"name":"fun","age":11,"hobbit":["旅游","读书","撸代码"]},{"name":"john","age":10,"hobbit":["吃饭","睡觉","打豆豆"]},{"name":"jack","age":2,"hobbit":["吃饭","睡觉"]}]`

	//json字符串反序列化为结构体
	funPersonPrt := new(Person)
	err := json.Unmarshal([]byte(funPersonJson), funPersonPrt)
	if err != nil {
		fmt.Println("反序列化错误:", err)
	} else {
		fmt.Println(*funPersonPrt)
	}

	//json字符串反序列化为map
	funMap := make(map[string]interface{}, 0)
	err = json.Unmarshal([]byte(funPersonJson), &funMap)
	if err != nil {
		fmt.Println("反序列化错误:", err)
	} else {
		fmt.Println(funMap)
	}

	//json字符串反序列化为切片结构体
	familySliceSturct := make([]Person, 0)
	err = json.Unmarshal([]byte(familySliceJson), &familySliceSturct)
	if err != nil {
		fmt.Println("反序列化错误:", err)
	} else {
		fmt.Println(familySliceSturct)
	}

	//json字符串反序列化为切片map
	familySliceMap := make([]map[string]interface{}, 0)
	err = json.Unmarshal([]byte(familySliceJson), &familySliceMap)
	if err != nil {
		fmt.Println("反序列化错误:", err)
	} else {
		fmt.Println(familySliceMap)
	}
}

2.编码与解码

编解码一般为IO,是程序中的运行时数据到文件的读写操作。

示例三:读Json文件到go程序 即解码json文件
// 【结构体|map|map切片|结构体切片】
func BaseJson03() {
	//先打开json文件
	src, e := os.OpenFile("/path/to/j11.json", os.O_RDONLY, 0666)
	if e != nil {
		fmt.Println("打开文件错误:", e)
		return
	}
	defer src.Close()
    
    //准备一个结构体指针
	person := new(Person)
    
    //从文件解码数据到结构体
	decoder := json.NewDecoder(src)
	err1 := decoder.Decode(person)
	if err1 != nil {
		fmt.Println("打开文件错误:", err1)
		return
	} else {
		fmt.Println(*person)
	}

}
示例四:从go程序写出json文件 即编码到json文件【结构体|map|map切片|结构体切片】
func BaseJson04() {
	//基础数据
	funPerson := Person{"fun", 11, []string{"旅游", "读书", "撸代码"}}
	johnPerson := Person{"john", 10, []string{"吃饭", "睡觉", "打豆豆"}}
	jackPerson := Person{"jack", 2, []string{"吃饭", "睡觉"}}
	//切片容器
	familySlice := make([]Person, 0)
	familySlice = append(familySlice, funPerson, johnPerson, jackPerson)
    
    //创建一个待被写入的文件
	dst, e := os.OpenFile("/path/to/j33.json", os.O_CREATE|os.O_WRONLY, 0666)
	if e != nil {
		fmt.Println("打开文件错误:", e)
		return
	}
	defer dst.Close()
    
    //json编码到文件
	encoder := json.NewEncoder(dst)
	err := encoder.Encode(&familySlice)
	if err != nil {
		fmt.Println("打开文件错误:", err)
		return
	}
	fmt.Println("写入文件成功!")
}