Go 示例: JSON

Go 提供了对 JSON 编码和解码的内置支持,包括从内置类型和自定义数据类型进行编码和解码。

package main
import (
    "encoding/json"
    "fmt"
    "os"
)

我们将使用这两个结构体来演示下面自定义类型的编码和解码。

type response1 struct {
    Page   int
    Fruits []string
}

只有导出的字段才会在 JSON 中进行编码/解码。字段必须以大写字母开头才能被导出。

type response2 struct {
    Page   int      `json:"page"`
    Fruits []string `json:"fruits"`
}
func main() {

首先,我们将看看如何将基本数据类型编码为 JSON 字符串。以下是一些原子值的示例。

    bolB, _ := json.Marshal(true)
    fmt.Println(string(bolB))
    intB, _ := json.Marshal(1)
    fmt.Println(string(intB))
    fltB, _ := json.Marshal(2.34)
    fmt.Println(string(fltB))
    strB, _ := json.Marshal("gopher")
    fmt.Println(string(strB))

以下是一些切片和映射的示例,它们将按预期编码为 JSON 数组和对象。

    slcD := []string{"apple", "peach", "pear"}
    slcB, _ := json.Marshal(slcD)
    fmt.Println(string(slcB))
    mapD := map[string]int{"apple": 5, "lettuce": 7}
    mapB, _ := json.Marshal(mapD)
    fmt.Println(string(mapB))

JSON 包可以自动编码您的自定义数据类型。它只会在编码输出中包含导出的字段,并且默认情况下会使用这些名称作为 JSON 密钥。

    res1D := &response1{
        Page:   1,
        Fruits: []string{"apple", "peach", "pear"}}
    res1B, _ := json.Marshal(res1D)
    fmt.Println(string(res1B))

您可以在结构体字段声明中使用标签来自定义编码后的 JSON 密钥名称。查看上面的 response2 的定义,以查看此类标签的示例。

    res2D := &response2{
        Page:   1,
        Fruits: []string{"apple", "peach", "pear"}}
    res2B, _ := json.Marshal(res2D)
    fmt.Println(string(res2B))

现在让我们看看如何将 JSON 数据解码为 Go 值。以下是一个通用数据结构的示例。

    byt := []byte(`{"num":6.13,"strs":["a","b"]}`)

我们需要提供一个变量,以便 JSON 包可以将解码后的数据放入其中。这个 map[string]interface{} 将保存一个字符串到任意数据类型的映射。

    var dat map[string]interface{}

以下是实际的解码过程,以及对相关错误的检查。

    if err := json.Unmarshal(byt, &dat); err != nil {
        panic(err)
    }
    fmt.Println(dat)

为了在解码后的映射中使用这些值,我们需要将它们转换为相应的类型。例如,这里我们将 num 中的值转换为预期的 float64 类型。

    num := dat["num"].(float64)
    fmt.Println(num)

访问嵌套数据需要一系列转换。

    strs := dat["strs"].([]interface{})
    str1 := strs[0].(string)
    fmt.Println(str1)

我们还可以将 JSON 解码为自定义数据类型。这样做的好处是为我们的程序添加额外的类型安全性,并消除在访问解码后的数据时进行类型断言的需要。

    str := `{"page": 1, "fruits": ["apple", "peach"]}`
    res := response2{}
    json.Unmarshal([]byte(str), &res)
    fmt.Println(res)
    fmt.Println(res.Fruits[0])

在上面的示例中,我们始终使用字节和字符串作为标准输出上的数据和 JSON 表示之间的中间体。我们还可以将 JSON 编码直接流式传输到 os.Writer,例如 os.Stdout,甚至 HTTP 响应体。

    enc := json.NewEncoder(os.Stdout)
    d := map[string]int{"apple": 5, "lettuce": 7}
    enc.Encode(d)
}
$ go run json.go
true
1
2.34
"gopher"
["apple","peach","pear"]
{"apple":5,"lettuce":7}
{"Page":1,"Fruits":["apple","peach","pear"]}
{"page":1,"fruits":["apple","peach","pear"]}
map[num:6.13 strs:[a b]]
6.13
a
{1 [apple peach]}
apple
{"apple":5,"lettuce":7}

我们在这里介绍了 Go 中 JSON 的基本知识,但请查看 JSON 和 Go 博客文章和 JSON 包文档 以了解更多信息。

下一个示例:XML.