golang json编码

数据的json编码主要涉及两个方法调用:

1.Marshal方法

该方法返回参数v的json编码

func Marshal(v interface{}) ([]byte, error) {
    e := newEncodeState()

    err := e.marshal(v, encOpts{escapeHTML: true})
    if err != nil {
        return nil, err
    }
    buf := append([]byte(nil), e.Bytes()...)

    e.Reset()
    encodeStatePool.Put(e)

    return buf, nil
}

该方法可以接受任意类型的参数,并将其转化为字节序列,如果遇到的值实现了Marshaler接口,并且不是一个空指针,Marshal方法就会调用其上的MarshalJSON方法来产生JSON对象。如果没有MarshalJSON方法,但是它实现了encoding.TextMarshaler,Marshal调用marshalText方法,并将结果编码为JSON字符串。否则,Marshal方法使用以下的依赖于类型的默认编码;

  • boolean值编码为JSON的boolean值
  • 浮点数,整型,Number类型的值编码为JSON的number值
  • 字符串类型编码为有效的UTF-8编码的JSON字符串值,使用rune类型替换无效的字节,尖括号<、>变为"\u003c","\u003e",以防止某些浏览器将JSON输出错误的解释为HTML."&"变成"\u0026"也是同样的原因。可以通过SetEscapeHTML(false)来禁止此转义。
  • 数组和切片类型编码为JSON数组,除了[]byte字节数组编码为bash64的字符串。nil的切片会编码为null的JSON值。
var a []int = []int{1, 2, 3, 4, 6}
    sliceJSON, err := json.Marshal(a)
    fmt.Println(string(sliceJSON)) //[1,2,3,4,6]
  • 结构体编码为JSON对象。每一个导出的结构体字段变成JSON对象的成员,使用字段名作为JSON对象的一个key.除非字段以以下的方式被省略了:
    每个字段的编码可以通过结构体的字段标签来定制。标签可以给出字段的名称,也可以为空, 来使用默认的字段名。omitempty可选项指定字符如果为空值,在编码的时候,需要忽略,以下值可以定义为空值:false,0,nil指针,nil接口,空数组,空字符串,空字典,空切片。特别的,如果字段标签为"-"",字段将在编时被忽略,如果标签为"-,"",编码后,出现在JSON对象中时,字段名将为-。
  • "string"字符串标签标示字段将被编码为JSON字符串,该标签仅在字段类型为字符串,浮点数,整数,布尔类型时,使用。
  • 指针类型的值编码为指针指向的值,空指针将被编码为null值。
  • 接口类型的值将被编码为接口中包含的值,空的接口值将被编码为null值。
  • channel,complex,函数类型的值不能被编码,试图编码将报错。
  • 循环引用的数据Marshal将不处理它们,传入一个循环结构的数据到Marshal中将导致一个无线循环。
package main

import (
    "encoding/json"
    "fmt"
    "reflect"
)

type User struct {
    Name  string `json:"user_name"`
    Age   int    `json:"user_age"`
    Addr  string `json:"address,omitempty"`
    Email string `json:",omitempty"`
    *IphoneInfo
}

type IphoneInfo struct {
    Id     int64       `json:"iphone_id"`
    Name   string      `json:"iphone_name"`
    IpAddr interface{} `json:"iphone_ip_addr"`
    IphoneType
}

type IphoneType struct {
    IphoneNumber string `json:"iphone_number"`
    Is5GIphone   bool   `json:"is_5g"`
}

func main() {
    var user User = User{
        Name: "yechongqiu",
        Age:  18,
        Addr: "Nanjiing",
        // Email: "yechongqiu@sunning.com",
    }
    fmt.Println(reflect.ValueOf(user) == reflect.ValueOf(&user))
    fmt.Println(reflect.ValueOf(&user))
    jsonUser, err := json.Marshal(&user)
    if err != nil {
        return
    }
    fmt.Println(string(jsonUser))
    var a []int = []int{1, 2, 3, 4, 6}
    sliceJSON, err := json.Marshal(a)
    fmt.Println(string(sliceJSON))

    iphoneInfo := &IphoneInfo{
        Id:     100001,
        Name:   "iphone 8",
        IpAddr: "192.168.10.101",
    }
    user.IphoneInfo = iphoneInfo
    jsonUser2, err := json.Marshal(user)
    if err != nil {
        return
    }
    fmt.Println(string(jsonUser2))
}

Output:

false
&{yechongqiu 18 Nanjiing  <nil>}
{"user_name":"yechongqiu","user_age":18,"address":"Nanjiing"}
[1,2,3,4,6]
{"user_name":"yechongqiu","user_age":18,"address":"Nanjiing","iphone_id":100001,"iphone_name":"iphone 8","iphone_ip_addr":"192.168.10.101","iphone_number":"","is_5g":false}

Unmarshal

将JSON对象解码为结构体数据,方法的参数为:

  • 需要解码的JSON对象的字节序列
  • 将JOSN对象解码到的结构体,一般为指针。
func Unmarshal(data []byte, v interface{}) error {
    // Check for well-formedness.
    // Avoids filling out half a data structure
    // before discovering a JSON syntax error.
    var d decodeState
    err := checkValid(data, &d.scan)
    if err != nil {
        return err
    }

    d.init(data)
    return d.unmarshal(v)
}

如果第二个参数为空,或者不是一个指针,将返回一个错误。Unmarshal使用Marshal相反的编码。使用以下附加规则:

为了解码JSON到一个实现了Unmarshaler接口的值,Unmarshal方法调用值的UnmarshalJSON方法。包含输入为JSON null的情况。否则,如果值实现了encoding.TextUnmarshaler接口,Unmarshal方法将调用值的该方法。

为了解码一个JOSN到一个结构体,Unmarshal匹配输入类型的key到Marshal时使用的key.

解码JSON到一个接口值时,将如下的值保存到接口中去:

  • json boolean -> bool
  • json number -> float64
  • json string -> string
  • json arrays -> []interface{}
  • json objects -> map[string]interface{}
  • json null -> nil

为了将一个JSON数组解码到一个切片中,Unmarshal将重置切片长度为0,然后再将每个元素追加到切片中。特别的,将一个空的JSON数组解码到一个切片中,Unmarshal使用一个空的切片替换切片。

为了将一个JSON对象解码到map中,Unmarshal 首先建立一个map,如果map为nil,将重新分配一个,否则直接使用它,保留之前的键值对,然后将JSON对象的key-value对存到map中去。map的键类型必须是一个字符串,或者整数,或者实现了excoding.TextUnmarshaler接口的类型。

如果一个JSON值不适合给的目标值的类型。或者JSON数字值范围超过了目标类型的范围,Unmarshal将跳过它,尽可能的完成其他解码。如果没有遇到更加严重的错误,Unmarshal将返回一个描述早前错误的异常。

err = json.Unmarshal(jsonUser2, &userFromJSON)
    if err != nil {
        return
    }
    fmt.Println(userFromJSON)
我来评几句
登录后评论

已发表评论数()

相关站点

热门文章