如何控制Go编码JSON数据时的行为

今天来聊一下我在Go中对数据进行 JSON 编码时遇到次数最多的三个问题以及解决方法，你们来看看是否是也为这些问题挠掉了很多头发。

自定义JSON键名

这个问题加到文章里我是有所犹豫的，由于基本上你们都会，不过属于同类问题我仍是放进来了，对新接触 Go 的同窗更友好些。

咱们先从最多见的一个问题说，首先在Go 程序中要将数据编码成JSON 格式时一般咱们会先定义结构体类型，将数据存放到结构体变量中。

type Address struct {
    Type    string
    City    string  
    Country string
}

type CreditCard struct {
    FirstName string
    LastName  string
    Addresses []*Address
    Remark    string
}

home := &Address{"private", "Aartselaar", "Belgium"}
office := &Address{"work", "Boom", "Belgium"}
card := VCard{"Jan", "Kersschot", []*Address{home, office}, "none"}

js, err := json.Marshal(card)
fmt.Printf("JSON format: %s", js)

只有导出的结构体成员才会被编码，这也就是咱们为何选择用大写字母开头的字段名称。在编码时，默认使用结构体字段的名字做为JSON对象中的key，可是通常JSON 是给HTTP接口返回数据使用的，在接口的规范里针对数据咱们通常都要求返回snake case风格的字段名。解决这个问题的方法是在结构体声明时在结构体字段标签里能够自定义对应的JSON key

因此咱们把结构体声明改成以下便可：

type Address struct {
    Type    string  `json:"type"`
    City    string  `json:"city"`
    Country string  `json:"country"`
}

编码JSON时忽略掉指定字段

并非全部数据咱们都指望编码到JSON中暴露给外部接口的，因此针对一些敏感的字段咱们每每但愿将其从编码后的JSON数据中忽略掉。那么上面也说了只有导出的结构体成员才会被编码，有的同窗会问我直接用小写的字段名不行吗？但是未导出字段只能在包内访问，像这种携带内部敏感数据的每每都是应用的基础数据，由项目的公共包来提供的。那么怎么既能维持字段的导出性又能让其在JSON数据中被忽略掉呢? 仍是使用结构体的标签进行注解，好比下面定义的结构体，能够把身份证IdCard字段在JSON数据中去掉：

type User struct {
    Name    string  `json:"name"`
    Age     Int     `json:"int"`
    IdCard  string  `json:"-"`
}

encoding/json的源码中和文档中都列举了经过结构体字段标签控制数据JSON编码行为的说明：

// Field is ignored by this package.
Field int `json:"-"`

// Field appears in JSON as key "myName".
Field int `json:"myName"`

// Field appears in JSON as key "myName" and
// the field is omitted from the object if its value is empty,
// as defined above.
Field int `json:"myName,omitempty"`

// Field appears in JSON as key "Field" (the default), but
// the field is skipped if empty.
// Note the leading comma.
Field int `json:",omitempty"`

omitempty这个是字段的数据为空时，在JSON中省略这个字段。为的是节省数据空间，Protobuf编译器生成的结构体代码中每一个字段标签中都有omitempty。可是在Api开发中这个不经常使用，由于字段不固定对前端很不友好。

对Protobuf不了解的能够看我以前写的文章《Protobuf语言指南》。

结构体字段标签的json注解中都不加omitempty后还遇到一种状况，就是数据类型为切片的字段在数据为空的时候会被JSON编码为null而不是[]。这个前端常常会问我没数据的时候能不能不要返回null，每回还要多写一个判断。个人说辞都是不能，其实规范点讲是应该返回[]的知识我是我本身没找到到解决方法。做为一个在写代码上有强迫症的人，这个问题仍是想搞明白的，好在有一天在StackOverflow上看到一个答案，才发现是编码的疏忽致使的。

解决空切片在JSON里被编码成null

由于切片的零值为nil，无指向内存的地址，因此当以这种形式定义var f []int初始化slice后，在JSON中将其编码为null，若是想在 JSON 中将空 slice 编码为[]则需用make初始化 slice为其分配内存地址：

运行下面的例子能够看出两点的区别：

package main

import (
    "encoding/json"
    "fmt"
)

type Person struct {
    Friends []string
}

func main() {
    var f1 []string
    f2 := make([]string, 0)

    json1, _ := json.Marshal(Person{f1})
    json2, _ := json.Marshal(Person{f2})

    fmt.Printf("%s\n", json1)
    fmt.Printf("%s\n", json2)
}

输出：

{"Friends":null}
{"Friends":[]}

其实致使这个问题的缘由是Go的append函数（甩锅），咱们都知道引用类型的变量定义后若是没初始化他们的值是nil，无指向内存的地址，是没法直接使用的。可是append函数在给切片追加元素时会判断切片是否已初始化，没有的话会帮其初始化分配底层数组。个人习惯是先声明切片，而后再在下面的循环代码中向切片追加元素。可是若是循环没有执行，好比你从数据库没查出数据，就会致使对应切片字段在无数据时返回的是nil而后被JSON编码成了null。因此这个算是一个经验总结出来的Tip吧在写代码时你们必定要注意了。

这就是我在开发时把数据编码成JSON格式时遇到的三个问题和相应的解决方法。加上以前写的解析JSON的文章，两个文章加起来差很少就能汇总平常开发中关于encoding/json库使用的各类问题了。

扫码下方二维码关注公众号第一时间获取有价值的技术原创文章。