Golang笔记：使用json包处理JSON数据

目的

JSON 是一种非常流行的数据交换格式，是JavaScript中原生支持的一种数据，因为其简单方便，所以也经常用在不同程序、不同语言间数据交互。这篇文章将介绍在Golang中使用JSON相关内容（ encoding/json ）。

Decoding（解析数据）

encoding/jsonfunc Unmarshal(data []byte, v any) error

package main
import (
	"encoding/json"
	"fmt"
)
type data struct {
	Num int    `json:"num"`
	Bl  bool   `json:"bl"`
	Str string `json:"str"`
	Arr []int  `json:"arr"`
	Obj struct {
		Num int `json:"num"`
	} `json:"obj"`
} // 用于接收JSON字符串中内容的结构体类型
func main() {
	var j data
	s := `{
		"num": 233,
		"bl": true,
		"str": "naisu",
		"arr": [
		  22,
		  33
		],
		"obj": {
		  "num": 777
		}
	  }` // 原始JSON字符串
	json.Unmarshal([]byte(s), &j) // 从原始数据中解析内容填充结构体对象
	fmt.Println(j.Num, j.Bl, j.Str, j.Arr, j.Obj)
}

上面例子操作比较简单，但是演示了JSON的几种基本的数据格式。需要注意的是 结构体中字段名称首字母需要大写 。

如果有现成的JSON数据范本的话可以通过下面工具直接生成结构体类型声明：
https://mholt.github.io/json-to-go/

上面演示中结构体类型中字段和原始JSON数据中字段是可以一一匹配上的，但如果两者无法一一匹配，也可以进行解析。 结构体中有而JSON中没有的字段，那么解析之后结构体对象中这些字段将会填充默认值。结构体中没有而JSON中有的字段，那么解析时会忽略这些字段。

map[string]interface{}[]interface{}

package main
import (
	"encoding/json"
	"fmt"
)
func main() {
	var j map[string]interface{}
	s := `{
		"num": 233,
		"bl": true,
		"str": "naisu",
		"arr": [
		  22,
		  33
		],
		"obj": {
		  "num": 777
		}
	  }` // 原始JSON字符串
	if err := json.Unmarshal([]byte(s), &j); err != nil {
		fmt.Println(err)
	}
	fmt.Println(j)
	for k, v := range j {
		switch vv := v.(type) {
		case bool:
			fmt.Println(k, "is bool", vv)
		case string:
			fmt.Println(k, "is string", vv)
		case float64:
			fmt.Println(k, "is float64", vv)
		case []interface{}:
			fmt.Println(k, "is array:")
			for i, u := range vv {
				fmt.Println(i, u)
			}
		case map[string]interface{}:
			fmt.Println(k, "is oject:", v)
		default:
			fmt.Println(k, "is of a type I don't know how to handle")
		}
	}
}

interface{}any

Encoding（创建数据）

encoding/jsonfunc Marshal(v any) ([]byte, error)

package main
import (
	"encoding/json"
	"fmt"
)
type data struct {
	Num int    `json:"num"`
	Bl  bool   `json:"bl"`
	Str string `json:"str"`
	Arr []int  `json:"arr"`
	Obj struct {
		Num int `json:"num"`
	} `json:"obj"`
} // 用于接收JSON字符串中内容的结构体类型
func main() {
	j := data{
		Num: 233,
		Bl:  true,
		Str: "naisu",
	}
	j.Arr = append(j.Arr, 22, 33)
	j.Obj.Num = 777
	b, err := json.Marshal(j) // 将结构体转换成JSON字符串
	if err != nil {
		fmt.Println(err)
	}
	fmt.Println(string(b))
}

数据也可以通过接口或泛型等类型进行转换：

package main
import (
	"encoding/json"
	"fmt"
)
func main() {
	j := make(map[string]any)
	j["Num"] = 233
	j["Bl"] = true
	j["Str"] = "naisu"
	Arr := []int{}
	Arr = append(Arr, 22, 33)
	j["Arr"] = Arr
	Obj := make(map[string]any)
	Obj["Num"] = 777
	j["Obj"] = Obj
	b, err := json.Marshal(j) // 将结构体转换成JSON字符串
	if err != nil {
		fmt.Println(err)
	}
	fmt.Println(string(b))
}

总结

MarshalJSONUnmarshalJSON