Golangencoding/json自定义序列化与反序列化

通过实现Marshaler与Unmarshaler接口及使用结构体标签,可自定义Go中JSON的序列化与反序列化行为,如格式化时间、重命名字段、忽略空值等。

golangencoding/json自定义序列化与反序列化

在 Go 语言中,encoding/json 包提供了标准的 JSON 序列化和反序列化功能。但默认行为有时无法满足业务需求,比如处理时间格式、自定义字段映射、忽略空值逻辑等。这时就需要通过实现特定接口来自定义序列化与反序列化过程。

实现 Marshaler 与 Unmarshaler 接口

要控制某个类型的 JSON 输出和解析行为,可以实现 json.Marshalerjson.Unmarshaler 接口。

这两个接口定义如下:

type Marshaler interface {    MarshalJSON() ([]byte, error)}type Unmarshaler interface {    UnmarshalJSON([]byte) error}

例如,我们希望将时间以

"2006-01-02"

格式输出,而不是默认的 RFC3339 格式:

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

type CustomDate struct {    time.Time}func (cd CustomDate) MarshalJSON() ([]byte, error) {    return []byte(fmt.Sprintf(`"%s"`, cd.Time.Format("2006-01-02"))), nil}func (cd *CustomDate) UnmarshalJSON(data []byte) error {    // 去掉引号    s := strings.Trim(string(data), `"`)    t, err := time.Parse("2006-01-02", s)    if err != nil {        return err    }    cd.Time = t    return nil}

使用时:

date := CustomDate{Time: time.Now()}jsonBytes, _ := json.Marshal(date)fmt.Println(string(jsonBytes)) // 输出:"2025-04-05"

结构体字段标签(Struct Tags)

通过

json:

标签可以控制字段名、是否忽略、条件性编码等。

重命名字段

json:"name"

忽略空值

json:",omitempty"

忽略字段

json:"-"

同时使用

json:"age,omitempty"

示例:

type User struct {    ID    int    `json:"id"`    Name  string `json:"name"`    Email string `json:"email,omitempty"`    Admin bool   `json:"-"`}

当 Email 为空字符串时,序列化结果中不会包含该字段。

嵌套类型与指针处理

如果字段是指针类型,encoding/json 会自动解引用进行序列化。但如果指针为 nil,则输出 null。

若想对指针类型做特殊处理,也可以在指针接收者上实现

MarshalJSON

UnmarshalJSON

比如:

func (cd *CustomDate) MarshalJSON() ([]byte, error) {    if cd == nil {        return []byte("null"), nil    }    return []byte(fmt.Sprintf(`"%s"`, cd.Time.Format("2006-01-02"))), nil}

这样即使字段是

*CustomDate

类型且为 nil,也能安全处理。

处理动态或未知结构

有时候需要处理部分已知、部分动态的数据。可以结合

map[string]interface{}

json.RawMessage

使用。

json.RawMessage 能延迟解析某段 JSON 内容,适用于需要按条件解析的场景。

type Message struct {    Type      string          `json:"type"`    Payload   json.RawMessage `json:"payload"`}

先解析外层结构,再根据 Type 决定如何解析 Payload。

基本上就这些。自定义序列化的核心在于理解接口机制和标签用法,配合实际需求灵活调整。

以上就是Golangencoding/json自定义序列化与反序列化的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1407768.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月15日 23:28:37
下一篇 2025年12月15日 23:28:42

相关推荐

  • Go语言中实现字符串驻留(String Interning)

    在Go语言中,并没有像Java的String.intern()方法那样直接提供的字符串驻留功能。字符串驻留是指将相同的字符串内容只保留一份拷贝,所有指向该字符串的变量都指向同一块内存地址,从而节省内存空间。虽然Go语言本身没有内置此功能,但我们可以通过一些技巧来实现类似的效果。 使用Map实现字符串…

    好文分享 2025年12月15日
    000
  • Go语言中实现字符串驻留(String Intern)机制及内存优化实践

    在Go语言中,处理大量重复字符串时,缺乏像Java String.intern 这样的内置函数来自动进行字符串驻留以节省内存。本文将探讨如何通过自定义 Interner 实现这一机制,利用 map 对字符串进行去重,并详细讨论在实现过程中可能遇到的内存占用问题及其两种优化方案,包括安全的双重复制和使…

    2025年12月15日
    000
  • 理解Go HTTP处理器中的并发:避免响应丢失的常见陷阱

    本文探讨Go语言HTTP服务中一个常见的并发陷阱:在HTTP请求处理器内部不恰当地使用go关键字启动新的goroutine来处理响应。我们将解释为何net/http.ListenAndServe已为每个请求启动独立的goroutine,以及在处理器中额外启动goroutine可能导致http.Res…

    2025年12月15日
    000
  • Golang反射获取结构体方法列表实践

    Go语言通过反射可动态获取结构体方法,核心是使用reflect.TypeOf获取类型对象,再调用NumMethod和Method遍历方法;需注意值接收者与指针接收者差异:值类型只能访问值接收者方法,而指针类型可访问两者;通过reflect.Method可获取方法名、类型签名及函数值,进而实现动态调用…

    2025年12月15日
    000
  • Go语言中如何格式化输出带千位分隔符的整数

    Go语言标准库fmt.Printf不直接支持带千位分隔符的整数输出。本教程将介绍如何利用golang.org/x/text/message包实现这一功能。通过创建本地化打印器,开发者可以轻松地根据不同语言环境(如英语)格式化数字,使其包含正确的千位分隔符,从而提升程序的用户体验和国际化能力。 fmt…

    2025年12月15日
    000
  • Go语言中实现高效字符串去重(Interning)策略

    本文探讨Go语言中字符串去重(interning)的需求与实现方法。鉴于Go标准库未提供类似Java String.intern()的功能,文章详细介绍如何通过自定义 Interner 类型和 map[string]string 来高效管理重复字符串,以优化内存使用。同时,文章深入讨论了在特定场景下…

    2025年12月15日
    000
  • Golang函数作为参数传递与返回技巧

    Golang中函数可作为参数和返回值传递,通过函数类型实现高阶函数、回调、策略模式等灵活设计。 在Golang中,函数确实可以像普通变量一样被传递和返回,这为我们构建高度灵活、可复用的代码提供了强大的工具。它本质上利用了函数作为“一等公民”的特性,让我们可以设计出更抽象、更具适应性的程序结构,比如高…

    2025年12月15日
    000
  • Golang建造者模式实现与使用方法

    建造者模式通过分离对象构建与表示,提升代码可读性和灵活性。在Golang中适用于参数多、构建复杂或需不可变对象的场景,相比构造函数避免参数爆炸,相比选项模式提供更强封装与类型安全,但增加样板代码。示例中Car对象通过链式调用逐步配置,Build方法返回最终实例,体现模式核心价值。 在我看来,Gola…

    2025年12月15日
    000
  • Go 并发 HTTP 请求无响应问题排查与解决

    Go 语言中并发处理 HTTP 请求时,如果使用不当,可能会导致请求无响应。这是因为 net/http 包的 ListenAndServe 函数已经自动启动了 goroutine 来处理每个连接。重复启动 goroutine 反而会导致问题。 ListenAndServe 函数内部已经实现了并发处理…

    2025年12月15日
    000
  • Go语言:实现带千位分隔符的数字格式化输出

    Go语言标准库的fmt.Printf函数不直接支持数字的千位分隔符格式化输出。本教程将介绍如何利用golang.org/x/text/message包,实现对整数进行本地化千位分隔符格式化输出,从而满足不同语言环境下的数字显示需求,确保数字的可读性和专业性。 在go语言中,当我们需要输出一个大整数时…

    2025年12月15日
    000
  • Go语言国际化数字格式化:实现千位分隔符输出

    在Go语言中,标准库fmt.Printf不直接支持为整数添加千位分隔符。要实现这一功能,应使用golang.org/x/text/message包。该包提供了基于Unicode CLDR的国际化数字格式化能力,允许开发者通过指定语言标签(如language.English)来打印带有本地化千位分隔符…

    2025年12月15日
    000
  • Go语言中如何使用千位分隔符格式化整数

    在Go语言中,标准库fmt.Printf不直接支持为整数添加千位分隔符。本文将介绍如何利用golang.org/x/text/message包实现本地化的数字格式化,从而轻松为整数输出添加千位分隔符,提升数字的可读性,并支持多语言环境下的格式化需求。 1. 问题背景:标准fmt.Printf的局限性…

    2025年12月15日
    000
  • Golang测试用例中的错误断言方法

    答案是选择合适的断言方法并编写清晰错误信息以提升测试质量。Golang中可使用testify等assert库简化断言,或通过标准库testing结合t.Errorf自定义错误信息,亦可创建如assertFloatEquals等自定义函数增强灵活性;在并发测试中需用互斥锁保护共享资源,确保断言准确性;…

    2025年12月15日
    000
  • Golang网络爬虫项目初级实战

    答案:Go语言实现网络爬虫适合初学者实践并发与HTTP处理。使用net/http发起请求,配合goquery解析HTML,可高效提取数据;推荐初学者用net/http+goquery组合掌握底层原理,进阶者可用colly框架提升开发效率;常见错误包括忽略错误处理、不关闭响应体导致资源泄露、无节制并发…

    2025年12月15日
    000
  • Go语言中执行Windows内置命令及跨平台兼容处理

    在Go语言中直接执行Windows内置命令(如del)常会遇到“可执行文件未找到”的错误,因为这些命令并非独立的.exe文件。本教程将详细介绍如何在Windows上通过cmd.exe /C正确调用这些内置命令,并提供跨平台解决方案,确保您的Go程序能在不同操作系统上平稳执行系统级操作,同时强调错误处…

    2025年12月15日
    000
  • Golang中跨平台执行系统命令:解决Windows内置命令执行失败问题

    本文深入探讨了在Golang中使用os/exec包执行系统命令时,特别是在Windows环境下执行del等内置命令时常遇到的“executable file not found”错误。教程将详细解释该错误发生的原因,并提供跨平台的解决方案,包括在Windows上通过cmd /C调用内置命令,以及在L…

    2025年12月15日
    000
  • Golangcrypto包基础加密与解密方法

    Go语言crypto包支持AES对称加密,推荐使用GCM模式。示例展示了CBC和GCM两种模式的加解密实现,强调密钥安全管理、IV随机生成及PKCS7填充处理,避免安全漏洞。 Go语言的 crypto 包提供了丰富的加密功能,适用于常见的安全需求。它包含多个子包,如 crypto/aes 、 cry…

    2025年12月15日
    000
  • Go语言中执行Windows内置命令的正确姿势

    在Go语言中执行系统命令时,直接调用Windows的内置命令(如del)会导致“executable file not found”错误,因为它们不是独立的可执行文件。正确的做法是在Windows上通过cmd /C来调用这些内置命令,而在类Unix系统(如macOS或Linux)上则使用对应的原生命…

    2025年12月15日
    000
  • Golang变量声明与基本类型使用示例

    Golang中变量声明主要有var和:=两种方式,var用于全局或延迟初始化,:=则简洁高效,适用于函数内局部变量;基本类型包括bool、数值型、字符串等,均自动初始化为零值,提升安全性和代码简洁性;类型推导机制使编译器能根据初始值自动确定变量类型,减少冗余代码,提高开发效率,但需注意潜在的类型误解…

    2025年12月15日
    000
  • Go语言中映射(Map)的正确初始化:避免运行时错误

    本文深入探讨Go语言中映射(Map)的初始化机制。Go语言中的映射,包括作为函数命名返回值声明的映射,其默认零值为nil。在向nil映射中添加元素会导致运行时错误。教程将详细解释为何需要使用内置函数make来正确初始化映射,区分nil映射与空映射,并提供代码示例,确保开发者能避免常见的panic: …

    2025年12月15日
    000

发表回复

登录后才能评论
关注微信