常常能见到如下的这样结构体成员后边带有json的标签:
type Model struct {
ID int `gorm:"primary_key" json:"id"`
Del int `json:"del"` //是否删除
CreatedOn time.Time `json:"-"`
ModifiedOn time.Time `json:"-"`
DeletedAt *time.Time `json:"deleted_at,omitempty"`
}
在后端开发中,我们常需要将结构体转化成json格式的数据,要想把struct转化成json,只要把结构体内的字段名设置成导出状态,也就是把首字母大写(不然不能被外部访问),默认情况下,转化后的json中的key值和结构体中的字段名是一样的,如果我们期望转化后的json字段名和struct里的不一样的话,就得用到tag。tag在这里的用途就是提供json结构中的别名,让两者的转化更加灵活。
针对JSON的输出,我们在定义struct tag的时候需要注意的几点是:
- 1.首字母为小写时,为private字段,不会转换;
- 2.tag中带有自定义名称,那么这个自定义名称会出现在JSON的字段名中;
- 3.字段的tag是
"-"
,那么这个字段不会输出到JSON; - 4.tag中如果带有
"omitempty"
选项,那么如果该字段值为空,就不会输出到JSON串中,比如 false、0、nil、长度为 0 的 array,map,slice,string; - 5.如果字段类型是
bool, string, int, int64
等,而tag中带有",string"
选项,那么这个字段在输出到JSON的时候会把该字段对应的值转换成JSON字符串.
结构体与JSON之间的互相转化:json.Marshal和json.Unmarshal
函数.
data, err := json.Marshal(result) //将结构体转化成json字符串,注意是返回两个值。
if err == nil {
utils.Debugf("Marshal data len = %d", len(data))
return string(data)
} else {
utils.Debugf("Marshal err , err = %s", err.Error())
return ""
}
data = []byte(`{"Name":"gopher","IsAdmin":false,"Followers":8900}`)
var newUser = new(User)
err = json.Unmarshal(data, &newUser)//将json字符串转化成结构体类型,此处需要注意json是字符串类型。
if err != nil {
fmt.Errorf("Can not decode data: %v\n", err)
}
fmt.Printf("%v\n", newUser)