细说Golang的JSON解析

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

解析简单JSON

package main

import (
	"fmt"
	"encoding/json"
	"time"
	
)

func main() {
    type FruitBasket struct {
        Name    string 
        Fruit   []string
        Id      int64 `json:"ref"`// 声明对应的json key
        Created time.Time
    }

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

    var basket FruitBasket
    err := 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: play.golang.org/p/mcB6Kb6zC…

解析内嵌对象的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   Fruit
    Id      int64 `json:"ref"`// 声明对应的json key
    Created time.Time
}
复制代码

Playground url: play.golang.org/p/dqw6tLb4J…

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

若是上面JSON对象里的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   []Fruit
    Id      int64 `json:"ref"`// 声明对应的json key
    Created 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]Fruit
    Id      int64 `json:"ref"`// 声明对应的json key
    Created time.Time
}
复制代码

示例代码

package main

import (
	"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]Fruit
        Id      int64 `json:"ref"`// 声明对应的json key
        Created 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 FruitBasket
    err := json.Unmarshal(jsonData, &basket)
    if err != nil {
         fmt.Println(err)
    }
    for _, item := range basket.Fruit {
	fmt.Println(item.Name, item.PriceTag)
    }
}
复制代码

Playground url: play.golang.org/p/fh8JKa6pK…

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

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

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

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。