Go --- Marshal与Unmarshal基础用法

go语言本身为我们提供了json的工具包”encoding/json”。

前言：

Json–Javascript Object Nanotation 是一种数据交换格式，经常用于前后端的数据传输。一端将数据转换成json字符串，另一端再将json字符串转换成相应的数据结构，如struct, float等。

用法：

1.Marshal—将数据编码成json字符串

package main

import (
  "encoding/json"
  "fmt"
)

type Student struct{
  Name string `json:"name"`
  Age int
  sex string
  Class *Class `json:"class"`
}

type Class struct {
  Name string
  Grade int
}

func main() {
  //实例化一个数据结构，用于生成json字符串
  stu := Student{
    Name: "Raily",
    Age: 18,
    sex: "女",
  }
  //指针变量
  cla :=  new(Class)
  cla.Name = "1班"
  cla.Grade = 3
  stu.Class = cla

  jsonStu, err := json.Marshal(stu)
  if err!= nil{
    return
  }
  //jsonStu是[]byte类型，转化成string类型便于查看
  fmt.Println(string(jsonStu))
}      

输出结果：

{"name":"Raily","Age":18,"class":{"Name":"1班","Grade":3}}      

• 1

从结果中可以看出：

①只要是可导出成员（变量首字母大写），都可以转成json。因成员变量sex是不可导出的，故无法转成json。

②如果变量打上了json标签，如Name旁边的 ​

​json:"name"​

​ ，那么转化成的json key就用该标签“name”，否则取变量名作为key，如“Age”，“HIgh”。

③bool类型也是可以直接转换为json的value值。Channel， complex 以及函数不能被编码json字符串。当然，循环的数据结构也不行，它会导致marshal陷入死循环。

④指针变量，编码时自动转换为它所指向的值，如cla变量。（当然，不传指针，Stu struct的成员Class如果换成Class struct类型，效果也是一模一样的。只不过指针更快，且能节省内存空间。）

最后，强调一句：json编码成字符串后就是纯粹的字符串了。

············································································································

上面的成员变量都是已知的类型，只能接收指定的类型，比如string类型的Name只能赋值string类型的数据。

但有时为了通用性，或使代码简洁，我们希望有一种类型可以接受各种类型的数据，并进行json编码。这就用到了interface{}类型。

如下：

type Student struct {
    Name  interface{} `json:"name"`
    Age   interface{}
    sex   interface{}
    Class interface{} `json:"class"`
}
//其他部分与上面的例子一样；无论是string，int，bool，还是指针类型等，都可赋值给interface{}类型。      

············································································································

在实际项目中，编码成json串的数据结构，往往是切片类型。如下定义了一个[]StuRead类型的切片：

//方式1：只声明，不分配内存
var stus1 []*StuRead

//方式2：分配初始值为0的内存
stus2 := make([]*StuRead, 0)

//错误示范
//new()只能实例化一个struct
stus := new([]StuRead)

stu1 := StuRead{成员赋值...}
stu2 := StuRead{成员赋值...}

//由方式1和2创建的切片，都能成功追加数据
//方式2最好分配0长度，append时会自动增长。反之指定初始长度，长度不够时不会自动增长，导致数据丢失
stus1 := appen(stus1,stu1,stu2)
stus2 := appen(stus2,stu1,stu2)

//成功编码
json1,_ := json.Marshal(stus1)
json2,_ := json.Marshal(stus2)      

解码时定义对应的切片接受即可。

2.Unmarshal—将json字符串解码到相应的数据结构

将上面的例子进行解码：

type StuRead struct {
    Name  interface{} `json:"name"`
    Age   interface{}
    sex   interface{}
    Class interface{} `json:"class"`
    Test  interface{}
}

type Class struct {
    Name  string
    Grade int
}

func main() {
    //json字符中的"引号，需用\进行转义，否则编译出错
    //json字符串沿用上面的结果，但对key进行了大小的修改，并添加了sex数据
    data:="{\"name\":\"张三\",\"Age\":18,\"sex\":\"男\",\"CLASS\":{\"naME\":\"1班\",\"GradE\":3}}"
   
    str:=[]byte(data)
    //1.Unmarshal的第一个参数是json字符串，第二个参数是接受json解析的数据结构。
    //第二个参数必须是指针，否则无法接收解析的数据，如stu仍为空对象StuRead{}
    //2.可以直接stu:=new(StuRead),此时的stu自身就是指针
    stu:=StuRead{}
    err:=json.Unmarshal(str,&stu)
    //解析失败会报错，如json字符串格式不对，缺"号，缺}等。
    if err!=nil{
        fmt.Println(err)
    }

    fmt.Println(stu)
}      

结果：

{张三 18 true <nil> map[naME:1班 GradE:3] <nil>}      

总结：

① json字符串解析时，需要一个“接收体”接受解析后的数据，且Unmarshal时接收体必须传递指针。否则解析虽不报错，但数据无法赋值到接受体中。如这里用的是StuRead{}接收。