标题:Go 语言中将嵌套结构体高效转换为扁平数组的实践教程

阿磊大大_9348

阿磊大大_9348

2025-12-26

383人浏览

原创

标题:Go 语言中将嵌套结构体高效转换为扁平数组的实践教程

本文介绍如何通过实现 `json.marshaler` 接口,将含嵌入结构体(如 `model`)的 go 结构体(如 `user`)序列化为紧凑、有序的 json 数组格式,适用于前端表格渲染等场景。

在构建 Web API 或数据导出服务时,有时需要将结构化数据以扁平数组形式(而非默认对象映射)输出,尤其当前端使用轻量级表格库(如 DataTables、Handsontable)并依赖固定字段顺序时。Go 默认的 JSON 序列化会生成键值对对象,而本文提供一种类型安全、可维护、高性能的替代方案:通过自定义 MarshalJSON() 方法,显式控制结构体到数组的映射逻辑。

✅ 核心思路:实现 json.Marshaler

Go 的 encoding/json 包允许任何类型通过实现 MarshalJSON() ([]byte, error) 方法,完全接管其 JSON 序列化行为。对于嵌入结构体(如 Model),我们可在 User.MarshalJSON() 中手动提取字段,并按预定义顺序拼装 []interface{},再交由 json.Marshal 编码。

以下是一个完整、可运行的示例:

HISUI 前端框架开发指南(IRIS版)
HISUI 前端框架开发指南(IRIS版)

HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库,专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考,支持声明式与编程式两种初始化方式,提供 $cm/$m 数据访问方法。

下载
package main

import (
    "encoding/json"
    "fmt"
    "time"
)

// 假设 bson.ObjectId 已被简化为 string(实际项目中请替换为真实类型)
type ObjectId string

func (ObjectId) Hex() string { return "507f1f77bcf86cd799439011" }

type Model struct {
    Id        ObjectId  `bson:"_id,omitempty"`
    CreatedAt time.Time `bson:",omitempty"`
    UpdatedAt time.Time `bson:",omitempty"`
    DeletedAt time.Time `bson:",omitempty"`
    CreatedBy ObjectId  `bson:",omitempty"`
    UpdatedBy ObjectId  `bson:",omitempty"`
    DeletedBy ObjectId  `bson:",omitempty"`
    Logs      []ObjectId `bson:",omitempty"`
}

type User struct {
    Name  string `bson:"name"`
    Model `bson:",inline"`
}

// MarshalJSON 实现:将 User 序列化为固定顺序的 JSON 数组
// 顺序:Name, Id, CreatedAt, UpdatedAt, DeletedAt, CreatedBy, UpdatedBy, DeletedBy, Logs
func (u User) MarshalJSON() ([]byte, error) {
    // 注意:Logs 是 []ObjectId,若需转为字符串切片可额外处理(如 u.LogsHex())
    arr := []interface{}{
        u.Name,
        u.Id.Hex(),                 // 转为字符串表示
        u.CreatedAt.Format(time.RFC3339),
        u.UpdatedAt.Format(time.RFC3339),
        u.DeletedAt.Format(time.RFC3339),
        u.CreatedBy.Hex(),
        u.UpdatedBy.Hex(),
        u.DeletedBy.Hex(),
        u.Logs, // 保持为数组(可选:转为 []string)
    }
    return json.Marshal(arr)
}

func main() {
    user := User{
        Name: "kiz",
        Model: Model{
            Id:        ObjectId("507f1f77bcf86cd799439011"),
            CreatedAt: time.Date(2014, 1, 1, 0, 0, 0, 0, time.UTC),
            UpdatedAt: time.Date(2014, 1, 1, 0, 0, 0, 0, time.UTC),
            DeletedAt: time.Date(2014, 1, 1, 0, 0, 0, 0, time.UTC),
            CreatedBy: ObjectId("507f1f77bcf86cd799439012"),
            UpdatedBy: ObjectId("507f1f77bcf86cd799439013"),
            DeletedBy: ObjectId("507f1f77bcf86cd799439014"),
            Logs:      []ObjectId{"507f1f77bcf86cd799439015"},
        },
    }

    data, _ := json.Marshal(map[string]interface{}{
        "rows": []User{user, user}, // 多个用户组成 rows 数组
    })
    fmt.Println(string(data))
    // 输出:
    // {"rows":[["kiz","507f1f77bcf86cd799439011","2014-01-01T00:00:00Z","2014-01-01T00:00:00Z","2014-01-01T00:00:00Z","507f1f77bcf86cd799439012","507f1f77bcf86cd799439013","507f1f77bcf86cd799439014",["507f1f77bcf86cd799439015"]],["kiz","507f1f77bcf86cd799439011","2014-01-01T00:00:00Z","2014-01-01T00:00:00Z","2014-01-01T00:00:00Z","507f1f77bcf86cd799439012","507f1f77bcf86cd799439013","507f1f77bcf86cd799439014",["507f1f77bcf86cd799439015"]]]}
}

⚠️ 注意事项与最佳实践

  • 字段顺序即契约:数组下标严格对应业务含义(如 row[0] 永远是 Name),前端必须与后端约定一致,建议配合常量定义索引(如 const NameIdx = 0)。
  • 嵌入结构体需显式展开:json.Marshaler 不自动递归处理嵌入字段,必须在 MarshalJSON() 中手动访问 u.Id、u.CreatedAt 等 —— 这反而是优势:完全可控、无反射开销。
  • 时间与 ID 格式化:原始 time.Time 和 bson.ObjectId 无法直接 JSON 序列化,务必提前调用 .Format() 或 .Hex() 转为字符串。
  • 反向解析(Unmarshal):如需从数组还原结构体,应同时实现 UnmarshalJSON([]byte) error,使用 json.Unmarshal 解析为 []interface{} 后,按序赋值(注意类型断言和指针接收器)。
  • 性能考量:相比反射方案(如 s2a 函数),此方法零反射、编译期确定、内存分配可控,适合高频 API 场景。

✅ 总结

无需复杂反射或泛型(Go 1.18+ 亦可扩展为泛型版本),仅通过实现 json.Marshaler 接口,即可优雅、高效地将含嵌入结构体的 Go 类型序列化为前端友好的扁平数组。它语义清晰、调试简单、性能优异,是面向特定消费方(如 JS 表格组件)输出数据的理想选择。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

js 前端 json 键值对

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2375

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3942

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1316

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4599

7

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

2023.10.24

6444

49

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1889

3

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.06.27

1231

7

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

1089

5

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.25

3620

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.4万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.9万人学习