Go 语言怎么处理三方接口返回数据？

​1.介绍

在使用 Go 语言调用三方RESTful接口时，处理因为无法直接操作 json 字符串，口返所以我们需要先将 json 字符串转换为 map 或 struct。回数

本文我们介绍一下怎么处理三方接口返回数据。处理

2.普通 json

我们先看一下三方接口返回的口返普通 json。

func main() {

// 三方返回普通 json 字符串

jsonRes := `{

"Id": 1001,回数

"Name": "frank"

}`

data := new(User)

err := json.Unmarshal([]byte(jsonRes), &data)

if err != nil {

log.Printf("json Unmarshal err:%v\n", err)

return

}

fmt.Printf("data=%+v", data)

}

type User struct {

Id int

Name string

}

输出结果：

data=&{ Id:1001 Name:frank}

阅读上面这段代码，我们构造一个简单的处理 json 字符串，模拟三方接口返回数据。口返

我们使用 Go 标准库 encoding/json​ 的回数 Unmarshal 函数，可以很容易将 json 数据解码到 struct，处理从而方便我们读取返回数据。口返

但是回数，需要读者朋友们注意的处理是，假如三方接口返回数据的口返字段类型随机变化（比如示例中的 Id​ 字段，可能是回数整型或字符串随机返回），我们使用 Unmarshal 函数解码时，就有可能会返回错误，如下所示：

2022/08/15 14:07:41 json Unmarshal err:json: cannot unmarshal string into Go struct field User.Id of type int

阅读到这里，我相信已经有读者朋友们想到，可以把返回数据解码到 map[string]interface{ } 类型的变量中。

示例代码：

func main() {

// 三方返回普通 json 字符串

jsonRes := `{

"Id": 1001,

"Name": "frank"

}`

data2 := make(map[string]interface{ })

err := json.Unmarshal([]byte(jsonRes), &data2)

if err != nil {

log.Printf("json Unmarshal err:%v\n", err)

return

}

fmt.Printf("data2=%+v", data2)

}

输出结果：

data2=map[Id:1001 Name:frank]

阅读上面示例代码，我们可以通过将返回数据解码到 map[string]interface{ } 类型的亿华云计算变量中，从而解决三方接口返回数据的字段类型不固定的问题。

普通 json 使用该方式处理确实可行，但是如果嵌套 json，也可以这么处理，但是读取嵌套 json 的子字段就不那么方便了。

3.嵌套 json

我们再构造一个三方接口返回数据是嵌套 json 的变量。

func main() {

// 三方返回嵌套 json 字符串

jsonRes := `{

"Id": 1001,

"Name": "frank",

"Details": {

"Gender": "man",

"Age": 18,

"Phone": "13800138000",

"address": "Beijing"

}

}`

data := new(User)

err := json.Unmarshal([]byte(jsonRes), &data)

if err != nil {

log.Printf("json Unmarshal err:%v\n", err)

return

}

fmt.Printf("data=%+v", data)

}

type User struct {

Id int

Name string

Details Details

}

type Details struct {

Gender string

Age int

Phone string

Address string

}

输出结果：

data=&{ Id:1001 Name:frank Details:{ Gender:man Age:18 Phone:13800138000 Address:Beijing}}

阅读上面这段代码，我们构造一个嵌套 json，使用 Unmarshal 函数解码到 struct 中。

但是，如果返回数据中的 Age​ 字段是字符串类型，我们使用 Unmarshal 函数解码时，就会返回以下错误：

2022/08/15 17:33:08 json Unmarshal err:json: cannot unmarshal string into Go struct field Details.Details.Age of type int

虽然，我们可以使用普通 json 中的处理方式，将返回数据解码到 map[string]interface{ } 类型的变量中。但是，如果我们想要读取内嵌 json 中的源码库子字段，就读取不到了。

怎么解决这个问题呢？我们可以借助三方库 mapstructure​，使用该三方库的 Decode​ 函数替代 Go 标准库 encoding/json​ 的 Unmarshal 函数。

示例代码：

func main() {

// 三方返回嵌套 json 字符串

jsonRes := `{

"Id": 1001,

"Name": "frank",

"Details": {

"Gender": "man",

"Age": "18",

"Phone": "13800138000",

"address": "Beijing"

}

}`

tmpData := make(map[string]interface{ })

err := json.Unmarshal([]byte(jsonRes), &tmpData)

if err != nil {

log.Printf("json Unmarshal err:%v\n", err)

return

}

data2 := new(User)

err = mapstructure.Decode(tmpData, data2)

if err != nil {

log.Printf("decode err:%v\n", err)

return

}

fmt.Printf("data2=%+v\n", data2)

fmt.Printf("age=%v\n", data2.Details.Age)

}

type User struct {

Id int

Name string

Details Details

}

type Details struct {

Gender string

Age interface{ }

Phone string

Address string

}

输出结果：

data2=&{ Id:1001 Name:frank Details:{ Gender:man Age:18 Phone:13800138000 Address:Beijing}}

age=18

阅读上面这段代码，我们将嵌套 struct 的 Age​ 字段定义为 interface{ }​ 类型，首先，我们使用 Go 标准库的 Unmarshal​ 函数将返回数据解码到 map[string]interface{ } 类型的变量中。

然后使用三方库 mapstructure​ 的 Decode​ 函数，将 map[string]interface{ } 类型的变量中的数据解码到 struct 中，从而实现我们可以读取内嵌 json 中的子字段。

三方库 mapstructure 还有很多其他好用的功能，感兴趣的读者朋友们可以阅读官方文档了解更多内容。

4.总结

本文我们主要介绍怎么处理三方接口返回数据，其中包含普通 json 和嵌套 json，在处理嵌套 json 的内容中，我们介绍了三方库 mapstructure 的简单使用方式。

服务器托管