脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 脚本专栏 → Golang → Go语言结构体 JSON

详解Go语言中结构体与JSON间的转换

 更新时间：2022年12月13日 14:07:26   作者：陈明勇  
这篇文章主要为大家详细介绍了Go语言中结构体与JSON间的转换，文中的示例代码讲解详细，对学习Go语言有一定的帮助，需要的可以参考一下

前言

在日常开发中，我们往往会将 JSON 解析成对应的结构体，反之也会将结构体转成 JSON。接下来本文会通过 JSON 包的两个函数，来介绍 JSON 与结构体之间的转换。

结构体转 JSON

Marshal(v any) ([]byte, error)：将 v 转成 JSON 数据，以 []byte 的形式返回。

import (
    "encoding/json"
    "fmt"
)

type User struct {
    Name           string
    Age            int
    Height         float64
    Weight         *float64
    Child          bool
    marriageStatus string
}

func main() {
    weight := 120.5
    user := User{
        Name:           "gopher",
        Age:            18,
        Height:         180.5,
        Weight:         &weight,
        Child:          false,
        marriageStatus: "未婚",
    }
    jsonBytes, err := json.Marshal(user)
    if err != nil {
        fmt.Println("error: ", err)
        return
    }
    fmt.Println(string(jsonBytes)) // {"Name":"gopher","Age":18,"Height":180.5,"Weight":120.5,"Child":false}
}

执行结果：

{"Name":"gopher","Age":18,"Height":180.5,"Weight":120.5,"Child":false}

根据结果可知：

  • 不可导出字段（字段名以小写字母开头），是不能被转成 JSON 的 key 的，这也符合 Go 的语法规定，以小写字母开头的变量或结构体字段等，不能在包外被访问。
  • 转换后的字段名，与结构体字段的名字一样。
  • 如果字段是指针类型，转换后的值为指针指向的字段值。

如果我们想要指定字段转换之后的命名，或者将一个可导出的字段进行忽略，可以通过给结构体字段打上 JSON 标签的方式实现。

import (
    "encoding/json"
    "fmt"
)

type User struct {
    Name           string   `json:"name"`
    Age            int      `json:"age"`
    Height         float64  `json:"height"`
    Weight         *float64 `json:"weight"`
    Child          bool     `json:"child"`
    MarriageStatus string   `json:"-"`
}

func main() {
    weight := 120.5
    user := User{
        Name:           "gopher",
        Age:            18,
        Height:         180.5,
        Weight:         &weight,
        Child:          false,
        MarriageStatus: "未婚",
    }
    jsonBytes, err := json.Marshal(user)
    if err != nil {
        fmt.Println("error: ", err)
        return
    }
    fmt.Println(string(jsonBytes)) // {"name":"gopher","age":18,"height":180.5,"weight":120.5,"child":false}
}

通过给结构体字段定打上 JSON 标签，可指定转成 JSON 后的字段名，如果 JSON 标签的值为 -，则在转换 JSON 时忽略此字段。

JSON 解析结构体

Unmarshal(data []byte, v any) error：将 JSON 解析成指定的结构体。

import (
    "encoding/json"
    "fmt"
)

type User struct {
    Name           string  `json:"name"`
    Age            int     `json:"age"`
    Height         float64 `json:"height"`
    Child          bool    `json:"-"`
    marriageStatus string
}

func main() {
    userStr := `
    {
      "name": "gopher",
      "age": 18,
      "height": 180.5,
      "child": true,
      "marriageStatus": "未婚"
    }
    `
    user := &User{}
    err := json.Unmarshal([]byte(userStr), &user)
    if err != nil {
        fmt.Println("error: ", err)
        return
    }
    fmt.Printf("%#v", user) // &main.User{Name:"gopher", Age:18, Height:180.5, Child:false, marriageStatus:""}
}

执行结果：

&main.User{Name:"gopher", Age:18, Height:180.5, Child:false, marriageStatus:""}

根据结果可知：

使用Unmarshal函数时，我们需要传入结构体的指针类型，否则结构体字段的值将不会被改变，因为底层是通过指针去修改结构体字段的值。

JSON 解析时，JSON 的 key 与结构体字段的匹配规则是：

  • 优先查找 JSON 标签值和 key 一样的，找到则将 value 赋值给对应字段。
  • 如果没有 JSON 标签值与 key 相匹配，则根据字段名进行匹配。

可以发现，如果结构体字段是非导出字段或 JSON 标签的值为 -，将不会被匹配到。

小结

本文介绍了 Go 语言里，JSON 与结构体之间的转换。在结构体转 JSON 时，我们可以通过给字段打标签，指定转换后的 key 命名，需要注意的是，如果结构体的字段为非导出字段或字段的 JSON 标签值为 -，在转换 JSON 时，将会被忽略。反之 JSON 解析结构体时也是一样的。

到此这篇关于详解Go语言中结构体与JSON间的转换的文章就介绍到这了,更多相关Go语言结构体 JSON内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

相关文章

  • GoLang Time时间操作函数讲解

    GoLang Time时间操作函数讲解

    在日常开发中，我们避免不了时间的使用，我们可能需要获取当前时间，然后格式化保存，也可能需要在时间类型与字符串类型之间相互转换等。本文将会对 Go time 包里面的常用函数和方法进行介绍，需要的可以参考一下
    2023-01-01
  • 从浅入深带你掌握Golang数据结构map

    从浅入深带你掌握Golang数据结构map

    在 Go 语言中，map 是一种非常常见的数据类型，它可以用于快速地检索数据。本篇文章将介绍 Go 语言中的 map，包括 map 的定义、初始化、操作和优化，需要的可以参考一下
    2023-04-04
  • go程序部署到linux上运行的实现方法

    go程序部署到linux上运行的实现方法

    本文主要介绍了go程序部署到linux上运行的实现方法，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
    2022-04-04
  • go语言中struct标签详解

    go语言中struct标签详解

    这篇文章主要给大家介绍了关于go语言中struct标签的相关资料,文中通过实例代码介绍的非常详细,对大家学习或者使用go语言具有一定的参考学习价值,需要的朋友可以参考下
    2023-07-07
  • go语言阻塞函数和非阻塞函数实现

    go语言阻塞函数和非阻塞函数实现

    本文主要介绍了go语言阻塞函数和非阻塞函数实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2023-03-03
  • golang 进度条功能实现示例

    golang 进度条功能实现示例

    这篇文章主要介绍了golang 进度条功能实现示例，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2020-08-08
  • Golang创建构造函数的方法超详细讲解

    Golang创建构造函数的方法超详细讲解

    构造器一般面向对象语言的典型特性，用于初始化变量。Go语言没有任何具体构造器，但我们能使用该特性去初始化变量。本文介绍不同类型构造器的差异及其应用场景
    2023-01-01
  • 浅析Go语言中的Range关键字

    浅析Go语言中的Range关键字

    Range是go语言中很独特的一个关键词，也相当好用。下面就跟着小编来再聊聊这个Range关键字，有需要的朋友们可以参考借鉴。
    2016-09-09
  • 全面解析Go语言中crypto/sha1库

    全面解析Go语言中crypto/sha1库

    crypto/sha1在Go语言标准库中是一个强大且实用的工具,适用于多种应用场景,本文就详细的介绍了Go语言中crypto/sha1库,具有一定的参考价值,感兴趣的可以了解一下
    2024-02-02
  • Go中的交叉编译问题

    Go中的交叉编译问题

    这篇文章主要介绍了Go中的交叉编译问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-11-11

最新评论