如何在Go中使用自訂JSON序列化？

隨著現代程式語言對資料結構和網路傳輸的要求越來越高，JSON格式也成為了一種重要的資料交換格式。 JSON能夠更好的傳輸數據，而Go語言因為具有高效能和簡單的應用介面而受到越來越多的青睞。在Go中，可以透過自訂JSON序列化來更好的滿足資料傳輸的需求。本文將會探討如何在Go中使用自訂JSON序列化。

一、什麼是JSON序列化？

JSON序列化是指將一個物件轉換為JSON格式的字串，在網路傳輸中傳送給其他服務或客戶端，使其能夠順利讀取和使用該物件。在序列化後的JSON字串中，每個屬性名稱都會被轉換為字串，並且每個值也會相應的轉換為JSON中對應的類型，以確保在不同的語言之間實現通用的數據傳輸格式。

二、Go中的JSON序列化

在Go語言中，可以透過使用標準函式庫中的‘encoding/json’來實現JSON序列化。當資料結構是一般的結構體和單獨的值時，可以直接使用標準函式庫的Marshal函數將其轉換為對應的JSON字串，如下所示：

type User struct {
    Username string `json:"username"`
    Password string `json:"password"`
}

func main() {
    user := User{"Amy", "123456"}
    jsonStr, err := json.Marshal(user)
    if err != nil {
        panic(err)
    }
    fmt.Println(string(jsonStr))
}

輸出的JSON字串為：

{"username":"Amy","password":"123456"}

三、自訂JSON序列化

在Go語言中，可以透過實作MarshalJSON和UnmarshalJSON方法來自訂JSON序列化。 MarshalJSON方法用於將一個結構體或類型轉換為JSON字串，而UnmarshalJSON則能夠將JSON字串轉換為對應的結構體或類型。

在實作自訂JSON序列化之前，需要先了解幾個結構標籤：

1. json：當定義結構體時，可以在欄位前加上'json:” custom_name”'來定義該欄位在序列化JSON字串時的名稱。
2. omitempty：當字段值時非空的時候，在序列化時會包含該字段，而當該字段為空時，則不包含該字段。

接下來，以薪資為例，實作一個自訂的JSON序列化。

type Salary struct {
    Basic int `json:"basic,omitempty"`
    Bonus int `json:"bonus,omitempty"`
}

func (s Salary) MarshalJSON() ([]byte, error) {
    var result string
    if s.Bonus != 0 {
        result = fmt.Sprintf(""basic":%d,"bonus":%d", s.Basic, s.Bonus)
    } else {
        result = fmt.Sprintf(""basic":%d", s.Basic)
    }
    return []byte("{" + result + "}"), nil
}

func main() {
    salary := Salary{
        Basic:  10000,
        Bonus:  5000,
    }
    jsonStr, err := json.Marshal(salary)
    if err != nil {
        panic(err)
    }
    fmt.Println(string(jsonStr))
}

運行以上程式碼，輸出的JSON字串為：

{"basic":10000,"bonus":5000}

在這裡，我們實作了一個自訂的MarshalJSON方法，在Marsha時，只有當Bonus欄位不為0時，才輸出其值；而在為0時，則不輸出該欄位。

四、自訂JSON格式化

在Go語言中，也可以透過實作MarshalText和UnmarshalText方法來自訂JSON格式化。 MarshalText方法用於將一個結構體或類型轉換為[]byte格式的文本，而UnmarshalText則能夠將[]byte格式的文本轉換為對應的結構體或類型。

以日期為例，自訂一個JSON格式化函數，輸出類似「2022-09-21」的格式。

type Date struct {
    time.Time
}

func (d Date) MarshalText() ([]byte, error) {
    return []byte(d.Time.Format("2006-01-02")), nil
}

func (d *Date) UnmarshalText(text []byte) error {
    parse, err := time.Parse("2006-01-02", string(text))
    if err != nil {
        return err
    }
    d.Time = parse
    return nil
}

func main() {
    date := Date{time.Now()}
    jsonStr, err := json.Marshal(date)
    if err != nil {
        panic(err)
    }
    fmt.Println(string(jsonStr))

    var newDate Date
    err = json.Unmarshal([]byte(""2022-09-21""), &newDate)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(newDate.Time)
}

運行以上程式碼，輸出的JSON字串為：

"2022-09-21"
2022-09-21 00:00:00 +0000 UTC

從上述範例可以看出，在自訂JSON序列化和反序列化時，需要了解JSON序列化的原理和標準庫的實現，將其靈活運用於實際開發中。同時，我們也可以為自己的物件定義一個符合要求的JSON格式化方式，為更好地滿足不同場景下的資料傳輸需求提供了基礎工具和支援。

以上是如何在Go中使用自訂JSON序列化？的詳細內容。更多資訊請關注PHP中文網其他相關文章！