<h2>简介</h2>    <p>JSON （JavaScript Object Notation） 是一种轻量级的数据交换格式，因为易读性、机器容易处理而变得流行。</p>    <p>JSON 语言定义的内容非常简洁，主要分为三种类型：对象（object）、数组（array）和基本类型（value）。基本类型（value）包括：</p>    <ul>     <li>string 字符串，双引号括起来的 unciode 字符序列</li>     <li>number 数字，可以是整数，也可以是浮点数，但是不支持八进制和十六进制表示的数字</li>     <li>true，false 真值和假值，一般对应语言中的 bool 类型</li>     <li>null 空值，对应于语言中的空指针等</li>    </ul>    <p>数组（array）就是方括号括 [] 起来的任意值的序列，中间以逗号 , 隔开。对象（object）是一系列无序的键值组合， <strong>键必须是字符串</strong> ，键值对之间以逗号 , 隔开，键和值以冒号 : 隔开。数组和对象中的值都可以是嵌套的。</p>    <p>JSON 官网 有非常易懂的图示，进一步了解可以移步。</p>    <p>JSON 不依赖于任何具体的语言，但是和大多数 C 家族的编程语言数据结构特别相似，所以 JSON 成了多语言之间数据交换的流行格式。Go 语言也不例外，标准库 encoding/json 就是专门处理 JSON 转换的。</p>    <p>这篇文章就专门介绍 Go 语言中怎么和 JSON 打交道，常用的模式以及需要注意的事项。</p>    <h2>使用</h2>    <p>Golang 的 encoding/json 库已经提供了很好的封装，可以让我们很方便地进行 JSON 数据的转换。</p>    <p>Go 语言中数据结构和 JSON 类型的对应关系如下表：</p>    <table>     <thead>      <tr>       <th>golang 类型</th>       <th>JSON 类型</th>       <th>注意事项</th>      </tr>     </thead>     <tbody>      <tr>       <td>bool</td>       <td>JSON booleans</td>       <td> </td>      </tr>      <tr>       <td>浮点数、整数</td>       <td>JSON numbers</td>       <td> </td>      </tr>      <tr>       <td>字符串</td>       <td>JSON strings</td>       <td>字符串会转换成 UTF-8 进行输出，无法转换的会打印对应的 unicode 值。而且为了防止浏览器把 json 输出当做 html， “<”、”>” 以及 “&” 会被转义为 “\u003c”、”\u003e” 和 “\u0026”。</td>      </tr>      <tr>       <td>array，slice</td>       <td>JSON arrays</td>       <td>[]byte 会被转换为 base64 字符串，nil slice 会被转换为 JSON null</td>      </tr>      <tr>       <td>struct</td>       <td>JSON objects</td>       <td>只有导出的字段（以大写字母开头）才会在输出中</td>      </tr>     </tbody>    </table>    <p>NOTE：Go 语言中一些特殊的类型，比如 Channel、complex、function 是不能被解析成 JSON 的。</p>    <h3>Encode 和 Decode</h3>    <p>要把 golang 的数据结构转换成 JSON 字符串（encode），可以使用 Marshal 函数：</p>    <pre>  <code class="language-go">func Marshal(v interface{}) ([]byte, error)</code></pre>    <p>比如我们有结构体 User</p>    <pre>  <code class="language-go">type User struct {      Name string      IsAdmin bool      Followers uint  }</code></pre>    <p>以及一个实例：</p>    <pre>  <code class="language-go">user := User{    Name:      "cizixs",    IsAdmin:   true,    Followers: 36,   }  data, err := json.Marshal(user)</code></pre>    <p>那么 data 就是 []byte 类型的数组，里面包含了解析为 JSON 之后的数据：</p>    <pre>  <code class="language-go">data == []byte(`{"Name":"cizixs","IsAdmin":true,"Followers":36}`)</code></pre>    <p>相对应的，要把 JSON 数据转换成 Go 类型的值（Decode）， 可以使用 json.Unmarshal 。它的定义是这样的：</p>    <pre>  <code class="language-go">func Unmarshal(data []byte, v interface{}) error</code></pre>    <p>data 中存放的是 JSON 值，v 会存放解析后的数据，所以必须是指针，可以保证函数中做的修改能保存下来。</p>    <p>下面看个例子：</p>    <pre>  <code class="language-go">data = []byte(`{"Name":"gopher","IsAdmin":false,"Followers":8900}`)  var newUser = new(User)  err = json.Unmarshal(data, &newUser)  if err != nil {   fmt.Errorf("Can not decode data: %v\n", err)  }  fmt.Printf("%v\n", newUser)</code></pre>    <p>那么 Unmarshal 是怎么找到结构体中对应的值呢？比如给定一个 JSON key Filed ，它是这样查找的：</p>    <ul>     <li>首先查找 tag 名字（关于 JSON tag 的解释参看下一节）为 Field 的字段</li>     <li>然后查找名字为 Field 的字段</li>     <li>最后再找名字为 FiElD 等大小写不敏感的匹配字段。</li>     <li>如果都没有找到，就直接忽略这个 key，也不会报错。这对于要从众多数据中只选择部分来使用非常方便。</li>    </ul>    <h3>更多控制：Tag</h3>    <p>在定义 struct 字段的时候，可以在字段后面添加 tag，来控制 encode/decode 的过程：是否要 decode/encode 某个字段，JSON 中的字段名称是什么。</p>    <p>可以选择的控制字段有三种：</p>    <ul>     <li>- ：不要解析这个字段</li>     <li>omitempty ：当字段为空（默认值）时，不要解析这个字段。比如 false、0、nil、长度为 0 的 array，map，slice，string</li>     <li>FieldName ：当解析 json 的时候，使用这个名字</li>    </ul>    <p>举例来说吧：</p>    <pre>  <code class="language-go">// 解析的时候忽略该字段。默认情况下会解析这个字段，因为它是大写字母开头的  Field int   `json:"-"`    // 解析（encode/decode） 的时候，使用 `other_name`，而不是 `Field`  Field int   `json:"other_name"`    // 解析的时候使用 `other_name`，如果struct 中这个值为空，就忽略它  Field int   `json:"other_name,omitempty"`</code></pre>    <h3>解析动态内容: interface{}</h3>    <p>上面的解析过程有一个假设——你要事先知道要解析的 JSON 内容格式，然后定义好对应的数据结构。如果你不知道要解析的内容呢？ Go 提供了 interface{} 的格式，这个接口没有限定任何的方法，因此所有的类型都是满足这个接口的。在解析 JSON 的时候，任意动态的内容都可以解析成 interface{} 。</p>    <p>比如还是上面的数据，我们可以这样做：</p>    <pre>  <code class="language-go">data := []byte(`{"Name":"cizixs","IsAdmin":true,"Followers":36}`)    var f interface{}  json.Unmarshal(data, &f)</code></pre>    <p>但是要使用 f ，还是很麻烦的，我们要使用 type assertion ：</p>    <pre>  <code class="language-go">name := f.(map[string]interface{})["Name"].(string)</code></pre>    <p>对于比较复杂的结构，这样的访问很麻烦，也很容易出错。</p>    <p>如果已经知道 JSON 数据是对象，而不是基本类型（bool，number，string，array）等，因为 JSON 对象键都是字符串，所以可以把上面的例子修改为：</p>    <pre>  <code class="language-go">var f map[string]interface{}    // 省去了上面 f 的 type assertion 步骤  name := f["Name"].(string)</code></pre>    <p>需要注意的是，尽管 Followers 字段没有小数点，我们希望它是整数值，解析的时候它还是会被解析成 float64 ，如果直接把它当做 int 访问，会出现错误：</p>    <pre>  <code class="language-go">followers := f["Followers"].(int)    // panic: interface conversion: interface is float64, not int</code></pre>    <p>而必须自己做类型转换：</p>    <pre>  <code class="language-go">followers := int(f["Followers"].(float64))</code></pre>    <h3>延迟解析：json.RawMessage</h3>    <p>在解析的时候，还可以把某部分先保留为 JSON 数据不要解析，等到后面得到更多信息的时候再去解析。继续拿 User 举例，比如我们要添加认证的信息，认证可以是用户名和密码，也可以是 token 认证。</p>    <pre>  <code class="language-go">type BasicAuth struct {      Email string      Password string  }    type TokenAuth struct {      Token string  }    type User struct {      Name string      IsAdmin bool      Followers uint      Auth json.RawMessage  }</code></pre>    <p>我们在定义 User 结构体的时候，把认证字段的类型定义为 json.RawMessage ，这样解析 JSON 数据的时候，对应的字段会先不急着转换成 Go 数据结构。然后我们可以自己去再次调用 Unmarshal 去读取里面的值：</p>    <pre>  <code class="language-go">err := json.Unmarshal(data, &basicAuth)  if basicAuth.Email != "" {      // 这是用户名/密码认证方式，在这里继续做一些处理  } else {      json.Unmarshal(data, &tokenAuth)      if tokenAuth.Token != "" {          // 这是 token 认证方法      }  }</code></pre>    <h3>自定义解析方法</h3>    <p>如果希望自己控制怎么解析成 JSON，或者把 JSON 解析成自定义的类型，只需要实现对应的接口（interface）。 encoding/json 提供了两个接口： Marshaler 和 Unmarshaler ：</p>    <pre>  <code class="language-go">// Marshaler 接口定义了怎么把某个类型 encode 成 JSON 数据  type Marshaler interface {          MarshalJSON() ([]byte, error)  }    // Unmarshaler 接口定义了怎么把 JSON 数据 decode 成特定的类型数据。如果后续还要使用 JSON 数据，必须把数据拷贝一份  type Unmarshaler interface {          UnmarshalJSON([]byte) error  }</code></pre>    <p>标准库 time.Time 就实现了这两个接口。另外一个简单的例子（这个例子来自于参考资料中 Go and JSON 文章）：</p>    <pre>  <code class="language-go">type Month struct {      MonthNumber int      YearNumber int  }    func (m Month) MarshalJSON() ([]byte, error){      return []byte(fmt.Sprintf("%d/%d", m.MonthNumber, m.YearNumber)), nil  }    func (m *Month) UnmarshalJSON(value []byte) error {      parts := strings.Split(string(value), "/")      m.MonthNumber = strconv.ParseInt(parts[0], 10, 32)      m.YearNumber = strconv.ParseInt(parts[1], 10, 32)        return nil  }</code></pre>    <h3>和 stream 中 JSON 打交道</h3>    <p>上面所有的 JSON 数据来源都是预先定义的 []byte 缓存，在很多时候，如果能读取/写入其他地方的数据就好了。 encoding/json 库中有两个专门处理这个事情的结构： Decoder 和 Encoder ：</p>    <pre>  <code class="language-go">// Decoder 从 r io.Reader 中读取数据，`Decode(v interface{})` 方法把数据转换成对应的数据结构  func NewDecoder(r io.Reader) *Decoder    // Encoder 的 `Encode(v interface{})` 把数据结构转换成对应的 JSON 数据，然后写入到 w io.Writer 中  func NewEncoder(w io.Writer) *Encoder</code></pre>    <p>下面的例子就是从标准输入流中读取数据，解析成数据结构，删除所有键不是 Name 的字段，然后再 encode 成 JSON 数据，打印到标准输出。</p>    <pre>  <code class="language-go">package main    import (      "encoding/json"      "log"      "os"  )    func main() {      dec := json.NewDecoder(os.Stdin)      enc := json.NewEncoder(os.Stdout)      for {          var v map[string]interface{}          if err := dec.Decode(&v); err != nil {              log.Println(err)              return          }          for k := range v {              if k != "Name" {                  delete(v, k)              }          }          if err := enc.Encode(&v); err != nil {              log.Println(err)          }      }  }</code></pre>    <h2>参考资料</h2>    <ul>     <li><a href="/misc/goto?guid=4959730437057275697" rel="nofollow,noindex">Go Blog: JSON and Go</a></li>     <li><a href="/misc/goto?guid=4959730437146774849" rel="nofollow,noindex">Dynamic JSON in Go</a></li>     <li><a href="/misc/goto?guid=4959730437239539768" rel="nofollow,noindex">Go and JSON</a></li>    </ul>    <p> </p>    <p>来自：http://cizixs.com/2016/12/19/golang-json-guide</p>    <p> </p>