Go语言内建对JSON的支持。使用Go语言内置的encoding/json标准库,开发者可以轻松使用Go程序生成和解析JSON格式的数据。在Go语言实现JSON的编码和解码时,遵循RFC4627协议标准。

编码为JSON格式

使用json.Marshal()函数可以对一组数据进行JSON格式的编码。json.Marshal()函数的声明如下:
Go语言之JSON处理 - 图1

假如有如下一个Book类型的结构体:
Go语言之JSON处理 - 图2

并且有如下一个Book类型的实例对象:
Go语言之JSON处理 - 图3
然后,我们可以使用json.Marshal()函数将gobook实例生成一段JSON格式的文本:
Go语言之JSON处理 - 图4

如果编码成功,err将赋于零值nil,变量b将会是一个进行JSON格式化后的[]byte类型:
Go语言之JSON处理 - 图5

当我们调用json.Marshal(gobook)语句时,会递归遍历gobool对象,如果发现gobook这个数据结构实现了json.Marshaler接口且包含有效的值,Marshal()就会调用其MarshalJSON()方法将该数据结构生成JSON格式的文本。
Go语言的大多数数据类型都可以转化为有效的JSON文本,但channel、complex和函数这几种类型除外。
如果转化前的数据结构中出现指针,那么将会转换指针所指的值,如果指针指向的是零值,那么nill将作为转化后的结果输出。

在Go中,JSON转换前后的数据类型映射如下:

  • 布尔值转换为JSON后还是布尔类型。

  • 浮点数和整数会被转换为JSON里面的常规数字。

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

  • 数组和切片会转换为JSON里面的数组,但[]btye类型的值将被转换为Base64编码后的字符串,slice类型额零值会被转换为null。

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

  • ·转换一个map类型的数据结构时,该数据的类型必须是map[string]T(T可以是encoding/json包支持的任意数据类型)。

解码JSON数据

可以使用json.Unmarshal()函数将JSON格式的文本解码为Go里面预期的数据结构。json.Unmarshal()函数的原型如下:
Go语言之JSON处理 - 图6
该函数的第一次参数是输入,即JSON格式的文本(比特序列),第二个参数表示目标输出容器,用于存放解码后的值。

要解码一段JSON数据,首先需要在Go中创建一个目标类型的实例对象,用于存放解码后的值:

  1. var book BOOK

然后调用json.Unmarshal()函数,将[]byte类型的JSON数据作为第一个参数传入,将book实例变量的指针作为第二个参数传入:

  1. err := json.Unmarshal(b, &book)

如果b是一个有效的JSON数据并能和book结构对应起来,那么JSON解码后的值将会一一存放到book结构体中。解码成功后的book数据如下:
Go语言之JSON处理 - 图7
json.Unmarshal()函数会根据一个约定的顺序查找目标结构中的字段,如果找到一个即发生匹配。假设一个JSON对象有个名为”Foo”的索引,要将”Foo”所对应的值填充到目标结构体的目标字段上,json.Unmarshal()将会遵循如下顺序进行查找匹配:
(1)一个包含Foo标签的字段;
(2)一个名为Foo的字段;
(3)一个名为Foo或者除了首字母其他字母不区分大小的命名为Foo的字段。

这些字段在类型声明中必须都是以大写字母开头、可被导出的字段。
如果JSON中的字段在Go目标类型中不存在,json.Unmarshal()函数在解码过程中会丢弃该字段。

解码未知结构的JSON数据

Go内建了灵活的类型系统,向我们传达了一个很有价值的信息:空接口是通用类型。如果要解码一段未知结构的JSON,只需将这段JSON数据解码输出到一个空接口即可。在解码JSON数据的过程中,JSON数据里面的元素类型将做如下转换:

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

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

  • 字符串转换后还是string类型;

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

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

  • null值会被转换为nil.

在Go的标准库encoding/json包中,允许使用map[string] interface{}和[]interface{}类型的值来分别存放未知结构的JSON对象或数组,实例代码如下:
Go语言之JSON处理 - 图8

在上述代码中,r被定义为一个空接口。json.Unmarshal()函数将一个JSON对象解码到空接口r中,最终r将会是一个键值对的map[string] interface{}结构:
Go语言之JSON处理 - 图9
要访问解码后的数据结构,需要先判断目标结构是否为预期的数据类型:
Go语言之JSON处理 - 图10

然后,我们可以通过for循环搭配range语句一一访问解码后的目标数据:
Go语言之JSON处理 - 图11

JSON的流式读写

Go内建的encoding/json包还提供Decoder和Encoder两个类型,用于支持JSON数据的流式,并提供NewDecoder()和NewEncoder()两个函数来便于具体实现:
Go语言之JSON处理 - 图12
Go语言之JSON处理 - 图13
使用Decoder 和Encoder对数据流进行处理可以应用得更为广泛些,比如读写 HTTP 连接、WebSocket或文件等, Go的标准库net/rpc/jsonrpc就是一个应用了Decoder和Encoder的实际例子。