文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

Golang实现解析JSON的三种方法总结

2024-04-02 19:55

关注

背景

这是一篇写给0-1年新人的文章,短平快的教会你如何解析json字符串。

示例Json

假设有如下json字符串:

{
   "userName":"admin",
   "nick_name":"管理员",
   "info":{
      "age":18
   },
   "extra":[
      {
         "address":"上海市"
      },
      {
         "address":"北京市"
      }
   ]
}

我们来看看,如何在go中解析。

例子

直接上代码:

package main
  
import (
    "encoding/json"
    "log"
    "github.com/tidwall/gjson"
)
  
// 嵌套一个对象
type Info struct {
    Age int `json:"age"`
}
  
var info = Info{Age: 12}
  
// 嵌套一个对象数组
type Extra struct {
    Address string `json:"address"`
}
  
// 定义需要反序列化的结构体
type UserRequest struct {
    Name     string  `json:"userName"`  // 通过tag里面的json,来指定json字符串中该字段的值从那里解析,不需要和字段名一样
    NickName string  `json:"nick_name"` // 如果没对应上,解析不了
    info     Info    `json:"info"`      // 小写私有的,故反序列化失效,该字段永远为空
    Extra    []Extra `json:"extra"`
}
  
func main() {
    jsonStr := `
    {
        "userName":"admin",
        "nick_name":"管理员",
        "info":{
           "age":18
        },
        "extra":[
           {
              "address":"上海市"
           },
           {
              "address":"北京市"
           }
        ]
     }`
  
    // 方式一:序列化成map,经常使用
    anyMap := make(map[string]interface{}, 0)
    if err := json.Unmarshal([]byte(jsonStr), &anyMap); err != nil {
        panic(err)
    }
    log.Println("Unmarshal to map result:", anyMap)
  
    // 方式二:反序列化成对象,经常使用
    req := UserRequest{}
    if err := json.Unmarshal([]byte(jsonStr), &req); err != nil {
        panic(err)
    }
    log.Println("Unmarshal to struct:", req)
  
    // 方式三:不反序列化,只读取单个key,经常使用。适合特别复杂的json字符串,或者有多种if else结构的场景
    userName := gjson.Get(jsonStr, "userName")
    nickName := gjson.Get(jsonStr, "nick_name")
    age := gjson.Get(jsonStr, "info.age").Int()
  
    // 取得extra数组0位置的对象
    address1 := gjson.Get(jsonStr, "extra").Array()[1]
    log.Println("get raw value by key:", userName, nickName, age, address1.Get("address"))
}

运行后输出:

2022/09/13 11:09:13 Unmarshal to map result: map[extra:[map[address:上海市] map[address:北京市]] info:map[age:18] nick_name:管理员 userName:admin]
2022/09/13 11:09:13 Unmarshal to struct: {admin 管理员 {0} [{上海市} {北京市}]}
2022/09/13 11:09:13 get raw value by key: admin 管理员 18 北京市

解释

1)反序列化成map

anyMap := make(map[string]interface{}, 0)
if err := json.Unmarshal([]byte(jsonStr), &anyMap);
//...

我们看到,key是string,value是interface{},所以你取值的时候,需要这样取:

ageVal,ok := anyMap["age"]
if ok{
    age := ageVal.(int)
    log.Println(age)
}

是不是感觉非常麻烦?一是需要判断key是否存在,二是类型转换。

所以,反序列化时这种方式不是很常用,但是序列化的时候,非常方便,用的较多。

比如在gin框架中,就被大量使用:

type LoginReq struct {
   UserName string `json:"user_name"`
}
  
func onLogin(ctx *gin.Context) {
   req := LoginReq{}
   if err := ctx.BindJSON(&req); err != nil {
      ctx.Error(err)
   }
  
   if req.UserName == "admin" {
      ctx.JSON(http.StatusOK, gin.H{"code": 0, "msg": "success"})
   } else {
      ctx.JSON(http.StatusUnauthorized, gin.H{"code": -1, "msg": "账号错误!"})
   }
}

看到 gin.H 了吗?实际上就是:

// H is a shortcut for map[string]interface{}
type H map[string]interface{}

所以:

ctx.JSON(http.StatusOK, gin.H{"code": 0, "msg": "success”})

等价于: 

ctx.JSON(http.StatusOK, map[string]interface{}{"code": 0, "msg": "success"})

这样做的好处是,不需要预先定义结构体,直接通过语法糖实现,代码更简洁。

2)反序列化成对象

这个是最常用的,通过 `json.Unmarshal` 把二进制反序列化成对象,通过 `json.Marshal()` 把对象序列化成json字符串。需要注意的是:

字段tag中的名字要和json字符串中的对应,否则解析不到值

字段名不能是小写开头,私有的字段无法将被忽略,也会解析不到值

支持嵌套,由go标准库通过反射自动完成

3)复杂json的解析

有时候,一个json非常复杂,或者你只需要取某个字段,那么就可以使用这种方式:

userName := gjson.Get(jsonStr, "userName")

别忘记,gjson 不是标准库的包,需要使用 go get github.com/tidwall/gjson 安装。 

总结

本文介绍了解析json的3种方式:

这3种方式没有好坏之分,只看具体的场景,灵活使用即可。唯一不变的是,都是通过 `json.Unmarshal` 把二进制反序列化成对象,通过 `json.Marshal()` 把对象

序列化成json字符串。

加餐:什么是序列化?

百科中说:序列化 (Serialization)是将对象的状态信息转换为可以存储或传输的形式的过程。

通俗点说就是因为网络只能发送二进制流,而我们代码中的数据又是保存在各种对象中。在C/S(客户端/服务器)架构中,客户端传递数据给服务器势必就要进行2次转换。

客户端:发送之前,要把对象转换为二进制字节流。

服务器:接收到二进制流之后,要转换为对象。

这种从对象到二进制流的过程叫序列化(Serialization),反过来从二进制流转换成对象就叫反序列化。

到此这篇关于Golang实现解析JSON的三种方法总结的文章就介绍到这了,更多相关Golang解析JSON内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网!

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯