细说Golang的JSON解析

之前一直写一些动态语言，觉得解析JOSN还是很简单的，往往只需要几行代码就能拿到解析好的JSON对象。Go语言自带的json包可以让你在程序中方便的读取和写入 JSON 数据。生成JSON场景相对简单一些，json.Marshal()会根据传入的结构体生成JSON数据。解析JSON会把数据解析到结构体中，由于JSON格式的自由组合的特点，尤其是那些结构复杂的JSON数据对新手来说声明接受JSON数据的结构体类型就会陷入不知从何下手的困扰。最近工作中由于要解析JS和PHP程序持久化的JSON数据，大概花了两个下午才搞清楚针对常见的JSON数据应该如何声明结构体类型，下面分别说明一下。

解析简单JSON

package mainimport ("fmt""encoding/json""time")func main() {type FruitBasket struct {Name    string Fruit   []stringId      int64 `json:"ref"`// 声明对应的json keyCreated time.Time}jsonData := []byte(`{"Name": "Standard","Fruit": ["Apple","Banana","Orange"],"ref": 999,"Created": "2018-04-09T23:00:00Z"}`)var basket FruitBasketerr := json.Unmarshal(jsonData, &basket)if err != nil {fmt.Println(err)}fmt.Println(basket.Name, basket.Fruit, basket.Id)fmt.Println(basket.Created)
}

说明：由于json.UnMarshal()方法接收的是字节切片，所以首先需要把JSON字符串转换成字节切片c := []byte(s)
Playground url: https://play.golang.org/p/mcB...

解析内嵌对象的JSON

把上面的Fruit值如果改成字典 "Fruit" : {"Name", "Apple", "PriceTag": "$1"}, 变成：

    jsonData := []byte(`{"Name": "Standard","Fruit" : {"Name": "Apple", "PriceTag": "$1"},"ref": 999,"Created": "2018-04-09T23:00:00Z"}`)

那么结构体类型应该这么声明

type Fruit struct {Name string `json":Name"`PriceTag string `json:"PriceTag"`
}type FruitBasket struct {Name    string Fruit   FruitId      int64 `json:"ref"`// 声明对应的json keyCreated time.Time
}

Playground url: https://play.golang.org/p/dqw...

解析内嵌对象数组的JSON(Embed Array of Object)

如果上面JOSN对象里的Fruit值现在变成了

"Fruit" : [{"Name": "Apple","PriceTag": "$1"},{"Name": "Pear","PriceTag": "$1.5"}
]

这种情况也简单把解析JSON的结构体做如下更改，把Fruit字段类型换为 []Fruit即可

type Fruit struct {Name string `json:"Name"`PriceTag string `json:"PriceTag"`
}type FruitBasket struct {Name    string Fruit   []FruitId      int64 `json:"ref"`// 声明对应的json keyCreated time.Time
}

解析具有动态Key的对象（Parse a JSON object with dynamic key)

下面再做一下复杂的变通，如果把上面的对象数组变为Key为水果ID的对象（object of object）比如

"Fruit" : {"1": {"Name": "Apple","PriceTag": "$1"},"2": {"Name": "Pear","PriceTag": "$1.5"}
}

每个Key的名字在声明结构体的时候是不知道值的，这样该怎么声明呢，答案是把Fruit字段的类型声明为一个key为string类型值为Fruit类型的map

type Fruit struct {Name string `json:"Name"`PriceTag string `json:"PriceTag"`
}type FruitBasket struct {Name    string Fruit   map[string]FruitId      int64 `json:"ref"`// 声明对应的json keyCreated time.Time
}

示例代码

package mainimport ("fmt""encoding/json""time")func main() {type Fruit struct {Name string `json:"Name"`PriceTag string `json:"PriceTag"`}type FruitBasket struct {Name    string Fruit   map[string]FruitId      int64 `json:"ref"`// 声明对应的json keyCreated time.Time}    jsonData := []byte(`{"Name": "Standard","Fruit" : {"1": {"Name": "Apple","PriceTag": "$1"},"2": {"Name": "Pear","PriceTag": "$1.5"}},"ref": 999,"Created": "2018-04-09T23:00:00Z"}`)var basket FruitBasketerr := json.Unmarshal(jsonData, &basket)if err != nil {fmt.Println(err)}for _, item := range basket.Fruit {fmt.Println(item.Name, item.PriceTag)}
}

Playground url: https://play.golang.org/p/fh8...

解析包含任意层级的数组和对象的JSON数据(arbitrary arrays and objects)

针对包含任意层级的JOSN数据，声明结构体类型比较困难，encode\json包还提供另外一种方法来解析JSON数据。
encoding\json包使用：

map[string]interface{} 存储JOSN对象
[]interface 存储JOSN数组

json.Unmarshl 将会把任何合法的JSON数据存储到一个interface{}类型的值，通过使用空接口类型我们可以存储任意值，但是使用这种类型作为值时需要先做一次类型断言。

示例代码:

jsonData := []byte(`{"Name":"Eve","Age":6,"Parents":["Alice","Bob"]}`)var v interface{}
json.Unmarshal(jsonData, &v)
data := v.(map[string]interface{})for k, v := range data {switch v := v.(type) {case string:fmt.Println(k, v, "(string)")case float64:fmt.Println(k, v, "(float64)")case []interface{}:fmt.Println(k, "(array):")for i, u := range v {fmt.Println("    ", i, u)}default:fmt.Println(k, v, "(unknown)")}
}

虽然将JSON数据存储到空接口类型的值中可以用来解析任意结构的JSON数据，但是在实际应用中发现还是有不可控的地方，比如将数字字符串的值转换成了float类型的值，所以经常会在运行时报类型断言的错误，所以在JSON结构确定的情况下还是优先使用结构体类型声明，将JSON数据到结构体中的方式来解析JSON。