21 Go 文件IO (二)：JSON操作

一、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("写入文件成功！")
}