Encode
將一個(gè)對象編碼成JSON數(shù)據(jù),接受一個(gè)interface{}對象而账,返回[]byte和error:
func Marshal(v interface{}) ([]byte, error)
Marshal函數(shù)將會(huì)遞歸遍歷整個(gè)對象的烁,依次按成員類型對這個(gè)對象進(jìn)行編碼绎橘,類型轉(zhuǎn)換規(guī)則如下:
bool類型 轉(zhuǎn)換為JSON的Boolean
整數(shù),浮點(diǎn)數(shù)等數(shù)值類型 轉(zhuǎn)換為JSON的Number
string 轉(zhuǎn)換為JSON的字符串(帶""引號)
struct 轉(zhuǎn)換為JSON的Object骑脱,再根據(jù)各個(gè)成員的類型遞歸打包
數(shù)組或切片 轉(zhuǎn)換為JSON的Array
[]byte 會(huì)先進(jìn)行base64編碼然后轉(zhuǎn)換為JSON字符串
map 轉(zhuǎn)換為JSON的Object菜枷,key必須是string
interface{} 按照內(nèi)部的實(shí)際類型進(jìn)行轉(zhuǎn)換
nil 轉(zhuǎn)為JSON的null
channel,func等類型 會(huì)返回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"]}
將JSON數(shù)據(jù)解碼
func Unmarshal(data []byte, v interface{}) error
類型轉(zhuǎn)換規(guī)則和上面的規(guī)則類似
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}]
結(jié)構(gòu)體必須是大寫字母開頭的成員才會(huì)被JSON處理到,小寫字母開頭的成員不會(huì)有影響叁丧。
Mashal時(shí)啤誊,結(jié)構(gòu)體的成員變量名將會(huì)直接作為JSON Object的key打包成JSON;Unmashal時(shí)拥娄,會(huì)自動(dòng)匹配對應(yīng)的變量名進(jìn)行賦值蚊锹,大小寫不敏感。
Unmarshal時(shí)稚瘾,如果JSON中有多余的字段牡昆,會(huì)被直接拋棄掉;如果JSON缺少某個(gè)字段摊欠,則直接忽略不對結(jié)構(gòu)體中變量賦值丢烘,不會(huì)報(bào)錯(cuò)。
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}
如果希望手動(dòng)配置結(jié)構(gòu)體的成員和JSON字段的對應(yīng)關(guān)系些椒,可以在定義結(jié)構(gòu)體的時(shí)候給成員打標(biāo)簽:
使用omitempty熟悉播瞳,如果該字段為nil或0值(數(shù)字0,字符串"",空數(shù)組[]等),則打包的JSON結(jié)果不會(huì)有這個(gè)字段免糕。
type Message struct {
Name string `json:"msg_name"` ? ? ? // 對應(yīng)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.RawMessage其實(shí)就是[]byte類型的重定義赢乓∮遣啵可以進(jìn)行強(qiáng)制類型轉(zhuǎn)換。
現(xiàn)在有這么一種場景骏全,結(jié)構(gòu)體中的其中一個(gè)字段的格式是未知的:
type Command struct {
ID? int
Cmd? string
Args *json.RawMessage
}
使用json.RawMessage的話苍柏,Args字段在Unmarshal時(shí)不會(huì)被解析,直接將字節(jié)數(shù)據(jù)賦值給Args姜贡。我們可以能先解包第一層的JSON數(shù)據(jù)试吁,然后根據(jù)Cmd的值,再確定Args的具體類型進(jìn)行第二次Unmarshal楼咳。
這里要注意的是熄捍,一定要使用指針類型*json.RawMessage,否則在Args會(huì)被認(rèn)為是[]byte類型母怜,在打包時(shí)會(huì)被打包成base64編碼的字符串余耽。
interface{}類型在Unmarshal時(shí),會(huì)自動(dòng)將JSON轉(zhuǎn)換為對應(yīng)的數(shù)據(jù)類型:
JSON的boolean 轉(zhuǎn)換為bool
JSON的數(shù)值 轉(zhuǎn)換為float64
JSON的字符串 轉(zhuǎn)換為string
JSON的Array 轉(zhuǎn)換為[]interface{}
JSON的Object 轉(zhuǎn)換為map[string]interface{}
JSON的null 轉(zhuǎn)換為nil
需要注意的有兩個(gè)苹熏。一個(gè)是所有的JSON數(shù)值自動(dòng)轉(zhuǎn)換為float64類型碟贾,使用時(shí)需要再手動(dòng)轉(zhuǎn)換為需要的int,int64等類型轨域。第二個(gè)是JSON的object自動(dòng)轉(zhuǎn)換為map[string]interface{}類型袱耽,訪問時(shí)直接用JSON Object的字段名作為key進(jìn)行訪問。再不知道JSON數(shù)據(jù)的格式時(shí)干发,可以使用interface{}朱巨。
如果希望自己定義對象的打包解包方式,可以實(shí)現(xiàn)以下的接口:
type Marshaler interface {
? ? MarshalJSON() ([]byte, error)
}
type Unmarshaler interface {
? ? UnmarshalJSON([]byte) error
}
實(shí)現(xiàn)該接口的對象需要將自己的數(shù)據(jù)打包和解包枉长。如果實(shí)現(xiàn)了該接口冀续,json在打包解包時(shí)則會(huì)調(diào)用自定義的方法,不再對該對象進(jìn)行其他處理必峰。
---------------------本文來自 tiaotiaoyly 的CSDN 博客 洪唐,全文地址請點(diǎn)擊:https://blog.csdn.net/tiaotiaoyly/article/details/38942311?utm_source=copy