由标准库中的encoding/json包提供支持
package main
import (
"encoding/json"
"fmt"
"log"
)
type Movie struct {
Title string
Year int `json:"released"`
Color bool `json:"color,omitempty"`
Actors []string
}
var movies = []Movie{
{Title: "Casablanca", Year: 1942, Color: false,
Actors: []string{"Humphrey Bogart", "Ingrid Bergman"}},
{Title: "Cool Hand Luke", Year: 1967, Color: true,
Actors: []string{"Paul Newman"}},
{Title: "Bullitt", Year: 1968, Color: true,
Actors: []string{"Steve McQueen", "Jacqueline Bisset"}},
}
func main() {
data, err := json.Marshal(movies)
if err != nil {
log.Fatalf("JSON marshaling failed: %s", err)
}
fmt.Printf("%s
", data)
}
将一个Go语言中类似movies的结构体slice转为JSON的过程叫编组(marshaling)。编组通过调用json.Marshal函数完成,
Marshal函数返还一个编码后的字节slice,包含很长的字符串,并且没有空白缩进;我们将它
折行以便于显示:
[{"Title":"Casablanca","released":1942,"Actors":["Humphrey Bogart","Ingr
id Bergman"]},{"Title":"Cool Hand Luke","released":1967,"color":true,"Ac
tors":["Paul Newman"]},{"Title":"Bullitt","released":1968,"color":true,"
Actors":["Steve McQueen","Jacqueline Bisset"]}]
这种紧凑的表示形式虽然包含了全部的信息,但是很难阅读。为了生成便于阅读的格式,另
一个json.MarshalIndent函数将产生整齐缩进的输出。该函数有两个额外的字符串参数用于表
示每一行输出的前缀和每一个层级的缩进:
package main
import (
"encoding/json"
"fmt"
"log"
)
type Movie struct {
Title string
Year int `json:"released"`
Color bool `json:"color,omitempty"`
Actors []string
}
var movies = []Movie{
{Title: "Casablanca", Year: 1942, Color: false,
Actors: []string{"Humphrey Bogart", "Ingrid Bergman"}},
{Title: "Cool Hand Luke", Year: 1967, Color: true,
Actors: []string{"Paul Newman"}},
{Title: "Bullitt", Year: 1968, Color: true,
Actors: []string{"Steve McQueen", "Jacqueline Bisset"}},
}
func main() {
//data, err := json.Marshal(movies)
data, err := json.MarshalIndent(movies, "", " ")
if err != nil {
log.Fatalf("JSON marshaling failed: %s", err)
}
fmt.Printf("%s
", data)
}
结果输出:
[
{
"Title": "Casablanca",
"released": 1942,
"Actors": [
"Humphrey Bogart",
"Ingrid Bergman"
]
},
{
"Title": "Cool Hand Luke",
"released": 1967,
"color": true,
"Actors": [
"Paul Newman"
]
},
{
"Title": "Bullitt",
"released": 1968,
"color": true,
"Actors": [
"Steve McQueen",
"Jacqueline Bisset"
]
}
]
在编码时,默认使用Go语言结构体的成员名字作为JSON的对象,
只有导出的结构体成员才会被编码,这也就是我们为什么选择用大写字
母开头的成员名称
Year名字的成员在编码后变成了released,还有Color成员
编码后变成了小写字母开头的color。这是因为构体成员Tag所导致的。一个构体成员Tag是和
在编译阶段关联到该成员的元信息字符串:
Year int `json:"released"` Color bool `json:"color,omitempty"`
结构体的成员Tag可以是任意的字符串面值,但是通常是一系列用空格分隔的key:"value"键值
对序列;因为值中含义双引号字符,因此成员Tag一般用原生字符串面值的形式书写。json开
头键名对应的值用于控制encoding/json包的编码和解码的行为,并且encoding/...下面其它的
包也遵循这个约定。成员Tag中json对应值的第一部分用于指定JSON对象的名字,Color成员的Tag还带了一个额外
的omitempty选项,表示当Go语言结构体成员为空或零值时不生成JSON对象(这里false为零
值)。果然,Casablanca是一个黑白电影,并没有输出Color成员。
package main
import (
"encoding/json"
"fmt"
"log"
)
type Movie struct {
Title string
Year int `json:"released"`
Color bool `json:"color,omitempty"`
Actors []string
}
var movies = []Movie{
{Title: "Casablanca", Year: 1942, Color: false,
Actors: []string{"Humphrey Bogart", "Ingrid Bergman"}},
{Title: "Cool Hand Luke", Year: 1967, Color: true,
Actors: []string{"Paul Newman"}},
{Title: "Bullitt", Year: 1968, Color: true,
Actors: []string{"Steve McQueen", "Jacqueline Bisset"}},
}
func main() {
//data, err := json.Marshal(movies)
data, err := json.MarshalIndent(movies, "", " ")
if err != nil {
log.Fatalf("JSON marshaling failed: %s", err)
}
fmt.Printf("%s
", data)
var titles []struct{ Title string }
if err := json.Unmarshal(data, &titles); err != nil {
log.Fatalf("JSON unmarshaling failed: %s", err)
}
fmt.Println(titles) // "[{Casablanca} {Cool Hand Luke} {Bullitt}]"
}
编码的逆操作是解码,对应将JSON数据解码为Go语言的数据结构,Go语言中一般叫
unmarshaling,通过json.Unmarshal函数完成。下面的代码将JSON格式的电影数据解码为一
个结构体slice,结构体中只有Title成员。通过定义合适的Go语言数据结构,我们可以选择性
地解码JSON中感兴趣的成员。当Unmarshal函数调用返回,slice将被只含有Title信息值填
充,其它JSON成员将被忽略。