golang物件轉json

在golang中將一個物件轉換成json是一件非常常見的事情，相信大部分golang開發者都會遇到。本篇文章就來分享一下在golang中如何將一個物件轉換成json的方法和技巧。

1. 使用encoding/json套件

首先來看golang標準函式庫中提供的encoding/json套件。這個套件提供了非常簡單易用的函數和類型，可以讓我們輕鬆地將一個物件轉換成json格式的字串或將一個json格式的字串轉換成一個物件。

要注意的是，物件必須是可導出的（即首字母大寫），否則json套件無法存取它的欄位。

下面是使用encoding/json套件將Student物件轉換成json格式字串的簡單範例程式碼：

package main

import (
    "encoding/json"
    "fmt"
)

type Student struct {
    Name  string
    Age   int
    Score float64
}

func main() {
    s := Student{
        Name:  "Tom",
        Age:   18,
        Score: 90.5,
    }
    b, err := json.Marshal(s)
    if err != nil {
        fmt.Println("json.Marshal failed:", err)
        return
    }
    fmt.Println(string(b))
}

輸出：

{"Name":"Tom","Age":18,"Score":90.5}

可以看到，json套件提供的Marshal函數可以將一個結構體物件序列化成json格式的字串。

對於一個複雜的對象，我們也可以很容易地把它序列化成json格式的字串。例如下面這個由多個Student物件組成的陣列：

package main

import (
    "encoding/json"
    "fmt"
)

type Student struct {
    Name  string
    Age   int
    Score float64
}

func main() {
    students := []Student{
        {Name: "Tom", Age: 18, Score: 90.5},
        {Name: "Jerry", Age: 19, Score: 96.5},
        {Name: "Alice", Age: 17, Score: 85.5},
    }
    b, err := json.Marshal(students)
    if err != nil {
        fmt.Println("json.Marshal failed:", err)
        return
    }
    fmt.Println(string(b))
}

輸出：

[{"Name":"Tom","Age":18,"Score":90.5},{"Name":"Jerry","Age":19,"Score":96.5},{"Name":"Alice","Age":17,"Score":85.5}]

同樣的，我們可以使用json套件提供的Unmarshal函數將一個json格式的字串解析成一個對象。例如：

package main

import (
    "encoding/json"
    "fmt"
)

type Point struct {
    X int `json:"x"`
    Y int `json:"y"`
}

type Line struct {
    Start Point `json:"start"`
    End   Point `json:"end"`
}

func main() {
    jsonStr := `
    {
        "start": {
            "x": 1,
            "y": 2
        },
        "end": {
            "x": 3,
            "y": 4
        }
    }`
    var line Line
    err := json.Unmarshal([]byte(jsonStr), &line)
    if err != nil {
        fmt.Println("json.Unmarshal failed:", err)
        return
    }
    fmt.Printf("%#v
", line)
}

輸出：

main.Line{Start:main.Point{X:1, Y:2}, End:main.Point{X:3, Y:4}}

在這個範例程式碼中，我們定義了一個Line對象，它包含了兩個Point對象。使用json套件提供的Unmarshal函數將一個json格式的字串解析成Line對象，然後進行輸出。

2. 透過結構體tag進行自訂json序列化與反序列化

#如果我們想要自訂json格式的輸出，例如修改某個欄位的名字，該怎麼辦呢？這時候，golang中的struct tag就派上用場了。

在golang中，struct tag是一種對struct字段進行註解的方式，可以透過在字段的類型後面添加字串的方式實現。在使用json包序列化和反序列化時，我們可以使用struct tag來控制序列化和反序列化的過程。

下面是一個簡單的範例程式碼，示範如何使用struct tag控制json序列化和反序列化的過程：

package main

import (
    "encoding/json"
    "fmt"
)

type Student struct {
    Name  string `json:"name"`
    Age   int    `json:"age"`
    Score float64
}

func main() {
    s := Student{
        Name:  "Tom",
        Age:   18,
        Score: 90.5,
    }
    fmt.Println("*** 序列化 ***")
    b, err := json.Marshal(s)
    if err != nil {
        fmt.Println("json.Marshal failed:", err)
        return
    }
    fmt.Println(string(b))

    fmt.Println("*** 反序列化 ***")
    jsonStr := `{"name":"Tom","age":18,"Score":90.5}`
    var student Student
    err = json.Unmarshal([]byte(jsonStr), &student)
    if err != nil {
        fmt.Println("json.Unmarshal failed:", err)
        return
    }
    fmt.Printf("%#v
", student)
}

輸出：

*** 序列化 ***
{"name":"Tom","age":18,"Score":90.5}
*** 反序列化 ***
main.Student{Name:"Tom", Age:18, Score:90.5}

這裡，我們將Student物件中的Name欄位標註成"name"，這樣使用json.Marshal函式序列化時，就會將它的名字變成"name"。同樣，使用json.Unmarshal函數反序列化時，也會自動辨識"name"為Name欄位。

透過struct tag的形式，我們也可以控制json輸出中欄位的可見性。例如：

package main

import (
    "encoding/json"
    "fmt"
)

type Student struct {
    Name  string `json:"name,omitempty"`
    Age   int    `json:"age"`
    Score float64
}

func main() {
    s := Student{
        Age:   18,
        Score: 90.5,
    }
    fmt.Println("*** 序列化 ***")
    b, err := json.Marshal(s)
    if err != nil {
        fmt.Println("json.Marshal failed:", err)
        return
    }
    fmt.Println(string(b))

    fmt.Println("*** 反序列化 ***")
    jsonStr := `{"name":"Tom","age":18,"Score":90.5}`
    var student Student
    err = json.Unmarshal([]byte(jsonStr), &student)
    if err != nil {
        fmt.Println("json.Unmarshal failed:", err)
        return
    }
    fmt.Printf("%#v
", student)
}

輸出：

*** 序列化 ***
{"age":18,"Score":90.5}
*** 反序列化 ***
main.Student{Name:"Tom", Age:18, Score:90.5}

這裡我們將Name欄位標註成"omitempty"，意思是如果Name欄位的值是零值（即""），那麼在json輸出時就忽略這個字段。

3. 使用第三方函式庫

當我們需要更複雜的json序列化和反序列化時，golang標準函式庫或許就有點力不足了。這時候，我們可以藉助一些第三方函式庫，來幫助我們實現更靈活的操作。

下面是一個使用第三方函式庫進行json序列化和反序列化的範例程式碼，這個範例程式碼使用了json-iterator/go套件，這個套件是目前最快的golang json函式庫之一。

package main

import (
    "fmt"
    "github.com/json-iterator/go"
)

type Student struct {
    Name  string `json:"name"`
    Age   int    `json:"age"`
    Score float64 `json:"score,omitempty"`
}

func main() {
    student := Student{
        Name:  "Tom",
        Age:   18,
        Score: 0,
    }
    fmt.Println("*** 序列化 ***")
    json := jsoniter.ConfigCompatibleWithStandardLibrary
    b, err := json.Marshal(student)
    if err != nil {
        fmt.Println("json.Marshal failed:", err)
        return
    }
    fmt.Println(string(b))

    fmt.Println("*** 反序列化 ***")
    jsonStr := `{"name":"Tom","age":18}`
    err = json.Unmarshal([]byte(jsonStr), &student)
    if err != nil {
        fmt.Println("json.Unmarshal failed:", err)
        return
    }
    fmt.Printf("%#v
", student)
}

輸出：

*** 序列化 ***
{"name":"Tom","age":18}
*** 反序列化 ***
main.Student{Name:"Tom", Age:18, Score:0}

要注意的是，使用第三方函式庫雖然可以實現更靈活的json操作，但同時也可能會引入效能降低或程式碼複雜度增加等問題，需根據具體場景進行選擇。

本文介紹了幾種golang中將物件轉換成json的方法和技巧，希望本文能對讀者有所幫助。

以上是golang物件轉json的詳細內容。更多資訊請關注PHP中文網其他相關文章！