Go JSON編碼與解碼？

張君鴻發表於2019-03-30

GoJSON

在開發應用程式時，客戶端(前端頁面或APP)與服務端互動是在所難免的，在互動過程傳遞資料時，最通用和流行格式便是JSON，Go語言提供了encoding/json包，用於處理JSON資料的編碼與解碼。

除了JSON，XML也常用於前後端的資料互動，不過由於簡潔性、可讀性和流行程度，JSON用得更加廣泛。

JSON簡介

1. 什麼是JSON？

JSON全稱為Javascript Object Notation，一種資料結構化互動的標準協議，易於閱讀與編寫，所以在資料互動時廣泛使用。

2. JSON中的資料型別

數字：有十進位制和科學記數學兩種表示方式。
字串：使用雙引號表示的Unicode字元序列。
布林：true或者false。
物件：花括號({})括起來的一個或多個鍵值對(key/value)，用逗號(,)隔開，最後一個鍵值對後面不能有逗號，鍵必是雙引號("")引起來的字串，而值則可是作意型別(布林、數字、物件、陣列、字串)。
陣列：中括號([])括號值的集合，這些值可是任意型別(布林、數字、物件、陣列、字串)。

下面的示例，是一個陣列中包括兩個物件。

[{"id":1,"username":"xiaoming","gender":1,"email":"xiaoming@163.com"},{"id":2,"username":"xiaohong","gender":2,"email":"xiaohong@163.com"}]
複製程式碼

3. 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":"xiaoming@163.com"},{"id":2,"username":"xiaohong","gender":2,"email":"xiaohong@163.com"}]
複製程式碼

編碼

將Go語言的資料序列化為JSON字串的操作，稱為編碼;編碼後的結果為一個JSON格式的字串。

1. json.Marshal函式

使用json.Marshal函式可以直接編碼任意資料型別。

import (
    "encoding/json"
    "fmt"
)
func main() {
members := []Member{
    {
        Id:1,
        Username:"小明",
        Sex:1,
        Email:"xiaoming@163.com",
    },
    {
        Id:2,
        Username:"小紅",
        Sex:1,
        Email:"xiaohong@163.com",
    },
    {
        Id:3,
        Username:"小華",
        Sex:2,
        Email:"xiaohua@163.com",
    },
}
    data,_ := json.Marshal(members)
    fmt.Printf("%s",data)
}
複製程式碼

執行結果：

[{"id":1,"username":"小明","gender":1,"email":"xiaoming@163.com"},{"id":2,"username":"小紅","gender":1,"email":"xiaohong@163.com"},{"id":3,"username":"小華","gender":2,"email":"xiaohua@163.com"}]
複製程式碼

2. json.Encoder

json.Marshal實際上只是對json.Encoder的封裝,因此使用json.Encoder同樣可以編碼JSON。

func main(){
    b := &bytes.Buffer{}
    encoder := json.NewEncoder(b)
    err := encoder.Encode(members)
    if err != nil{
	    panic(err)
    }
    fmt.Println(b.String())
}
複製程式碼

解碼

將JSON字串反序列化為Go相對應型別的作品，稱為解碼。

1. json.Unmarshal函式

json.Unmarshal與json.Marshal函式相反，用於解碼JSON字串。

func main() {
    str := `[
    {
        "id": 1,
        "username": "小明",
        "gender": 1,
        "email": "xiaoming@163.com"
    },
    {
        "id": 2,
        "username": "小紅",
        "gender": 1,
        "email": "xiaohong@163.com"
    },
    {
        "id": 3,
        "username": "小華",
        "gender": 2,
        "email": "xiaohua@163.com"
    }
    ]`
    b := bytes.NewBufferString(str)
    var members []Member
    err := json.Unmarshal(b.Bytes(),&members)
    if err != nil{
        panic(err)
    }
    fmt.Println(members)
}
複製程式碼