0

0

Golang中使用JSON时区分空字段和未设置字段的方法

藏色散人

藏色散人

发布时间:2020-09-09 09:37:29

|

3109人浏览过

|

来源于learnku

转载

下面由golang教程栏目给大家介绍Golang中使用JSON时区分空字段和未设置字段的方法,希望对需要的朋友有所帮助!

go

几周前, 我在使用 Golang 微服务, 需要添加使用 JSON 数据的 CURP 操作的支持. 通常, 我会为实体创建一个结构体, 该结构体中定义了所有字段以及 'omitempty' 属性, 如下所示

type Article struct {
   Id   string      `json:"id"`
   Name string      `json:"name,omitempty"`
   Desc string      `json:"desc,omitempty"`
}

问题

但是这种表示形式带来了严重的问题, 尤其对于 Update 或 Edit 操作而言.

例如, 假设更新请求的 JSON 数据看起来像是这样

立即学习go语言免费学习笔记(深入)”;

{"id":"1234","name":"xyz","desc":""}

注意为空的 desc 字段. 现在让我们来看看这段请求数据在 Go 中解封后是怎么样的

func Test_JSON1(t *testing.T) {         
   jsonData:=`{"id":"1234","name":"xyz","desc":""}`
   req:=Article{}
   _=json.Unmarshal([]byte(jsonData),&req)
   fmt.Printf("%+v",req)
}Output:
=== RUN   Test_JSON1
{Id:1234 Name:xyz Desc:}

这里的描述是一个空字符串, 很明显客户端希望将 desc 设置为空字符串, 这是由我们的程序推断出来的.

但是, 如果客户端不希望更改 Desc 的现有值, 在这种情况下, 再次发送一个描述字符串是不正确的, 因此请求的 JSON 数据可能看起来像是这样

{"id":"1234","name":"xyz"}

我们解封到我们的结构体中

func Test_JSON2(t *testing.T) {         
   jsonData:=`{"id":"1234","name":"xyz"}`
   req:=Article{}
   _=json.Unmarshal([]byte(jsonData),&req)
   fmt.Printf("%+v",req)
}Output:
=== RUN   Test_JSON2
{Id:1234 Name:xyz Desc:}
额, 仍然会将 Desc 作为空字符串获取, 那么如何区分未设置字段和空字段

简答? 指针

解决办法

受到一些现有 Golang 库的启发, 如 go-github. 我们可以将结构体字段更改为指针类型, 如下所示

type Article struct {
   Id    string      `json:"id"`
   Name *string      `json:"name,omitempty"`
   Desc *string      `json:"desc,omitempty"`
}

通过这样做, 我们在字段中添加了额外的状态. 如果原始 JSON 中不存在该字段, 则结构体字段将为空 (nil).

AIPAI
AIPAI

AI视频创作智能体

下载

另一方面, 如果该字段确实存在并且为空, 则指针不为空, 并且该字段包含空值.

注意 - 我没有将 'Id' 字段更改为指针类型, 因为它不具备空状态, id 是必需的, 类似数据库中的 id.

我们再尝试一下.

func Test_JSON_Empty(t *testing.T) {
   jsonData := `{"id":"1234","name":"xyz","desc":""}`
   req := Article{}
   _ = json.Unmarshal([]byte(jsonData), &req)
   fmt.Printf("%+v\n", req)
   fmt.Printf("%s\n", *req.Name)
   fmt.Printf("%s\n", *req.Desc)
}
func Test_JSON_Nil(t *testing.T) {
   jsonData := `{"id":"1234","name":"xyz"}`
   req := Article{}
   _ = json.Unmarshal([]byte(jsonData), &req)
   fmt.Printf("%+v\n", req)
   fmt.Printf("%s\n", *req.Name)
}

Output

=== RUN   Test_JSON_Empty
{Id:1234 Name:0xc000088540 Desc:0xc000088550}
Name: xyz
Desc: 
--- PASS: Test_JSON_Empty (0.00s)=== RUN   Test_JSON_Nil
{Id:1234 Name:0xc00005c590 Desc:}
Name: xyz
--- PASS: Test_JSON_Nil (0.00s)

第一种情况, 由于 desc 设置为空字符串, 因此我们在 Desc 获得了一个非空指针并包含一个空字符串的值. 第二种情况, 该字段未设置, 我们得到了一个空字符串指针.

因此我们能够区分两种更新. 这种方式不仅适用于字符串, 而且适用于其他的所有数据类型, 包括整型, 嵌套结构体, 等.

但是这种方法也存在一些问题.

空安全性: 非指针数据类型具备固有的空安全性. 在 Golang 中这意味着字符串或整型永远不能为空. 他们始终具备默认值. 但是如果定义了指针, 则这些数据类型在未手动设置的情况下默认为空. 因此, 尝试在不验证可空性的情况下访问那些指针的数据可能会导致应用程序崩溃.

# 以下代码将崩溃, 因为 desc 为空
func Test_JSON_Nil(t *testing.T) {
   jsonData := `{"id":"1234","name":"xyz"}`
   req := Article{}
   _ = json.Unmarshal([]byte(jsonData), &req)
   fmt.Printf("%+v\n", req)
   fmt.Printf("%s\n", *req.Desc)
}

通过始终检查空指针可以很容易的解决此问题, 但你的代码可能会看起来会很啰嗦.

可打印性: 如在基于指针的解决方案的输出中你可能已经注意到的问题, 不会打印指针的值. 二十打印了指针的十六进制值, 这在应用程序中没什么用. 这也可以通过重新使用 stringer 接口来克服.

func (a *Article) String() string {
   output:=fmt.Sprintf("Id: %s ",a.Id)
   if a.Name!=nil{
   output+=fmt.Sprintf("Name: '%s' ",*a.Name)
   }
   if u.Desc!=nil{
   output+=fmt.Sprintf("Desc: '%s' ",u.Desc)
   }
   return output
}

附录:

  • 解决上述问题的另一种方法是使用具有可为空类型的三方库, 其类型可提供检查是否为空的方法, 而无需关心指针.
  • github.com/guregu/null
  • github.com/google/go-github

原文地址:https://medium.com/@arpitkh96/differentiate-between-empty-and-not-set-fields-with-json-in-golang-957bb2c5c065

译文地址:https://learnku.com/go/t/49332

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
C++ 设计模式与软件架构
C++ 设计模式与软件架构

本专题深入讲解 C++ 中的常见设计模式与架构优化,包括单例模式、工厂模式、观察者模式、策略模式、命令模式等,结合实际案例展示如何在 C++ 项目中应用这些模式提升代码可维护性与扩展性。通过案例分析,帮助开发者掌握 如何运用设计模式构建高质量的软件架构,提升系统的灵活性与可扩展性。

8

2026.01.30

c++ 字符串格式化
c++ 字符串格式化

本专题整合了c++字符串格式化用法、输出技巧、实践等等内容,阅读专题下面的文章了解更多详细内容。

8

2026.01.30

java 字符串格式化
java 字符串格式化

本专题整合了java如何进行字符串格式化相关教程、使用解析、方法详解等等内容。阅读专题下面的文章了解更多详细教程。

6

2026.01.30

python 字符串格式化
python 字符串格式化

本专题整合了python字符串格式化教程、实践、方法、进阶等等相关内容,阅读专题下面的文章了解更多详细操作。

1

2026.01.30

java入门学习合集
java入门学习合集

本专题整合了java入门学习指南、初学者项目实战、入门到精通等等内容,阅读专题下面的文章了解更多详细学习方法。

20

2026.01.29

java配置环境变量教程合集
java配置环境变量教程合集

本专题整合了java配置环境变量设置、步骤、安装jdk、避免冲突等等相关内容,阅读专题下面的文章了解更多详细操作。

17

2026.01.29

java成品学习网站推荐大全
java成品学习网站推荐大全

本专题整合了java成品网站、在线成品网站源码、源码入口等等相关内容,阅读专题下面的文章了解更多详细推荐内容。

18

2026.01.29

Java字符串处理使用教程合集
Java字符串处理使用教程合集

本专题整合了Java字符串截取、处理、使用、实战等等教程内容,阅读专题下面的文章了解详细操作教程。

3

2026.01.29

Java空对象相关教程合集
Java空对象相关教程合集

本专题整合了Java空对象相关教程,阅读专题下面的文章了解更多详细内容。

6

2026.01.29

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
golang socket 编程
golang socket 编程

共2课时 | 0.1万人学习

nginx浅谈
nginx浅谈

共15课时 | 0.8万人学习

golang和swoole核心底层分析
golang和swoole核心底层分析

共3课时 | 0.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号