Go?結構體序列化的實現(xiàn)
本文，我們將回到之前寫的showMovieHandler方法，并更新它以返回一個JSON響應，表示系統(tǒng)中的單個電影信息。類似于:
{
? ? "id": 123,
? ? "title": "Casablanca",?
? ? "runtime": 102,?
? ? "genres": [
? ? ? ? "drama",?
? ? ? ? "romance",?
? ? ? ? "war"
? ? ],
? ? "version": 1?
}我們不使用map序列化來創(chuàng)建這個JSON對象(就像我們在上一節(jié)中所做的那樣)，這次我們將編碼一個自定義的Movie結構體。
首先，需要定義一個Movie結構體。我們將在一個新internal/data包中完成此操作，該包稍后將擴展用來封裝項目中所有自定義數(shù)據(jù)類型以及與數(shù)據(jù)庫交互的邏輯。
如果您按照文章步驟操作，請創(chuàng)建一個新的internal/data目錄，其中包含一個movies.go文件:
$ mkdir internal/data $ touch internal/data/movies.go
在這個新文件中，定義Movie結構，像這樣:
File: internal/data/movies.go
package main
import (
? ? "time"
)
type Movie struct {
? ? ID ? ? ? ? ? ? int64 ? ? ?//唯一整數(shù)ID
? ? CreatedAt ? ? ?time.Time ?//創(chuàng)建電影到數(shù)據(jù)庫的時間
? ? Title ? ? ? ? ?string ? ? //電影標題
? ? Year ? ? ? ? ? int32 ? ? ?//電影發(fā)布年份
? ? Runtime ? ? ? ?int32 ? ? ?//電影時長
? ? Genres ? ? ? ? []string ? //電影類型(愛情片、喜劇片等)
? ? Version ? ? ? ?int32 ? ? ?//版本號從1開始，每更新一次遞增
}這里需要指出的是，Movie結構體中的所有字段都是可導出的(即以大寫字母開頭)，這對于Go的encoding/json包可見是必要的。在將結構體編碼為JSON時，不會包含任何未導出的字段。
現(xiàn)在結構體已經定義完成，讓我們更新showMovieHandler處理程序來初始化一個Movie結構體實例，然后使用writeJSON()幫助函數(shù)將其作為JSON響應發(fā)送給客戶端。
實現(xiàn)很簡單：
File： cmd/api/movies.go
package main
import (
"fmt"
"net/http"
"time"
"greenlight.alexedwards.net/internal/data"
)
func (app *application) showMovieHandler(w http.ResponseWriter, r *http.Request) {
id, err := app.readIDParam(r)
if err != nil {
http.NotFound(w, r)
return
}
//創(chuàng)建一個Move結構體實例，包含從請求URL中解析的ID虛構的數(shù)據(jù)。注意這里故意沒有設置Year字段
movie := date.Movie{
ID: id,
CreateAt: time.now(),
Title: "Casablanca",
Runtime: 102,
Genres: []string{"drama", "romance", "war"},
Version: 1,
}
//將結構體序列化為JSON并以HTTP響應發(fā)送給客戶端
err = app.writeJSON(w, http.StatusOK, movie, nil)
if err != nil {
app.logger.Println(err)
http.Error(w, "The server encountered a problem and could not process your request", http.StatusInternalServerError)
}
}ok，下面試試！
重啟API，然后在瀏覽器中訪問localhost:4000/v1/movies/123。你應該會看到一個類似這樣的JSON響應:
在這個返回結果中，有幾件有趣的事情需要指出:
- Movie結構體被編碼成一個JSON對象，字段名和值作為鍵/值對。
- 默認情況下，JSON對象中的鍵等于結構體中的字段名(ID、CreatedAt、Title等等)。我們稍后將討論如何自定義JSON鍵。
- 如果結構體實例字段沒有顯式賦值，那么字段零值將序列化為json值。可以在上面的響應中看到——我們沒有在Go代碼中為Year字段設置值，但它仍然以0值出現(xiàn)在JSON輸出中。
更改JSON對象中的鍵
在Go中序列化結構體的一個好處是，您可以通過使用struct標簽注釋字段來定制JSON。
struct標簽最常見的用途可能是更改JSON對象中出現(xiàn)的鍵名稱。當你的結構體字段名不適合面向公眾展示，或者你想在JSON輸出中使用另一種大小寫樣式時，這是很有用的。
為了說明如何實現(xiàn)，對Movies結構體字段打標簽，使用蛇形格式：
File: internal/data/movies.go
//使用標記對Movie結構進行注釋，以控制json編碼的key顯示方式。
type Movie struct {
? ? ID ? ? ? int64 ? ? `json:"id"`
? ? CreateAt time.Time `json:"created_at"`
? ? Title ? ?string ? ?`json:"title"`
? ? Year ? ? int32 ? ? `json:"year"`
? ? Runtime ?int32 ? ? `json:"runtime"`
? ? Genres ? []string ?`json:"genres"`
? ? Version ?int32 ? ? `json:"version"`
}如果你重啟服務器并再次訪問localhost:4000/v1/movies/123，應該會看到一個類似于這樣的帶有蛇形鍵的響應:
在JSON對象中隱藏結構體字段
在定義結構體時候，通過使用omitempty可以控制對應字段在JSON中的可見性。當您不希望JSON輸出中出現(xiàn)特定的結構體字段時，可以使用-(連字符)指令。這對包含和用戶不相關的內部系統(tǒng)信息的字段或不想公開的敏感信息(如密碼哈希值)非常有用。
相反，當且僅當struct字段值為空時，omitempty指令會在JSON輸出中隱藏字段，其中empty被定義為:
- 等于false，0或“”
- 空數(shù)組，切片或map
- nil指針或接口值為nil
為了演示如何使用這些指令，我們對Movie結構進行更多的改造。CreatedAt字段與我們的最終用戶無關，所以我們使用-指令在輸出中將其隱藏。我們還將使用omitempty指令在輸出中隱藏Year、Runtime和types字段，當且僅當它們?yōu)榭諘r生效。
繼續(xù)并像下面這樣更新struct標簽:
File：interface/data/movies.go
package data
....
type Movie struct {
? ? ID ? ? ? int64 ? ? `json:"id"`
? ? CreateAt time.Time `json:"-"` ? ? ? //使用-指令
? ? Title ? ?string ? ?`json:"title"`
? ? Year ? ? int32 ? ? `json:"year,omitempty"` ? ? ? ? ? ?//添加omitempty
? ? Runtime ?int32 ? ? `json:"runtime,omitempty"` ? ? ? ? //添加omitempty
? ? Genres ? []string ?`json:"genres,omitempty"` ? ? ? ? ?//添加omitempty
? ? Version ?int32 ? ? `json:"version"`
}如果你想使用omitempty而不改變鍵名，那么你可以在struct標簽中保留它為空-如:json:"，omitempty"。注意，逗號是必要的。
現(xiàn)在，當你重新啟動應用程序并刷新你的web瀏覽器時，你應該會看到如下響應:
我們可以在這里看到，CreatedAt結構字段不再出現(xiàn)在JSON中，而且Year字段(值為0)也沒有出現(xiàn)，這要感謝omitempty指令。其他字段使用了omitempty不受影響(例如Runtime和Genres)。
注意:您還可以通過簡單地將結構體字段設置為不可導出來防止它出現(xiàn)在JSON序列化中。但使用json:“-“標記通常是一個更好的選擇：明確告知閱讀代碼的人，你不希望該字段包含在json。
舊版本的go vet如果你試圖在未導出的字段上使用struct標記會引發(fā)錯誤，但現(xiàn)在在go 1.16中已經修復了這個問題。
附加內容
結構體標簽string指令
最后一個不太常用的struct標記指令是string?？梢允褂眠@個標簽明確表示字段值序列化成JSON字符串類型。例如，如果我們希望Runtime字段的值表示為一個JSON字符串 (而不是數(shù)字)我們可以像這樣使用string指令:
type Movie struct {
? ? ID ? ? ? int64 ? ? `json:"id"`
? ? CreateAt time.Time `json:"-"` ? ? ? //使用-指令
? ? Title ? ?string ? ?`json:"title"`
? ? Year ? ? int32 ? ? `json:"year,omitempty"` ??
? ? Runtime ?Runtime ? `json:"runtime,omitempty,string"`?
? ? Genres ? []string ?`json:"genres,omitempty"` ? ? ??
? ? Version ?int32 ? ? `json:"version"`
}JSON序列化結果如下所示:
{
"id": 123,
"title": "Casablanca",
"runtime": "102", ? //這是字符串
"genres": [
? ? "drama",?
? ? "romance",?
? ? "war"
? ? ],
"version": 1?
}注意string指令只對int， uint， float*或bool類型的字段有效。對于任何其他類型的結構體字段沒有作用。
到此這篇關于Go 結構體序列化的實現(xiàn)的文章就介紹到這了,更多相關Go 結構體序列化內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
這篇文章主要為大家介紹了go語言context包功能及操作使用詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步早日升職加薪2022-04-04
這篇文章主要介紹了go語言的四數(shù)相加等于指定數(shù)算法的操作，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2021-04-04
深入理解Go gin框架中Context的Request和Writer對象
這篇文章主要為大家詳細介紹了Go語言的gin框架中Context的Request和Writer對象，文中的示例代碼講解詳細，對我們深入了解Go語言有一定的幫助，快跟隨小編一起學習一下吧2023-04-04
Golang科學計數(shù)法轉換string數(shù)字輸出的實現(xiàn)
最近接手一個商城運單號模塊，接手后發(fā)現(xiàn)有部分運單號返回給前端是按照科學計數(shù)法的方式返回，本文就介紹一下Golang科學計數(shù)法轉換string數(shù)字輸出，感興趣的可以了解一下2021-07-07
這篇文章主要介紹了Go語言中普通函數(shù)與方法的區(qū)別,以實例形式對比分析了普通函數(shù)與方法使用時的區(qū)別與相關技巧,需要的朋友可以參考下2015-02-02
這篇文章主要介紹了GoLang函數(shù)棧的使用，我們的代碼會被編譯成機器指令并寫入到可執(zhí)行文件，當程序執(zhí)行時，可執(zhí)行文件被加載到內存，這些機器指令會被存儲到虛擬地址空間中的代碼段，在代碼段內部，指令是低地址向高地址堆積的2023-02-02
Golang 中的可測試示例函數(shù)(Example Function)詳解
這篇文章詳細講解了 Golang 中的可測試示例函數(shù)，示例函數(shù)類似于單元測試函數(shù)，但沒有 *testing 類型的參數(shù)，編寫示例函數(shù)也是很容易的，本文就通過代碼示例給大家介紹一下Golang的可測試示例函數(shù),需要的朋友可以參考下2023-07-07
這篇文章主要介紹了Go語言中的Slice學習總結,本文講解了Slice的定義、Slice的長度和容量、Slice是引用類型、Slice引用傳遞發(fā)生“意外”等內容,需要的朋友可以參考下2014-11-11
我們時常有比較兩個值是否相等的需求,下面這篇文章主要給大家介紹了關于GO比較兩個對象是否相同的相關資料,文中通過實例代碼介紹的非常詳細,需要的朋友可以參考下2022-12-12
這篇文章主要為大家詳細介紹了使用Go語言實現(xiàn)找出兩個大文件中相同的記錄的相關知識,文中的示例代碼講解詳細,感興趣的小伙伴可以跟隨小編一起學習一下2024-10-10