[系列] Go 如何解析 JSON 数据？

概述

最近掉进需求坑了，刚爬上来，评估排期出现了严重问题，下面三张图很符合当时的心境。

谈需求

估排期

开始干

为啥会这样，我简单总结了下：

• 与第三方对接。
• 跨团队对接。
• 首次用 Go 做项目。
• 业务流程没屡清楚就出排期（大坑）。
• 需求调整后未进行调整排期（大坑）。

有了这次经验，后期关于如何评估排期也可以和大家唠唠。

废话不多说了，进入今天主题。

今天给大家分享用 Go 如何解析 JSON 数据，包含三种情况，强类型解析、弱类型解析、返回结构不确定 等。

JSON 结构

比如，请求了手机归属地的接口，json 数据返回如下：

{
    "resultcode": "200",
    "reason": "Return Successd!",
    "result": {
        "province": "浙江",
        "city": "杭州",
        "areacode": "0571",
        "zip": "310000",
        "company": "中国移动",
        "card": ""
    }
}

思路是这样的：

1.先将 json 转成 struct。

2.然后 json.Unmarshal() 即可。

json 转 struct ，自己手写就太麻烦了，有很多在线的工具可以直接用，我用的这个：

https://mholt.github.io/json-to-go/

在左边贴上 json 后面就生成 struct 了。

用代码实现下：

type MobileInfo struct {
    Resultcode string `json:"resultcode"`
    Reason     string `json:"reason"`
    Result     struct {
        Province string `json:"province"`
        City     string `json:"city"`
        Areacode string `json:"areacode"`
        Zip      string `json:"zip"`
        Company  string `json:"company"`
        Card     string `json:"card"`
    } `json:"result"`
}

func main() {
    jsonStr := `
        {
            "resultcode": "200",
            "reason": "Return Successd!",
            "result": {
                "province": "浙江",
                "city": "杭州",
                "areacode": "0571",
                "zip": "310000",
                "company": "中国移动",
                "card": ""
            }
        }
    `

    var mobile MobileInfo
    err := json.Unmarshal([]byte(jsonStr), &mobile)
    if err != nil {
        fmt.Println(err.Error())
    }
    fmt.Println(mobile.Resultcode)
    fmt.Println(mobile.Reason)
    fmt.Println(mobile.Result.City)
}

输出：

200
Return Successd!
杭州

完美解析。

到这问题还没结束，思考下这些问题：

如果 json 格式的数据类型不确定怎么办？

如果 json 格式的数据 result 中参数不固定怎么办？

思路是这样的：

去 github 上找开源类库，哈哈，我使用的是这个：

https://github.com/mitchellh/mapstructure

咱们一起学习下，先解决第一个问题，数据类型不确定怎么办？

先定义一个 string 类型的 resultcode，json 却返回了 int 类型的 resultcode。

看文档有一个弱类型解析的方法 WeakDecode()，咱们试一下：

type MobileInfo struct {
    Resultcode string `json:"resultcode"`
}

func main() {
    jsonStr := `
        {
            "resultcode": 200
        }
    `

    var result map[string]interface{}
    err := json.Unmarshal([]byte(jsonStr), &result)
    if err != nil {
        fmt.Println(err.Error())
    }

    var mobile MobileInfo
    err = mapstructure.WeakDecode(result, &mobile)
    if err != nil {
        fmt.Println(err.Error())
    }

    fmt.Println(mobile.Resultcode)
}

输出：

200

第一个问题已解决。

再解决第二个问题，result 中参数不固定怎么办？

这个就不用上面的例子了，看下官方提供的例子 Example (EmbeddedStruct) 。

type Family struct {
    LastName string
}
type Location struct {
    City string
}
type Person struct {
    Family    `mapstructure:",squash"`
    Location  `mapstructure:",squash"`
    FirstName string
}

func main() {
    input := map[string]interface{}{
        "FirstName": "Mitchell",
        "LastName":  "Hashimoto",
        "City":      "San Francisco",
    }

    var result Person
    err := mapstructure.Decode(input, &result)
    if err != nil {
        panic(err)
    }

    fmt.Println(result.FirstName)
    fmt.Println(result.LastName)
    fmt.Println(result.City)
}

输出：

Mitchell
Hashimoto
San Francisco

使用的是 mapstructure 包，struct tag 标识不要写 json，要写 mapstructure。

其他情况自己探索吧，比如： Example (Tags)。

go-gin-api 系列文章

• 7. 路由中间件 - 签名验证
• 6. 路由中间件 - Jaeger 链路追踪（实战篇）
• 5. 路由中间件 - Jaeger 链路追踪（理论篇）
• 4. 路由中间件 - 捕获异常
• 3. 路由中间件 - 日志记录
• 2. 规划项目目录和参数验证
• 1. 使用 go modules 初始化项目