使用Go語言解析動態JSON格式的方法

通常使用Golang encoding/json 標準庫可以方便的編碼/解析JSON數據，但是前提需要定義struct數據結構。特別是解析未知結構的JSON數據時，原有方法很難滿足需求了，本文主要介紹動態解析JSON格式。

Go語言的JSON 庫

Go語言自帶的JSON轉換庫為 encoding/json

1.1）其中把對象轉換為JSON的方法（函數）為 json.Marshal()，其函數原型如下

func Marshal(v  interface{}) ([]byte, error)

也就是說，這個函數接收任意類型的數據 v，并轉換為字節數組類型，返回值就是我們想要的JSON數據和一個錯誤代碼。當轉換成功的時候，這個錯誤代碼為nil

在進行對象轉換為 JSON 的過程中，會遵循如下幾條規則：

1. 布爾型轉換為 JSON 后仍是布爾型　， 如true -> true
2. 浮點型和整數型轉換后為JSON里面的常規數字，如 1.23 -> 1.23
3. 字符串將以UTF-8編碼轉化輸出為Unicode字符集的字符串，特殊字符比如<將會被轉義為\u003c
4. 數組和切片被轉換為JSON 里面的數組，[]byte類會被轉換為base64編碼后的字符串，slice的零值被轉換為null
5. 結構體會轉化為JSON對象，并且只有結構體里邊以大寫字母開頭的可被導出的字段才會被轉化輸出，而這些可導出的字段會作為JSON對象的字符串索引
6. 轉化一個map 類型的數據結構時，該數據的類型必須是 map[string]T（T 可以是encoding/json 包支持的任意數據類型）

1.2）把 JSON 轉換回對象的方法（函數）為 json.Unmarshal()，其函數原型如下

func Unmarshal(data [] byte, v interface{}) error

這個函數會把傳入的 data 作為一個JSON來進行解析，解析后的數據存儲在參數 v 中。這個參數 v 也是任意類型的參數（但一定是一個類型的指針），原因是我們在是以此函數進行JSON 解析的時候，這個函數不知道這個傳入參數的具體類型，所以它需要接收所有的類型。

那么，在進行解析的時候，如果JSON 和 對象的結構不對口會發生什么呢，這就需要解析函數json.Unmarshal()遵循以下規則

json.Unmarshal() 函數會根據一個約定的順序查找目標結構中的字段，如果找到一個即發生匹配。那什么是找到了呢？關于“找到了”又有如下的規則：假設一個JSON對象有個名為"Foo"的索引，要將"Foo"所對應的值填充到目標結構體的目標字段上，json.Unmarshal() 將會遵循如下順序進行查找匹配

1. § 一個包含Foo 標簽的字段
2. §  一個名為Foo 的字段
3. § 一個名為Foo 或者Foo 或者除了首字母其他字母不區分大小寫的名為Foo 的字段。 這些字段在類型聲明中必須都是以大寫字母開頭、可被導出的字段。

注意：如果JSON中的字段在Go目標類型中不存在，json.Unmarshal() 函數在解碼過程中會丟棄該字段。

當JSON 的結構是未知的時候，會遵循如下規則：

1. § JSON中的布爾值將會轉換為Go中的bool類型
2. § 數值會被轉換為Go中的float64類型
3. § 字符串轉換后還是string類型
4. § JSON數組會轉換為[]interface{} 類型
5. § JSON對象會轉換為map[string]interface{}類型
6. § null值會轉換為nil

注意：在Go的標準庫encoding/json包中，允許使用map[string]interface{}和[]interface{} 類型的值來分別存放未知結構的JSON對象或數組

1、傳統方法

比如 User 數據結構如下：

type User struct {
 Name string `json:"name"`
 Age int  `json:"age"`
}

在定義struct字段的時候，可以在字段后面添加tag，來控制encode/decode的過程：是否要 decode/encode 某個字段，JSON 中的字段名稱是什么。字段名首字母控制字段的可見性，若要輸出到JSON，首字母需要大寫。

三種tag：

- ：不要解析這個字段

omitempty ：當字段為空（默認值）時，不要解析這個字段。比如 false、0、nil、長度為 0 的 array，map，slice，string

FieldName ：當解析 json 的時候，使用這個名字

舉例來說吧：

// 解析的時候忽略該字段。默認情況下會解析這個字段，因為它是大寫字母開頭的
Field int `json:"-"`
// 解析（encode/decode） 的時候，使用 `other_name`，而不是 `Field`
Field int `json:"other_name"`
// 解析的時候使用 `other_name`，如果struct 中這個值為空，就忽略它
Field int `json:"other_name,omitempty"`

（1）encode

user := User{Name: "test", Age:23}
data, err := json.Marshal(user)
if err != nil {
 fmt.Println(string(data))
}

data 就是 []byte 類型的數組，里面包含了解析為 JSON 之后的數據，可以使用string(data)轉型為string。

（2）decode

要把JSON數據轉換成Go類型的值（Decode），可以使用 json.Unmarshal 。

var user User
err = json.Unmarshal(data, &user)
if err != nil {
 fmt.Errorf("Can not decode data: %v\n", err)
}

2、動態解析

動態JSON結構未知，若使用前面方法需要事先定義數據結構，這與PHP/Python JSON處理非常不同。若不考慮性能，使用simplejson。

（1）simplejson

js, err := simplejson.NewJson([]byte(`{
 "test": {
  "string_array": ["asdf", "zxcv"],
  "array": [1, "2", 3],
  "arraywithsubs": [{"subkeyone": 1},
  "bignum": 9223372036854775807,
  "string": "simplejson",
  "bool": true
 }
 }`))
 if err != nil {
  panic("json format error")
 }
 //獲取某個字段值
 s, err := js.Get("test").Get("string").String()
 if err != nil {
  panic(err)
 }
 fmt.Println(s)
 //檢查某個字段是否存在
 _, ok := js.Get("test").CheckGet("string2")
 if ok {
  fmt.Println("存在！")
 } else {
  fmt.Println("不存在")
 }

（2）interface

比如JSON有以下兩種類型：

{"Type":"sound","Msg":{"Description":"dynamite","Authority":"the Bruce Dickinson"}}
{"Type":"cowbell","Msg":{"More":true}}

Msg 具體什么類型實現無法判斷， Msg being a map[string]interface{} ：

type Envelope struct {
 Type string
 Msg interface{}
}

var env Envelope
if err := json.Unmarshal([]byte(input), &env); err != nil {
  log.Fatal(err)
 }
// for the love of Gopher DO NOT DO THIS
var desc string = env.Msg.(map[string]interface{})["description"].(string)
fmt.Println(desc)

以上就是本文的全部內容，希望對大家的學習有所幫助，也希望大家多多支持億速云。