Golang實(shí)現(xiàn)解析JSON的三種方法總結(jié)

更新時(shí)間：2022年09月13日 15:34:16 作者：Go和分布式IM

這篇文章主要為大家詳細(xì)介紹了Golang實(shí)現(xiàn)解析JSON的三種方法，文中的示例代碼講解詳細(xì)，對(duì)我們學(xué)習(xí)了解JSON有一定幫助，需要的可以參考一下

背景

這是一篇寫給0-1年新人的文章，短平快的教會(huì)你如何解析json字符串。

示例Json

假設(shè)有如下json字符串：

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

我們來看看，如何在go中解析。

例子

直接上代碼：

package main
  
import (
    "encoding/json"
    "log"
    "github.com/tidwall/gjson"
)
  
// 嵌套一個(gè)對(duì)象
type Info struct {
    Age int `json:"age"`
}
  
var info = Info{Age: 12}
  
// 嵌套一個(gè)對(duì)象數(shù)組
type Extra struct {
    Address string `json:"address"`
}
  
// 定義需要反序列化的結(jié)構(gòu)體
type UserRequest struct {
    Name     string  `json:"userName"`  // 通過tag里面的json，來指定json字符串中該字段的值從那里解析，不需要和字段名一樣
    NickName string  `json:"nick_name"` // 如果沒對(duì)應(yīng)上，解析不了
    info     Info    `json:"info"`      // 小寫私有的，故反序列化失效，該字段永遠(yuǎn)為空
    Extra    []Extra `json:"extra"`
}
  
func main() {
    jsonStr := `
    {
        "userName":"admin",
        "nick_name":"管理員",
        "info":{
           "age":18
        },
        "extra":[
           {
              "address":"上海市"
           },
           {
              "address":"北京市"
           }
        ]
     }`
  
    // 方式一：序列化成map，經(jīng)常使用
    anyMap := make(map[string]interface{}, 0)
    if err := json.Unmarshal([]byte(jsonStr), &anyMap); err != nil {
        panic(err)
    }
    log.Println("Unmarshal to map result:", anyMap)
  
    // 方式二：反序列化成對(duì)象，經(jīng)常使用
    req := UserRequest{}
    if err := json.Unmarshal([]byte(jsonStr), &req); err != nil {
        panic(err)
    }
    log.Println("Unmarshal to struct:", req)
  
    // 方式三：不反序列化，只讀取單個(gè)key，經(jīng)常使用。適合特別復(fù)雜的json字符串，或者有多種if else結(jié)構(gòu)的場(chǎng)景
    userName := gjson.Get(jsonStr, "userName")
    nickName := gjson.Get(jsonStr, "nick_name")
    age := gjson.Get(jsonStr, "info.age").Int()
  
    // 取得extra數(shù)組0位置的對(duì)象
    address1 := gjson.Get(jsonStr, "extra").Array()[1]
    log.Println("get raw value by key:", userName, nickName, age, address1.Get("address"))
}

運(yùn)行后輸出：

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{}，所以你取值的時(shí)候，需要這樣?。?/p>

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

是不是感覺非常麻煩？一是需要判斷key是否存在，二是類型轉(zhuǎn)換。

所以，反序列化時(shí)這種方式不是很常用，但是序列化的時(shí)候，非常方便，用的較多。

比如在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": "賬號(hào)錯(cuò)誤！"})
   }
}

看到 gin.H 了嗎？實(shí)際上就是：

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

所以：

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

等價(jià)于：

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

這樣做的好處是，不需要預(yù)先定義結(jié)構(gòu)體，直接通過語法糖實(shí)現(xiàn)，代碼更簡潔。

2）反序列化成對(duì)象

這個(gè)是最常用的，通過 `json.Unmarshal` 把二進(jìn)制反序列化成對(duì)象，通過 `json.Marshal()` 把對(duì)象序列化成json字符串。需要注意的是：

字段tag中的名字要和json字符串中的對(duì)應(yīng)，否則解析不到值

字段名不能是小寫開頭，私有的字段無法將被忽略，也會(huì)解析不到值

支持嵌套，由go標(biāo)準(zhǔn)庫通過反射自動(dòng)完成

3）復(fù)雜json的解析

有時(shí)候，一個(gè)json非常復(fù)雜，或者你只需要取某個(gè)字段，那么就可以使用這種方式：

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

別忘記，gjson 不是標(biāo)準(zhǔn)庫的包，需要使用 go get github.com/tidwall/gjson 安裝。

總結(jié)

本文介紹了解析json的3種方式：

直接解析成 map[string]interface{}
解析成對(duì)象
讀取單個(gè)key

這3種方式?jīng)]有好壞之分，只看具體的場(chǎng)景，靈活使用即可。唯一不變的是，都是通過 `json.Unmarshal` 把二進(jìn)制反序列化成對(duì)象，通過 `json.Marshal()` 把對(duì)象

序列化成json字符串。

加餐：什么是序列化？

百科中說：序列化 (Serialization)是將對(duì)象的狀態(tài)信息轉(zhuǎn)換為可以存儲(chǔ)或傳輸?shù)男问降倪^程。

通俗點(diǎn)說就是因?yàn)榫W(wǎng)絡(luò)只能發(fā)送二進(jìn)制流，而我們代碼中的數(shù)據(jù)又是保存在各種對(duì)象中。在C/S（客戶端/服務(wù)器）架構(gòu)中，客戶端傳遞數(shù)據(jù)給服務(wù)器勢(shì)必就要進(jìn)行2次轉(zhuǎn)換。

客戶端：發(fā)送之前，要把對(duì)象轉(zhuǎn)換為二進(jìn)制字節(jié)流。

服務(wù)器：接收到二進(jìn)制流之后，要轉(zhuǎn)換為對(duì)象。