詳解Go語言中結(jié)構(gòu)體與JSON間的轉(zhuǎn)換

更新時間：2022年12月13日 14:07:26 作者：陳明勇

這篇文章主要為大家詳細(xì)介紹了Go語言中結(jié)構(gòu)體與JSON間的轉(zhuǎn)換，文中的示例代碼講解詳細(xì)，對學(xué)習(xí)Go語言有一定的幫助，需要的可以參考一下

前言

在日常開發(fā)中，我們往往會將 JSON 解析成對應(yīng)的結(jié)構(gòu)體，反之也會將結(jié)構(gòu)體轉(zhuǎn)成 JSON。接下來本文會通過 JSON 包的兩個函數(shù)，來介紹 JSON 與結(jié)構(gòu)體之間的轉(zhuǎn)換。

結(jié)構(gòu)體轉(zhuǎn) JSON

Marshal(v any) ([]byte, error)：將 v 轉(zhuǎn)成 JSON 數(shù)據(jù)，以 []byte 的形式返回。

import (
    "encoding/json"
    "fmt"
)

type User struct {
    Name           string
    Age            int
    Height         float64
    Weight         *float64
    Child          bool
    marriageStatus string
}

func main() {
    weight := 120.5
    user := User{
        Name:           "gopher",
        Age:            18,
        Height:         180.5,
        Weight:         &weight,
        Child:          false,
        marriageStatus: "未婚",
    }
    jsonBytes, err := json.Marshal(user)
    if err != nil {
        fmt.Println("error: ", err)
        return
    }
    fmt.Println(string(jsonBytes)) // {"Name":"gopher","Age":18,"Height":180.5,"Weight":120.5,"Child":false}
}

執(zhí)行結(jié)果：

{"Name":"gopher","Age":18,"Height":180.5,"Weight":120.5,"Child":false}

根據(jù)結(jié)果可知：

不可導(dǎo)出字段（字段名以小寫字母開頭），是不能被轉(zhuǎn)成 JSON 的 key 的，這也符合 Go 的語法規(guī)定，以小寫字母開頭的變量或結(jié)構(gòu)體字段等，不能在包外被訪問。
轉(zhuǎn)換后的字段名，與結(jié)構(gòu)體字段的名字一樣。
如果字段是指針類型，轉(zhuǎn)換后的值為指針指向的字段值。

如果我們想要指定字段轉(zhuǎn)換之后的命名，或者將一個可導(dǎo)出的字段進(jìn)行忽略，可以通過給結(jié)構(gòu)體字段打上 JSON 標(biāo)簽的方式實現(xiàn)。

import (
    "encoding/json"
    "fmt"
)

type User struct {
    Name           string   `json:"name"`
    Age            int      `json:"age"`
    Height         float64  `json:"height"`
    Weight         *float64 `json:"weight"`
    Child          bool     `json:"child"`
    MarriageStatus string   `json:"-"`
}

func main() {
    weight := 120.5
    user := User{
        Name:           "gopher",
        Age:            18,
        Height:         180.5,
        Weight:         &weight,
        Child:          false,
        MarriageStatus: "未婚",
    }
    jsonBytes, err := json.Marshal(user)
    if err != nil {
        fmt.Println("error: ", err)
        return
    }
    fmt.Println(string(jsonBytes)) // {"name":"gopher","age":18,"height":180.5,"weight":120.5,"child":false}
}

通過給結(jié)構(gòu)體字段定打上 JSON 標(biāo)簽，可指定轉(zhuǎn)成 JSON 后的字段名，如果 JSON 標(biāo)簽的值為 -，則在轉(zhuǎn)換 JSON 時忽略此字段。

JSON 解析結(jié)構(gòu)體

Unmarshal(data []byte, v any) error：將 JSON 解析成指定的結(jié)構(gòu)體。

import (
    "encoding/json"
    "fmt"
)

type User struct {
    Name           string  `json:"name"`
    Age            int     `json:"age"`
    Height         float64 `json:"height"`
    Child          bool    `json:"-"`
    marriageStatus string
}

func main() {
    userStr := `
    {
      "name": "gopher",
      "age": 18,
      "height": 180.5,
      "child": true,
      "marriageStatus": "未婚"
    }
    `
    user := &User{}
    err := json.Unmarshal([]byte(userStr), &user)
    if err != nil {
        fmt.Println("error: ", err)
        return
    }
    fmt.Printf("%#v", user) // &main.User{Name:"gopher", Age:18, Height:180.5, Child:false, marriageStatus:""}
}

執(zhí)行結(jié)果：

&main.User{Name:"gopher", Age:18, Height:180.5, Child:false, marriageStatus:""}

根據(jù)結(jié)果可知：

使用Unmarshal函數(shù)時，我們需要傳入結(jié)構(gòu)體的指針類型，否則結(jié)構(gòu)體字段的值將不會被改變，因為底層是通過指針去修改結(jié)構(gòu)體字段的值。

JSON 解析時，JSON 的 key 與結(jié)構(gòu)體字段的匹配規(guī)則是：

優(yōu)先查找 JSON 標(biāo)簽值和 key 一樣的，找到則將 value 賦值給對應(yīng)字段。
如果沒有 JSON 標(biāo)簽值與 key 相匹配，則根據(jù)字段名進(jìn)行匹配。

可以發(fā)現(xiàn)，如果結(jié)構(gòu)體字段是非導(dǎo)出字段或 JSON 標(biāo)簽的值為 -，將不會被匹配到。

小結(jié)

本文介紹了 Go 語言里，JSON 與結(jié)構(gòu)體之間的轉(zhuǎn)換。在結(jié)構(gòu)體轉(zhuǎn) JSON 時，我們可以通過給字段打標(biāo)簽，指定轉(zhuǎn)換后的 key 命名，需要注意的是，如果結(jié)構(gòu)體的字段為非導(dǎo)出字段或字段的 JSON 標(biāo)簽值為 -，在轉(zhuǎn)換 JSON 時，將會被忽略。反之 JSON 解析結(jié)構(gòu)體時也是一樣的。

到此這篇關(guān)于詳解Go語言中結(jié)構(gòu)體與JSON間的轉(zhuǎn)換的文章就介紹到這了,更多相關(guān)Go語言結(jié)構(gòu)體 JSON內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: