Go 的 Json方法

253 阅读3分钟

Marshal

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

Decode

func Unmarshal(data []byte, v interface{}) error

Decode函数将会递归遍历整个对象,依次按成员类型对这个对象进行编码,类型转换规则如下:

  • 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

Struct

结构体必须是大写字母开头的成员才会被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: "Anna", 
 Body: "Hello", 
 Time: 1294706395881547000, 
 inner: "ok", 
} 
b := []byte(`{"nAmE":"Bob","Foods":"Pickle", "inner":"no"}`) 
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结果不会有这个字段。

使用标签"-"代表忽略该字段

json.RawMessage

json.RawMessage其实就是[]byte类型的重定义。可以进行强制类型转换

type Command struct{
    Id string
    Cmd string
    Args *json.RawMessage    
    Fileld interface{}
}

args 字段无法在UnMarshal无法解析,一般直接使用字节数据赋值

Tips:一定要使用指针类型*json.RawMessage,否则在Args会被认为是[]byte类型,在打包时会被打包成base64编码的字符串。

interface{}

interface{}类型在Unmarshal时,会自动将JSON转换为对应的数据类型:

JSONboolean 转换为bool
JSON的数值 转换为float64   //转化为float 在转化为int int64 int32 
JSON的字符串 转换为string
JSONArray 转换为[]interface{}  
JSONObject 转换为map[string]interface{} // tips:object 是map
JSONnull 转换为nil

Custom Type

自定义对象的打包方式 需要实现以下接口

type Marshaler interface { 
 MarshalJSON() ([]byte, error) 
} 
type Unmarshaler interface { 
 UnmarshalJSON([]byte) error 
}

将自己的数据打包和解包。如果实现了该接口,json在打包解包时则会调用自定义的方法,不再对该对象进行其他处理。