V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
The Go Programming Language
http://golang.org/
Go Playground
Go Projects
Revel Web Framework
darluc
V2EX  ›  Go 编程语言

如何使用 Go 语言解析 JSON - 译文

  •  
  •   darluc · 2019-02-18 01:31:42 +08:00 · 3471 次点击
    这是一个创建于 2103 天前的主题,其中的信息可能已经有所发展或是发生改变。

    查看全文

    当静态编程语言使用到 JSON 的时候,总是会有些费力。一方面,JSON 数据可能是任何形式的,从一个简单的数字,到一个复杂的包含内嵌对象的数组。当使用 Go 语言的时候,这意味着你要将这些变化多端的 JSON 数据放入结构化的变量中去。

    幸运地是,Go 尽力尝试帮我们降低编码难度,为我们提供了许多方式来解析 JSON 数据。

    概述

    Go 标准库的 json 包为我们提供了我们想要的功能。对于任意的 JSON 字符串,标准的解析方法如下:

    import "encoding/json"
    //...
    
    // ... 
    myJsonString := `{"some":"json"}`
    
    // `&myStoredVariable` is the address of the variable we want to store our
    // parsed data in
    json.Unmarshall([]byte(myJsonString), &myStoredVariable)
    //...
    

    本文中我们要讨论的是,对于 myStoredVariable 变量的类型,你可以有哪些不同的选择,以及决定何时采用何种类型。

    在处理 JSON 数据时,你会遇到两种情况:

    1. 结构化数据
    2. 非结构化数据

    结构化数据

    我们先从结构化数据开始,因为它们处理起来相对容易一些。对于这类数据我们需要提前知晓其结构。比如,你有一个 Bird 对象,每种鸟都有 species 字段和一个 description 字段:

    {
      "species": "pigeon",
      "decription": "likes to perch on rocks"
    }
    

    读取此类数据,只要创建一个 struct 结构体,作为你想要解析的数据的镜像。对于这个例子,我们会创建一个包含 SpeciesDescription 字段的 Bird 结构体:

    type Bird struct {
      Species string
      Description string
    }
    

    然后将数据解析出来,如下:

    birdJson := `{"species": "pigeon","description": "likes to perch on rocks"}`
    var bird Bird	
    json.Unmarshal([]byte(birdJson), &bird)
    fmt.Printf("Species: %s, Description: %s", bird.Species, bird.Description)
    //Species: pigeon, Description: likes to perch on rocks
    

    转换时,Go 不区分名称大小写问题,使用 JSON 属性与字段都转为小写后相同作为映射依据。所以, Bird 结构的 Species 字段会映射到名为 species ,或者 Species 或者 sPeCiEs 的 JSON 属性。

    JSON 数组

    当遇到一个 Bird 数组的时候,又会发生什么呢?

    [
      {
        "species": "pigeon",
        "decription": "likes to perch on rocks"
      },
      {
        "species":"eagle",
        "description":"bird of prey"
      }
    ]
    

    既然这个数组的每个元素都是一个 Bird ,你可以创建一个 Bird 类型的数组来解析它:

    birdJson := `[{"species":"pigeon","decription":"likes to perch on rocks"},{"species":"eagle","description":"bird of prey"}]`
    var birds []Bird
    json.Unmarshal([]byte(birdJson), &birds)
    fmt.Printf("Birds : %+v", birds)
    //Birds : [{Species:pigeon Description:} {Species:eagle Description:bird of prey}]
    

    嵌套对象

    现在,考虑这种情况,Bird 有一个 Dimensions 属性,用来描述它的 Height (高度)和 Length (身长):

    {
      "species": "pigeon",
      "decription": "likes to perch on rocks",
      "dimensions": {
        "height": 24,
        "width": 10
      }
    }
    

    和上一个例子类似,我们需要将这个新的问题对象映射到我们的 Go 代码中。在机构体中加入一个内嵌的 dimensions 字段,让我们先申明一个 dimensions 的结构体类型:

    type Dimensions struct {
      Height int
      Width int
    }
    

    然后,Bird 结构体可以包含一个 Dimensions 字段:

    type Bird struct {
      Species string
      Description string
      Dimensions Dimensions
    }
    

    如此就能用与之前一样的方法进行数据解析了:

    birdJson := `{"species":"pigeon","description":"likes to perch on rocks", "dimensions":{"height":24,"width":10}}`
    var birds Bird
    json.Unmarshal([]byte(birdJson), &birds)
    fmt.Printf(bird)
    // {pigeon likes to perch on rocks {24 10}}
    

    自定义属性名称

    前面提到过 Go 会进行大小写转换来确定结构体字段和 JSON 属性的映射关系。不过很多时候,你会需要一个和 JSON 数据属性不同名的字段名称。

    {
      "birdType": "pigeon",
      "what it does": "likes to perch on rocks"
    }
    

    对于上面的 JSON 数据,我想让 birdType 属性映射到 Go 代码中的 Species 字段。同时我也没法给 "what it does" 提供一个合适的字段名称。

    为了解决这些情况,我们可以使用结构体字段标签:

    type Bird struct {
      Species string `json:"birdType"`
      Description string `json:"what it does"`
    }
    

    现在,我们可以明确地告诉代码,某个 JSON 属性应该映射到哪个字段上了。

    birdJson := `{"birdType": "pigeon","what it does": "likes to perch on rocks"}`
    var bird Bird
    json.Unmarshal([]byte(birdJson), &bird)
    fmt.Println(bird)
    // {pigeon likes to perch on rocks}
    

    非结构化数据

    如果你遇到一些数据,它们的结构和属性名都不确定,那么你就无法使用结构体来解析这些数据了。取而代之地,你可以使用映射( maps )类型。考虑以下的 JSON 形式:

    {
      "birds": {
        "pigeon":"likes to perch on rocks",
        "eagle":"bird of prey"
      },
      "animals": "none"
    }
    

    我们没法构建一个结构体来描述上面的数据,因为鸟儿的名字作为对象的键值总是可以变换,而这会导致数据结构的变化。

    为了处理这种情况,我们创建一个字符串对应空接口的 map:

    birdJson := `{"birds":{"pigeon":"likes to perch on rocks","eagle":"bird of prey"},"animals":"none"}`
    var result map[string]interface{}
    json.Unmarshal([]byte(birdJson), &result)
    
    // The object stored in the "birds" key is also stored as 
    // a map[string]interface{} type, and its type is asserted from
    // the interface{} type
    birds := result["birds"].(map[string]interface{})
    
    for key, value := range birds {
      // Each value is an interface{} type, that is type asserted as a string
      fmt.Println(key, value.(string))
    }
    

    每个字符串对应一个 JSON 属性的名称, interface{} 类型对应它的值,这个值可以是任意类型。在代码中,其数据类型通过对 interface{} 进行断言就可以获取到。而且这些映射解析动作可以迭代执行,如此一来,可变数量的键通过一次循环中就能够处理完成。

    如何选择

    通常情况下,只要你能够使用结构体来描述你的 JSON 数据,你就应该使用它们。只有当遇到数据中有不确定的键或值时,无法使用结构体进行描述,才是你使用映射( map )的唯一理由。

    查看全文

    2 条回复    2019-02-18 10:40:09 +08:00
    lxml
        1
    lxml  
       2019-02-18 04:01:15 +08:00 via Android
    我记得原文中好像还有默认数字类型是 float64 之类的
    zarte
        2
    zarte  
       2019-02-18 10:40:09 +08:00
    数字 float64 的,如果原值是整数可以 int ( xxx.(float64))这样转成可用的。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   3026 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 20ms · UTC 13:03 · PVG 21:03 · LAX 05:03 · JFK 08:03
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.