□ JSON处理

JSON （JavaScript Object Notation）是一种比XML更轻量级的数据交换格式，在易于人们阅读和编写的同时，也易于程序解析和生成。

尽管JSON是JavaScript的一个子集，但JSON采用完全独立于编程语言的文本格式，且表现为键/值对集合的文本描述形式（类似一些编程语言中的字典结构），这使它成为较为理想的、跨平台、跨语言的数据交换语言。

开发者可以用 JSON 传输简单的字符串、数字、布尔值，也可以传输一个数组，或者一个更复杂的复合结构。

在 Web 开发领域中， JSON被广泛应用于 Web 服务端程序和客户端之间的数据通信。

Go语言内建对JSON的支持。使用Go语言内置的encoding/json 标准库，开发者可以轻松使用Go程序生成和解析JSON格式的数据。

JSON官方网站：http://www.json.org/

在线格式化：http://www.json.cn/

1. 编码JSON （编组|封送 Marshaling）

1. Marhsal()

将数据编码成json字符串

// func Marshal(v interface{}) ([]byte, error){}
// 示例代码：
// Test11 go json.Marshal时，结构体字段需要大写 否则Marshal时不显示
type Test11 struct {
  Name string
  age  string
}
func main() {
  t1 := Test11{"sb", "12"}
  //生成一段JSON格式的文本
  //如果编码成功， err 将赋于零值 nil，变量b 将会是一个进行JSON格式化之后的[]byte类型
  b, err := json.Marshal(t1)
  if err != nil {
    fmt.Println(err)
  } else {
    fmt.Println(b)         // [123 34 78 97...]
    fmt.Println(string(b)) // {"Name":"sb"}
  }
}

2. MarshalIndent

将数据编码成json字符串例如map stuct等

// MarshalIndent 很像 Marshal，只是用缩进对输出进行格式化
func MarshalIndent(v interface{}, prefix, indent string) ([]byte, error)
// v: 想要编码成json的结构体|map
// prefix: 前缀,通常就设置为""即可。
// indent：缩进,通常设置为制表符\t即可
//示例代码：
func main() {
  t1 := Test11{"sb", 12}
  b,_ := json.MarshalIndent(t1,"","\t")
  fmt.Println(string(b))
  // {
  //   "Name": "sb",
  //   "Age": 12
  // }
}

MarshalIndent相比于Marhsal()的区别就在于读结果做了Indent 的处理：

Indent 的代码有点长，简单说就是对Json 多了一些格式处理。

3. struct tag

我们看到上面的输出字段名的首字母都是大写的，如果你想用小写的首字母怎么办呢？把结构体的字段名改成首字母小写的？

JSON输出的时候必须注意，只有导出的字段(首字母是大写)才会被输出，如果修改字段名，那么就会发现什么都不会输出，所以必须通过struct tag定义来实现。

针对JSON的输出，我们在定义struct tag的时候需要注意的几点是：

字段的tag是"-"，那么这个字段不会输出到JSON

tag中带有自定义名称，那么这个自定义名称会出现在JSON的字段名中

tag中如果带有"omitempty"选项，那么如果该字段值为空，就不会输出到JSON串中

如果字段类型是bool, string, int, int64等，而tag中带有",string"选项，那么这个字段在输出到JSON的时候会把该字段对应的值转换成JSON字符串

实例代码：

type Test11 struct {
  // 1. 字段的tag是"-"，那么这个字段不会输出到JSON
  Name string `json:"-"`
  // 2. 转换为字符串，再输出
  Age  int `json:",string"` // --- "Age": "12",
    //  Age  int `json:"Age"` // --- "Age": 12,
  // 3. Subjects 的值会进行二次JSON编码
  Sex string `json:"Sex"`
  // 4. 如果 Height 为空，则不输出到JSON串中 没有这个tag 会显示 Height:""
  Height string `json:"Height,omitempty"`
  // 5. tag中带有自定义名称，那么这个自定义名称会出现在JSON的字段名中
  Score int `json:"成绩"`
}
func main() {
  t1 := Test11{Name: "sb", Age:12,Sex:"男",Score: 98}
  b,_ := json.MarshalIndent(t1,"","\t")
  fmt.Println(string(b))
}

4. 通过map生成JSON

func main() {
  m:= map[string]string{"one":"你好","two":"我是","three":"汪汪队"}
    v,err :=json.MarshalIndent(m,"","\t")
    if err!=nil{
        fmt.Println(err)      //错误信息
    }else{
        fmt.Println(string(v))
    }
    // {
    //   "one": "你好",
    //   "three": "汪汪队",
    //   "two": "我是"
    // }
}

2. 解码JSON（解组|解封送：Unmarshaling）

Json Unmarshal：将json字符串解码到相应的数据结构。

func Unmarshal(data []byte, v interface{}) error
// data：想要json解码的[]byte类型数据
// v：将data Json解码到v（可以为结构体|map）里
// 实例代码
func main() {
  t1 := Test11{Name: "sb", Age:12,Sex:"男",Score: 98}
  val,_ := json.MarshalIndent(t1,"","\t")
  fmt.Println(string(val)) // 上回的json
    // {
    //   "Age": "12",
    //   "Sex": "男",
    //   "成绩": 98
    // }
  var a interface{}
  err := json.Unmarshal(val,&a)
  if err!=nil {
    fmt.Println(err)
  }
  fmt.Println(a) // map[Age:12 Sex:男 成绩:98]
  fmt.Printf("%T\n",a) // map[string]interface {}
}

Unmarshal (解组器) 解析JSON编码的数据并存储结果到 v指向的值中。

如果v为nil或不是指针，Unmarshal 返回InvalidUnmarshalError。

要将JSON解组到结构中，Unmarshal (解组) 匹配传入对象 Marshaling(编组) 处理使用的键的键（结构字段名或其标记），更喜欢精确匹配，但也接受不区分大小写的匹配。

通过默认情况下，没有相应结构字段的对象键是已忽略（也就是说你有的字段，就解析给你(如字段Age)；你没有的字段，就忽略(如字段Sex)；它没有的字段，你就为默认值(如字段S)）。

而且，你给的结构（例如结构体）如果字段已经被赋值了，是无法通过Unmarshal (解组) 去覆盖原值的。

例如：

type Test struct {
  Name string `json:"Name"`
  Age  int    `json:",string,age"`
  S    int    `json:"S"`
}
func main() {
    // 使用的Json编码val是上面代码里的
    // {
    //   "Age": "12",
    //   "Sex": "男",
    //   "成绩": 98
    // }
  var a Test
  _ := json.Unmarshal(val,&a)
  fmt.Printf("%#v\n",a) // main.Test{Name:"", Age:12, S:0}
  var b Test = Test{"12",12,2} // 如果解析到b里 
  _ := json.Unmarshal(val,&b)
  fmt.Printf("%#v\n",a) // main.Test{Name:"12", Age:12, S:2}可以看出来 已经赋值过的字段是不会被覆盖的。
}

要将JSON Unmarshal (解组) 为 interface value，Unmarshal (解组) 将其中一个存储在接口值中：

bool——用于JSON布尔值

float64——用于JSON数字

字符串——用于JSON字符串

[ ]interface{}——用于JSON数组

map[string]interface{}——用于JSON对象 (常用)

---->这就是为啥上面解析到空接口中，出来的却是map[string]interface

nil——表示JSON null

解组到切片Slice

要将JSON数组 Unmarshal (解组) 到切片中，解组将重置切片长度设置为零，然后将每个元素附加到切片。

作为一种特殊情况，要将空JSON数组解组到切片中，解组将使用新的空切片替换切片。

解组到数组Array

要将JSON数组解组为Go数组，解组解码JSON数组元素转换为相应的Go数组元素。

如果Go数组小于JSON数组，其他JSON数组元素将被丢弃。

如果JSON数组小于Go数组，附加的Go数组元素设置为零值。

解组到map

要将JSON对象解组到map中，Unmarshal (解组) 首先建立到的map使用。

如果map为nil，则Unmarshal (解组) 分配一个新map。

否则，就Unmarshal (解组) 重用现有map，保留现有条目（即保存你现在已经赋过的值）。

然后Unmarshal (解组) 存储从JSON对象到map的键值对。

map的键类型必须为可以是任何字符串类型，也可以是int，implement json.Unmarshaler。

源码中写的：
The map's key type must either be any string type, an integer, 
implement json.Unmarshaler,
or implement encoding.TextUnmarshaler.

如果JSON值不适合给定的目标类型，或者，如果JSON编号溢出了目标类型，则取消编组（Marshal）跳过该字段并尽可能完成Unmarshal (解组)。

如果没有遇到更严重的错误，则Unmarshal (解组)返回描述最早此类错误的Unmarshal (解组)类型错误。

空值解组

JSON空值Unmarshal (解组)为interface{}、map、指针或切片通过将Go值设置为nil。

因为null在JSON中经常用来表示`not present '，将JSON null解组到任何其他Go类型中都无效在该值上，不会产生任何错误。

Go语言——Json处理

□ JSON处理

1. 编码JSON （编组|封送 Marshaling）

1. Marhsal()

2. MarshalIndent

3. struct tag

4. 通过map生成JSON

2. 解码JSON（解组|解封送：Unmarshaling）

热门文章

最新文章

相关课程

相关电子书

相关实验场景