Go语言学习-结构体与json

有时在Go的结构体定义时会看到这样的形式：

type Result struct {
	ErrorCode string `json:"returnCode"`
	ErrorMsg  string `json:"returnMessage"`
}

注意上述红色部分，这就称之为struct tag 。个人理解struct tag的作用类似于Java的注解的作用，在Go语言中可以通过反射机制在运行时动态获取到struct的tag来实现一些特定功能。

要想把struct转化成json，只要把结构体内的字段名设置成导出状态，也就是把首字母大写就行了，默认情况下，转化后的json中的key值和结构体中的字段名是一样的，如果我们期望转化后的json字段名和struct里的不一样的话，就得用到tag了。tag在这里的用途就是提供别名，让两者的转化更加灵活。

针对JSON的输出，我们在定义struct tag的时候需要注意的几点是：

• 首字母为小写时，为private字段，不会转换

• tag中带有自定义名称，那么这个自定义名称会出现在JSON的字段名中

• 字段的tag是"-"，那么这个字段不会输出到JSON

• tag中如果带有"omitempty"选项，那么如果该字段值为空，就不会输出到JSON串中，比如 false、0、nil、长度为 0 的 array，map，slice，string

• 如果字段类型是bool, string, int, int64等，而tag中带有",string"选项，那么这个字段在输出到JSON的时候会把该字段对应的值转换成JSON字符串

struct 转 json

要把 Golang 的数据结构转换成 JSON 字符串（Encode），可以使用 Marshal 函数：

	data, err := json.Marshal(result)
	if err == nil {
		utils.Debugf("Marshal data len = %d", len(data))
		return string(data)
	} else {
		utils.Debugf("Marshal err , err = %s", err.Error())
		return ""
	}

json 转 struct

相对应的，要把 JSON 数据转换成 Go 类型的值（Decode）， 可以使用 json.Unmarshal。它的定义是这样的：

data = []byte(`{"Name":"gopher","IsAdmin":false,"Followers":8900}`)
var newUser = new(User)
err = json.Unmarshal(data, &newUser)
if err != nil {
	fmt.Errorf("Can not decode data: %v\n", err)
}
fmt.Printf("%v\n", newUser)

那么 Unmarshal 是怎么找到结构体中对应的值呢？比如给定一个 JSON key Filed，它是这样查找的：

• 首先查找 tag 名字为 Field 的字段

• 然后查找名字为 Field 的字段

• 最后再找名字为 Field 等大小写不敏感的匹配字段

• 如果都没有找到，就直接忽略这个 key，也不会报错。

这对于要从众多数据中只选择部分来使用非常方便。