Golang Json

Json语法

JSON 语法规则

JSON 语法是 JavaScript 对象表示语法的子集。

• 数据在键值对中
• 数据由逗号分隔
• 花括号保存对象
• 方括号保存数组

JSON 名称/值对

JSON 数据的书写格式是：名称/值对。
名称/值对组合中的名称写在前面（在双引号中），值对写在后面(同样在双引号中)，中间用冒号隔开：

"firstName":"John"

这很容易理解，等价于这条 JavaScript 语句：

firstName="John"

JSON 值

JSON 值可以是：
-数字（整数或浮点数）
-字符串（在双引号中）
-逻辑值（true 或 false）
-数组（在方括号中）
-对象（在花括号中）
-null

基础结构

JSON 结构有两种结构：就是对象和数组两种结构，通过这两种结构可以表示各种复杂的结构。

对象

对象在js中表示为“{}”括起来的内容，数据结构为 {key：value,key：value,…}的键值对的结构，在面向对象的语言中，key为对象的属性，value为对应的属性值，所以很容易理解，取值方法为 对象.key 获取属性值，这个属性值的类型可以是 数字、字符串、数组、对象几种。

数组

数组在js中是中括号“[]”括起来的内容，数据结构为 [“java”,”javascript”,”vb”,…]，取值方式和所有语言中一样，使用索引获取，字段值的类型可以是 数字、字符串、数组、对象几种。

经过对象、数组2种结构就可以组合成复杂的数据结构了。

基础示例

名称 / 值对

按照最简单的形式，可以用下面这样的 JSON 表示”名称 / 值对”：

{"firstName":"Brett"}

这个示例非常基本，而且实际上比等效的纯文本”名称 / 值对”占用更多的空间：

firstName=Brett

但是，当将多个”名称 / 值对”串在一起时，JSON 就会体现出它的价值了。首先，可以创建包含多个”名称 / 值对”的 记录，比如：

{"firstName":"Brett","lastName":"McLaughlin","email":"aaaa"}

从语法方面来看，这与”名称 / 值对”相比并没有很大的优势，但是在这种情况下 JSON 更容易使用，而且可读性更好。例如，它明确地表示以上三个值都是同一记录的一部分；花括号使这些值有了某种联系。

表示数组

当需要表示一组值时，JSON 不但能够提高可读性，而且可以减少复杂性。例如，假设您希望表示一个人名列表。在XML中，需要许多开始标记和结束标记；如果使用典型的名称 / 值对，那么必须建立一种专有的数据格式，或者将键名称修改为 person1-firstName这样的形式。
如果使用 JSON，就只需将多个带花括号的记录分组在一起：

{
"people":[
    {"firstName":"Brett","lastName":"McLaughlin","email":"aaaa"},
    {"firstName":"Jason","lastName":"Hunter","email":"bbbb"},
    {"firstName":"Elliotte","lastName":"Harold","email":"cccc"}
]

}
在这个示例中，只有一个名为 people的变量，值是包含三个条目的数组，每个条目是一个人的记录，其中包含名、姓和电子邮件地址。上面的示例演示如何用括号将记录组合成一个值。当然，可以使用相同的语法表示多个值（每个值包含多个记录）：

{
"programmers": [{
    "firstName": "Brett",
    "lastName": "McLaughlin",
    "email": "aaaa"
}, {
    "firstName": "Jason",
    "lastName": "Hunter",
    "email": "bbbb"
}, {
    "firstName": "Elliotte",
    "lastName": "Harold",
    "email": "cccc"
}],
"authors": [{
    "firstName": "Isaac",
    "lastName": "Asimov",
    "genre": "sciencefiction"
}, {
    "firstName": "Tad",
    "lastName": "Williams",
    "genre": "fantasy"
}, {
    "firstName": "Frank",
    "lastName": "Peretti",
    "genre": "christianfiction"
}],
"musicians": [{
    "firstName": "Eric",
    "lastName": "Clapton",
    "instrument": "guitar"
}, {
    "firstName": "Sergei",
    "lastName": "Rachmaninoff",
    "instrument": "piano"
}]
}

这里最值得注意的是，能够表示多个值，每个值进而包含多个值。但是还应该注意，在不同的主条目（programmers、authors 和 musicians）之间，记录中实际的名称 / 值对可以不一样。JSON 是完全动态的，允许在 JSON 结构的中间改变表示数据的方式。
在处理 JSON 格式的数据时，没有需要遵守的预定义的约束。所以，在同样的数据结构中，可以改变表示数据的方式，甚至可以以不同方式表示同一事物。

golang json

Go语言的JSON 库

　　Go语言自带的JSON转换库为 encoding/json

1.其中把对象转换为JSON的方法（函数）为 json.Marshal()，其函数原型如下

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

　　　　也就是说，这个函数接收任意类型的数据 v，并转换为字节数组类型，返回值就是我们想要的JSON数据和一个错误代码。当转换成功的时候，这个错误代码为nil

　　　　在进行对象转换为 JSON 的过程中，会遵循如下几条规则：

　　　　• 布尔型转换为 JSON 后仍是布尔型　， 如true -> true

　　　　• 浮点型和整数型转换后为JSON里面的常规数字，如 1.23 -> 1.23

　　　　• 字符串将以UTF-8编码转化输出为Unicode字符集的字符串，特殊字符比如<将会被转义为\u003c

　　　　• 数组和切片被转换为JSON 里面的数组，[]byte类会被转换为base64编码后的字符串，slice的零值被转换为null

　　　　• 结构体会转化为JSON对象，并且只有结构体里边以大写字母开头的可被导出的字段才会被转化输出，而这些可导出的字段会作为JSON对象的字符串索引

　　　　• 转化一个map 类型的数据结构时，该数据的类型必须是 map[string]T（T 可以是encoding/json 包支持的任意数据类型）

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() 将会遵循如下顺序进行查找匹配

　　　　　　§ 一个包含Foo 标签的字段

　　　　　　§ 一个名为Foo 的字段

　　　　　　§ 一个名为Foo 或者Foo 或者除了首字母其他字母不区分大小写的名为Foo 的字段。 这些字段在类型声明中必须都是以大写字母开头、可被导出的字段。

　　　　注意：如果JSON中的字段在Go目标类型中不存在，json.Unmarshal() 函数在解码过程中会丢弃该字段。

　　　　• 当JSON 的结构是未知的时候，会遵循如下规则：

　　　　　　§ JSON中的布尔值将会转换为Go中的bool类型

　　　　　　§ 数值会被转换为Go中的float64类型

　　　　　　§ 字符串转换后还是string类型

　　　　　　§ JSON数组会转换为[]interface{} 类型

　　　　　　§ JSON对象会转换为map[string]interface{}类型

　　　　　　§ null值会转换为nil