Go JSON编码与解码的实现

在开发应用程序时,客户端(前端页面或APP)与服务端交互是在所难免的,在交互过程传递数据时,最通用和流行格式便是JSON,Go语言提供了encoding/json包,用于处理JSON数据的编码与解码。

除了JSON,XML也常用于前后端的数据交互,不过由于简洁性、可读性和流行程度,JSON用得更加广泛。

JSON简介

1. 什么是JSON?

JSON全称为Javascript Object Notation,一种数据结构化交互的标准协议,易于阅读与编写,所以在数据交互时广泛使用。

2. JSON中的数据类型

  • 数字:有十进制和科学记数学两种表示方式。
  • 字符串:使用双引号表示的Unicode字符序列。
  • 布尔:true或者false。
  • 对象:花括号({})括起来的一个或多个键值对(key/value),用逗号(,)隔开,最后一个键值对后面不能有逗号,键必是双引号("")引起来的字符串,而值则可是作意类型(布尔、数字、对象、数组、字符串)。
  • 数组:中括号([])括号值的集合,这些值可是任意类型(布尔、数字、对象、数组、字符串)。

下面的示例,是一个数组中包括两个对象。

[{"id":1,"username":"xiaoming","gender":1,"email":"xiaoming@163.com"},{"id":2,"username":"xiaohong","gender":2,"email":"xiaohong@163.com"}]

3. JSON与GO结合

使用encoding/json处理JSON编码与解码时,就必须处理好JSON数据类型与Go语言数据类型的对应关系。

  • JSON的数字、字符串、布尔等在Go语言中相应内置数据类型一一对应。
  • JSON的数组则对应Go的数组或Slice(切片)。
  • JSON的对象则对应Go的struct(结构体)或map。

编码一个结构体时,结构体中只有首字母大写的成员才会被编码,首字母小写的成员会被忽略,另外,结构体中字段后面允许使用反引号声明成员的Tag,用于说明成员的元信息。

type Member struct {
  Id    int  `json:"id"`
  Username string `json:"username"`
  Sex   uint  `json:"gender"`
  Email  string `json:"email"`
}

上面的结构体Member中,我们定义了四个成员,并声明了每个成员的Tag信息, 其中Sex的Tag信息声明为gender,所以编码后的结果为:

[{"id":1,"username":"xiaoming","gender":1,"email":"xiaoming@163.com"},{"id":2,"username":"xiaohong","gender":2,"email":"xiaohong@163.com"}]

编码

将Go语言的数据序列化为JSON字符串的操作,称为编码;编码后的结果为一个JSON格式的字符串。

1. json.Marshal函数

使用json.Marshal函数可以直接编码任意数据类型。

import (
  "encoding/json"
  "fmt"
)
func main() {
members := []Member{
  {
    Id:1,
    Username:"小明",
    Sex:1,
    Email:"xiaoming@163.com",
  },
  {
    Id:2,
    Username:"小红",
    Sex:1,
    Email:"xiaohong@163.com",
  },
  {
    Id:3,
    Username:"小华",
    Sex:2,
    Email:"xiaohua@163.com",
  },
}
  data,_ := json.Marshal(members)
  fmt.Printf("%s",data)
}

运行结果:

[{"id":1,"username":"小明","gender":1,"email":"xiaoming@163.com"},{"id":2,"username":"小红","gender":1,"email":"xiaohong@163.com"},{"id":3,"username":"小华","gender":2,"email":"xiaohua@163.com"}]

2. json.Encoder

json.Marshal实际上只是对json.Encoder的封装,因此使用json.Encoder同样可以编码JSON。

func main(){
  b := &bytes.Buffer{}
  encoder := json.NewEncoder(b)
  err := encoder.Encode(members)
  if err != nil{
   panic(err)
  }
  fmt.Println(b.String())
}

解码

将JSON字符串反序列化为Go相对应类型的作品,称为解码。

1. json.Unmarshal函数

json.Unmarshal与json.Marshal函数相反,用于解码JSON字符串。

func main() {
  str := `[
  {
    "id": 1,
    "username": "小明",
    "gender": 1,
    "email": "xiaoming@163.com"
  },
  {
    "id": 2,
    "username": "小红",
    "gender": 1,
    "email": "xiaohong@163.com"
  },
  {
    "id": 3,
    "username": "小华",
    "gender": 2,
    "email": "xiaohua@163.com"
  }
  ]`
  b := bytes.NewBufferString(str)
  var members []Member
  err := json.Unmarshal(b.Bytes(),&members)
  if err != nil{
    panic(err)
  }
  fmt.Println(members)
}

运行结果:

[{1 小明 1 xiaoming@163.com} {2 小红 1 xiaohong@163.com} {3 小华 2 xiaohua@163.com}]

2. json.Decoder

func main(){
  b := bytes.NewBufferString(str)
  var members []Member
 decoder := json.NewDecoder(b)
 err = decoder.Decode(&members)
 if err != nil{
 panic(err)
 }
 fmt.Println(members)
}

小结

Go语言中的encoding/json提供了对JSON数据的编码与解码的各种便捷的方法,我们只要直接使用便完成完成有关JSON的各种处理操作,非常简单方便。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持来客网。