在 Go 語言中,這樣使用 Json 的
Encode
將一個對象編碼成JSON
數據,接受一個interface{}
對象,返回[]byte
和error
:
func Marshal(v interface{}) ([]byte, error)
Marshal
函數將會遞歸遍歷整個對象,依次按成員類型對這個對象進行編碼,類型轉換規則如下:
-
bool
類型 轉換爲JSON
的Boolean
-
整數,浮點數等數值類型 轉換爲
JSON
的Number
-
string
轉換爲JSON
的字符串 (帶 "" 引號) -
struct
轉換爲JSON
的Object
,再根據各個成員的類型遞歸打包 -
數組或切片 轉換爲
JSON
的Array
-
[]byte
會先進行base64
編碼然後轉換爲JSON
字符串 -
map
轉換爲JSON
的Object
,key
必須是string
-
interface{}
按照內部的實際類型進行轉換 -
nil
轉爲JSON
的null
-
channel
,func
等類型 會返回UnsupportedTypeError
type ColorGroup struct {
ID int
Name string
Colors []string
}
group := ColorGroup{
ID: 1,
Name: "Reds",
Colors: []string{"Crimson", "Red", "Ruby", "Maroon"},
}
b, err := json.Marshal(group)
if err != nil {
fmt.Println("error:", err)
}
os.Stdout.Write(b)
Output:
{"ID":1,"Name":"Reds","Colors":["Crimson","Red","Ruby","Maroon"]}
Decode
將JSON
數據解碼
func Unmarshal(data []byte, v interface{}) error
類型轉換規則和上面的規則類似
var jsonBlob = []byte(`[
{"Name": "Platypus", "Order": "Monotremata"},
{"Name": "Quoll", "Order": "Dasyuromorphia"}
]`)
type Animal struct {
Name string
Order string
}
var animals []Animal
err := json.Unmarshal(jsonBlob, &animals)
if err != nil {
fmt.Println("error:", err)
}
fmt.Printf("%+v", animals)
Output:
[{Name:Platypus Order:Monotremata} {Name:Quoll Order:Dasyuromorphia}]
結構體
結構體必須是大寫字母開頭的成員纔會被JSON
處理到,小寫字母開頭的成員不會有影響。
Mashal
時,結構體的成員變量名將會直接作爲JSON
Object
的key
打包成JSON
;Unmashal
時,會自動匹配對應的變量名進行賦值,大小寫不敏感。
Unmarshal
時,如果JSON
中有多餘的字段,會被直接拋棄掉;如果JSON
缺少某個字段,則直接忽略不對結構體中變量賦值,不會報錯。
type Message struct {
Name string
Body string
Time int64
inner string
}
var m = Message{
Name: "Alice",
Body: "Hello",
Time: 1294706395881547000,
inner: "ok",
}
b := []byte(`{"nAmE":"Bob","Food":"Pickle", "inner":"changed"}`)
err := json.Unmarshal(b, &m)
if err != nil {
fmt.Printf(err.Error())
return
}
fmt.Printf("%v", m)
Output:
{Bob Hello 1294706395881547000 ok}
StructTag
如果希望手動配置結構體的成員和JSON
字段的對應關係,可以在定義結構體的時候給成員打標籤:
使用omitempty
熟悉,如果該字段爲nil
或 0 值(數字 0, 字符串 "", 空數組 [] 等),則打包的JSON
結果不會有這個字段。
type Message struct {
Name string `json:"msg_name"` // 對應JSON的msg_name
Body string `json:"body,omitempty"` // 如果爲空置則忽略字段
Time int64 `json:"-"` // 直接忽略字段
}
var m = Message{
Name: "Alice",
Body: "",
Time: 1294706395881547000,
}
data, err := json.Marshal(m)
if err != nil {
fmt.Printf(err.Error())
return
}
fmt.Println(string(data))
Output:
{"msg_name":"Alice"}
更靈活地使用JSON
使用 json.RawMessage
json.RawMessage
其實就是[]byte
類型的重定義。可以進行強制類型轉換。
現在有這麼一種場景,結構體中的其中一個字段的格式是未知的:
type Command struct {
ID int
Cmd string
Args *json.RawMessage
}
使用json.RawMessage
的話,Args
字段在Unmarshal
時不會被解析,直接將字節數據賦值給Args
。我們可以能先解包第一層的JSON
數據,然後根據Cmd
的值,再確定Args
的具體類型進行第二次Unmarshal
。
這裏要注意的是,一定要使用指針類型*json.RawMessage
,否則在Args
會被認爲是[]byte
類型,在打包時會被打包成base64
編碼的字符串。
使用 interface{}
interface{}
類型在Unmarshal
時,會自動將JSON
轉換爲對應的數據類型:
JSON的boolean 轉換爲bool
JSON的數值 轉換爲float64
JSON的字符串 轉換爲string
JSON的Array 轉換爲[]interface{}
JSON的Object 轉換爲map[string]interface{}
JSON的null 轉換爲nil
需要注意的有兩個。一個是所有的JSON
數值自動轉換爲float64
類型,使用時需要再手動轉換爲需要的int
,int64
等類型。第二個是JSON
的object
自動轉換爲map[string]interface{}
類型,訪問時直接用JSON ``Object
的字段名作爲key
進行訪問。再不知道JSON
數據的格式時,可以使用interface{}
。
自定義類型
如果希望自己定義對象的打包解包方式,可以實現以下的接口:
type Marshaler interface {
MarshalJSON() ([]byte, error)
}
type Unmarshaler interface {
UnmarshalJSON([]byte) error
}
實現該接口的對象需要將自己的數據打包和解包。如果實現了該接口,json
在打包解包時則會調用自定義的方法,不再對該對象進行其他處理。
**文章首發:**https://www.jb51.net/article/134897.htm
本文由 Readfog 進行 AMP 轉碼,版權歸原作者所有。
來源:https://mp.weixin.qq.com/s/H0uuf86T5h87GsAesD96qQ