当静态编程语言使用到 JSON 的时候,总是会有些费力。一方面,JSON 数据可能是任何形式的,从一个简单的数字,到一个复杂的包含内嵌对象的数组。当使用 Go 语言的时候,这意味着你要将这些变化多端的 JSON 数据放入结构化的变量中去。
幸运地是,Go 尽力尝试帮我们降低编码难度,为我们提供了许多方式来解析 JSON 数据。
Go 标准库的 json 包为我们提供了我们想要的功能。对于任意的 JSON 字符串,标准的解析方法如下:
import "encoding/json"
//...
// ...
myJsonString := `{"some":"json"}`
// `&myStoredVariable` is the address of the variable we want to store our
// parsed data in
json.Unmarshall([]byte(myJsonString), &myStoredVariable)
//...
本文中我们要讨论的是,对于 myStoredVariable
变量的类型,你可以有哪些不同的选择,以及决定何时采用何种类型。
在处理 JSON 数据时,你会遇到两种情况:
我们先从结构化数据开始,因为它们处理起来相对容易一些。对于这类数据我们需要提前知晓其结构。比如,你有一个 Bird
对象,每种鸟都有 species
字段和一个 description
字段:
{
"species": "pigeon",
"decription": "likes to perch on rocks"
}
读取此类数据,只要创建一个 struct
结构体,作为你想要解析的数据的镜像。对于这个例子,我们会创建一个包含 Species
和 Description
字段的 Bird
结构体:
type Bird struct {
Species string
Description string
}
然后将数据解析出来,如下:
birdJson := `{"species": "pigeon","description": "likes to perch on rocks"}`
var bird Bird
json.Unmarshal([]byte(birdJson), &bird)
fmt.Printf("Species: %s, Description: %s", bird.Species, bird.Description)
//Species: pigeon, Description: likes to perch on rocks
转换时,Go 不区分名称大小写问题,使用 JSON 属性与字段都转为小写后相同作为映射依据。所以,
Bird
结构的Species
字段会映射到名为species
,或者Species
或者sPeCiEs
的 JSON 属性。
当遇到一个 Bird
数组的时候,又会发生什么呢?
[
{
"species": "pigeon",
"decription": "likes to perch on rocks"
},
{
"species":"eagle",
"description":"bird of prey"
}
]
既然这个数组的每个元素都是一个 Bird
,你可以创建一个 Bird
类型的数组来解析它:
birdJson := `[{"species":"pigeon","decription":"likes to perch on rocks"},{"species":"eagle","description":"bird of prey"}]`
var birds []Bird
json.Unmarshal([]byte(birdJson), &birds)
fmt.Printf("Birds : %+v", birds)
//Birds : [{Species:pigeon Description:} {Species:eagle Description:bird of prey}]
现在,考虑这种情况,Bird
有一个 Dimensions
属性,用来描述它的 Height
(高度)和 Length
(身长):
{
"species": "pigeon",
"decription": "likes to perch on rocks",
"dimensions": {
"height": 24,
"width": 10
}
}
和上一个例子类似,我们需要将这个新的问题对象映射到我们的 Go 代码中。在机构体中加入一个内嵌的 dimensions
字段,让我们先申明一个 dimensions
的结构体类型:
type Dimensions struct {
Height int
Width int
}
然后,Bird
结构体可以包含一个 Dimensions
字段:
type Bird struct {
Species string
Description string
Dimensions Dimensions
}
如此就能用与之前一样的方法进行数据解析了:
birdJson := `{"species":"pigeon","description":"likes to perch on rocks", "dimensions":{"height":24,"width":10}}`
var birds Bird
json.Unmarshal([]byte(birdJson), &birds)
fmt.Printf(bird)
// {pigeon likes to perch on rocks {24 10}}
前面提到过 Go 会进行大小写转换来确定结构体字段和 JSON 属性的映射关系。不过很多时候,你会需要一个和 JSON 数据属性不同名的字段名称。
{
"birdType": "pigeon",
"what it does": "likes to perch on rocks"
}
对于上面的 JSON 数据,我想让 birdType
属性映射到 Go 代码中的 Species
字段。同时我也没法给 "what it does"
提供一个合适的字段名称。
为了解决这些情况,我们可以使用结构体字段标签:
type Bird struct {
Species string `json:"birdType"`
Description string `json:"what it does"`
}
现在,我们可以明确地告诉代码,某个 JSON 属性应该映射到哪个字段上了。
birdJson := `{"birdType": "pigeon","what it does": "likes to perch on rocks"}`
var bird Bird
json.Unmarshal([]byte(birdJson), &bird)
fmt.Println(bird)
// {pigeon likes to perch on rocks}
如果你遇到一些数据,它们的结构和属性名都不确定,那么你就无法使用结构体来解析这些数据了。取而代之地,你可以使用映射( maps )类型。考虑以下的 JSON 形式:
{
"birds": {
"pigeon":"likes to perch on rocks",
"eagle":"bird of prey"
},
"animals": "none"
}
我们没法构建一个结构体来描述上面的数据,因为鸟儿的名字作为对象的键值总是可以变换,而这会导致数据结构的变化。
为了处理这种情况,我们创建一个字符串对应空接口的 map:
birdJson := `{"birds":{"pigeon":"likes to perch on rocks","eagle":"bird of prey"},"animals":"none"}`
var result map[string]interface{}
json.Unmarshal([]byte(birdJson), &result)
// The object stored in the "birds" key is also stored as
// a map[string]interface{} type, and its type is asserted from
// the interface{} type
birds := result["birds"].(map[string]interface{})
for key, value := range birds {
// Each value is an interface{} type, that is type asserted as a string
fmt.Println(key, value.(string))
}
每个字符串对应一个 JSON 属性的名称, interface{}
类型对应它的值,这个值可以是任意类型。在代码中,其数据类型通过对 interface{}
进行断言就可以获取到。而且这些映射解析动作可以迭代执行,如此一来,可变数量的键通过一次循环中就能够处理完成。
通常情况下,只要你能够使用结构体来描述你的 JSON 数据,你就应该使用它们。只有当遇到数据中有不确定的键或值时,无法使用结构体进行描述,才是你使用映射( map )的唯一理由。
1
lxml 2019-02-18 04:01:15 +08:00 via Android
我记得原文中好像还有默认数字类型是 float64 之类的
|
2
zarte 2019-02-18 10:40:09 +08:00
数字 float64 的,如果原值是整数可以 int ( xxx.(float64))这样转成可用的。
|