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 的简单使用方式。

网站名称：Go语言怎么处理三方接口返回数据？
本文地址：http://www.shufengxianlan.com/qtweb/news26/424276.html

网站建设、网络推广公司-创新互联，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 创新互联