Go 结构体序列化的实现
作者:Go语言由浅入深 发布时间:2024-05-21 10:26:40
本文,我们将回到之前写的showMovieHandler方法,并更新它以返回一个JSON响应,表示系统中的单个电影信息。类似于:
{
? ? "id": 123,
? ? "title": "Casablanca",?
? ? "runtime": 102,?
? ? "genres": [
? ? ? ? "drama",?
? ? ? ? "romance",?
? ? ? ? "war"
? ? ],
? ? "version": 1?
}
我们不使用map序列化来创建这个JSON对象(就像我们在上一节中所做的那样),这次我们将编码一个自定义的Movie结构体。
首先,需要定义一个Movie结构体。我们将在一个新internal/data包中完成此操作,该包稍后将扩展用来封装项目中所有自定义数据类型以及与数据库交互的逻辑。
如果您按照文章步骤操作,请创建一个新的internal/data目录,其中包含一个movies.go文件:
$ mkdir internal/data
$ touch internal/data/movies.go
在这个新文件中,定义Movie结构,像这样:
File: internal/data/movies.go
package main
import (
? ? "time"
)
type Movie struct {
? ? ID ? ? ? ? ? ? int64 ? ? ?//唯一整数ID
? ? CreatedAt ? ? ?time.Time ?//创建电影到数据库的时间
? ? Title ? ? ? ? ?string ? ? //电影标题
? ? Year ? ? ? ? ? int32 ? ? ?//电影发布年份
? ? Runtime ? ? ? ?int32 ? ? ?//电影时长
? ? Genres ? ? ? ? []string ? //电影类型(爱情片、喜剧片等)
? ? Version ? ? ? ?int32 ? ? ?//版本号从1开始,每更新一次递增
}
这里需要指出的是,Movie结构体中的所有字段都是可导出的(即以大写字母开头),这对于Go的encoding/json包可见是必要的。在将结构体编码为JSON时,不会包含任何未导出的字段。
现在结构体已经定义完成,让我们更新showMovieHandler处理程序来初始化一个Movie结构体实例,然后使用writeJSON()帮助函数将其作为JSON响应发送给客户端。
实现很简单:
File: cmd/api/movies.go
package main
import (
"fmt"
"net/http"
"time"
"greenlight.alexedwards.net/internal/data"
)
func (app *application) showMovieHandler(w http.ResponseWriter, r *http.Request) {
id, err := app.readIDParam(r)
if err != nil {
http.NotFound(w, r)
return
}
//创建一个Move结构体实例,包含从请求URL中解析的ID虚构的数据。注意这里故意没有设置Year字段
movie := date.Movie{
ID: id,
CreateAt: time.now(),
Title: "Casablanca",
Runtime: 102,
Genres: []string{"drama", "romance", "war"},
Version: 1,
}
//将结构体序列化为JSON并以HTTP响应发送给客户端
err = app.writeJSON(w, http.StatusOK, movie, nil)
if err != nil {
app.logger.Println(err)
http.Error(w, "The server encountered a problem and could not process your request", http.StatusInternalServerError)
}
}
ok,下面试试!
重启API,然后在浏览器中访问localhost:4000/v1/movies/123。你应该会看到一个类似这样的JSON响应:
在这个返回结果中,有几件有趣的事情需要指出:
Movie结构体被编码成一个JSON对象,字段名和值作为键/值对。
默认情况下,JSON对象中的键等于结构体中的字段名(ID、CreatedAt、Title等等)。我们稍后将讨论如何自定义JSON键。
如果结构体实例字段没有显式赋值,那么字段零值将序列化为json值。可以在上面的响应中看到——我们没有在Go代码中为Year字段设置值,但它仍然以0值出现在JSON输出中。
更改JSON对象中的键
在Go中序列化结构体的一个好处是,您可以通过使用struct标签注释字段来定制JSON。
struct标签最常见的用途可能是更改JSON对象中出现的键名称。当你的结构体字段名不适合面向公众展示,或者你想在JSON输出中使用另一种大小写样式时,这是很有用的。
为了说明如何实现,对Movies结构体字段打标签,使用蛇形格式:
File: internal/data/movies.go
//使用标记对Movie结构进行注释,以控制json编码的key显示方式。
type Movie struct {
? ? ID ? ? ? int64 ? ? `json:"id"`
? ? CreateAt time.Time `json:"created_at"`
? ? Title ? ?string ? ?`json:"title"`
? ? Year ? ? int32 ? ? `json:"year"`
? ? Runtime ?int32 ? ? `json:"runtime"`
? ? Genres ? []string ?`json:"genres"`
? ? Version ?int32 ? ? `json:"version"`
}
如果你重启服务器并再次访问localhost:4000/v1/movies/123,应该会看到一个类似于这样的带有蛇形键的响应:
在JSON对象中隐藏结构体字段
在定义结构体时候,通过使用omitempty可以控制对应字段在JSON中的可见性。当您不希望JSON输出中出现特定的结构体字段时,可以使用-(连字符)指令。这对包含和用户不相关的内部系统信息的字段或不想公开的敏感信息(如密码哈希值)非常有用。
相反,当且仅当struct字段值为空时,omitempty指令会在JSON输出中隐藏字段,其中empty被定义为:
等于false,0或“”
空数组,切片或map
nil指针或接口值为nil
为了演示如何使用这些指令,我们对Movie结构进行更多的改造。CreatedAt字段与我们的最终用户无关,所以我们使用-指令在输出中将其隐藏。我们还将使用omitempty指令在输出中隐藏Year、Runtime和types字段,当且仅当它们为空时生效。
继续并像下面这样更新struct标签:
File:interface/data/movies.go
package data
....
type Movie struct {
? ? ID ? ? ? int64 ? ? `json:"id"`
? ? CreateAt time.Time `json:"-"` ? ? ? //使用-指令
? ? Title ? ?string ? ?`json:"title"`
? ? Year ? ? int32 ? ? `json:"year,omitempty"` ? ? ? ? ? ?//添加omitempty
? ? Runtime ?int32 ? ? `json:"runtime,omitempty"` ? ? ? ? //添加omitempty
? ? Genres ? []string ?`json:"genres,omitempty"` ? ? ? ? ?//添加omitempty
? ? Version ?int32 ? ? `json:"version"`
}
如果你想使用omitempty而不改变键名,那么你可以在struct标签中保留它为空-如:json:",omitempty"。注意,逗号是必要的。
现在,当你重新启动应用程序并刷新你的web浏览器时,你应该会看到如下响应:
我们可以在这里看到,CreatedAt结构字段不再出现在JSON中,而且Year字段(值为0)也没有出现,这要感谢omitempty指令。其他字段使用了omitempty不受影响(例如Runtime和Genres)。
注意:您还可以通过简单地将结构体字段设置为不可导出来防止它出现在JSON序列化中。但使用json:“-“标记通常是一个更好的选择:明确告知阅读代码的人,你不希望该字段包含在json。
旧版本的go vet如果你试图在未导出的字段上使用struct标记会引发错误,但现在在go 1.16中已经修复了这个问题。
附加内容
结构体标签string指令
最后一个不太常用的struct标记指令是string。可以使用这个标签明确表示字段值序列化成JSON字符串类型。例如,如果我们希望Runtime字段的值表示为一个JSON字符串 (而不是数字)我们可以像这样使用string指令:
type Movie struct {
? ? ID ? ? ? int64 ? ? `json:"id"`
? ? CreateAt time.Time `json:"-"` ? ? ? //使用-指令
? ? Title ? ?string ? ?`json:"title"`
? ? Year ? ? int32 ? ? `json:"year,omitempty"` ??
? ? Runtime ?Runtime ? `json:"runtime,omitempty,string"`?
? ? Genres ? []string ?`json:"genres,omitempty"` ? ? ??
? ? Version ?int32 ? ? `json:"version"`
}
JSON序列化结果如下所示:
{
"id": 123,
"title": "Casablanca",
"runtime": "102", ? //这是字符串
"genres": [
? ? "drama",?
? ? "romance",?
? ? "war"
? ? ],
"version": 1?
}
注意string指令只对int, uint, float*或bool类型的字段有效。对于任何其他类型的结构体字段没有作用。
来源:https://www.jianshu.com/p/49198840449c


猜你喜欢
- 如果不能设计一个合理的数据库模型,不仅会增加客户端和服务器段程序的编程和维护的难度,而且将会影响系统实际运行的性能。所以,在一个系统开始实施
- 背景:我们在使用数据库的过程中,很多时候要追求性能,特别在处理大批量数据的时候更希望快速处理。那么对SQL SERVER而言,数据库实现大批
- var声明变量的作用域限制在其声明位置的上下文中var x = 0; // x是全局变量,并且赋值为0。console.log(typeof
- 1、 变量及其作用域:变量分为“全局变量”和“局部变量”,“全局变量”申明在函数外部,可供所有函数使用,而“局部变量”申明在函数体内部,只能
- 本文实例讲述了mysql聚簇索引的页分裂。分享给大家供大家参考,具体如下:在MySQL中,MyISAM采用的是非聚簇索引的,InnoDB存储
- # -*- coding: utf-8 -*-# @Author: CriseLYJ# @Date: 2020-08-14 12
- 一、 功能Android端或者Android终端的远程截图至本地电脑中二、使用说明1.adb截图工具可用于Android手机及Android
- 自动化测试执行的用例有很多,python额测试用例文件,都是以“test”开头的。TestLoader(defaultTestLoader)
- 目录1. pgzeropgzero的安装2. 游戏设计的过程3. pgzero基础4. pgzero游戏例子5. 总结6. 参考资料1. p
- 一般是有左侧菜单后,然后要在页面上部分添加历史标签菜单需求。借鉴其他项目,以及网上功能加以组合调整实现按照标签实现方式步骤来(大致思路):1
- 快速排序是C.R.A.Hoare于1962年提出的一种划分交换排序。它采用了一种分治的策略,通常称其为分治法(Divide-and-Conq
- 导语元宵节,又称上元节、灯节,是春节之后的第一个重要节日。相传,汉文帝(前179—前157年)为庆祝周勃于正月十五勘平诸
- 一.Sobel算子Sobel算子是一种用于边缘检测的离散微分算子,它结合了高斯平滑和微分求导。该算子用于计算图像明暗程度近似值,根据图像边缘
- 我打算将WebQQ单独出来运行, 一开始直接拷贝了pyxmpp2的mainloop, 但是跑起来问题多多, 所以我又研究了利用Tornado
- 本文实例讲述了Python删除windows垃圾文件的方法。分享给大家供大家参考。具体如下:#coding:utf-8import os#f
- 推荐第四种方案1通过MyBatis配置文件创建读写分离两个DataSource,每个SqlSessionFactoryBean对象的mapp
- ndarray 的数据类型数据类型,即 dtype ,也是一个特殊的对象, 它包含了ndarray需要为某一种类型数据所申明的内存块信息(也
- CSS的出现使网页制作者在对网页元素的控制方便许多,当然,有利必有弊,CSS只能对颜色、大小、距离等静
- 电脑面前的你,是否也希望能让电脑听命于你? 当你累的时候,只需说一声“我累了”,电脑就会放着优雅的轻音乐来让你放松。
- 在html里的每一个标签都有其自身的意义,而H标签作为标题标签,它的意义更是至关重要。对于H标签的用法特别是h1的用法一直是个争议的问题,也