![go语言中将[]uint8或[]byte序列化为json数字数组的策略](https://img.php.cn/upload/article/001/246/273/175894345931093.jpg)
Go语言的encoding/json包在处理[]byte类型时,有一个特殊的规则:它不会将其视为普通的切片(slice)并编码为JSON数组,而是将其视为字节流,并使用Base64编码将其转换为JSON字符串。例如,一个包含[]uint8{'h', 'e', 'l', 'l', 'o'}的结构体,在默认序列化后,[]uint8部分会被编码为"aGVsbG8="这样的Base64字符串,而不是[104,101,108,108,111]这样的数字数组。当我们需要将这些字节表示为数字数组时,就需要自定义序列化逻辑。
json.Marshaler接口提供了一个MarshalJSON() ([]byte, error)方法,允许我们完全控制特定类型如何被序列化为JSON。通过实现这个接口,我们可以重写[]uint8的默认序列化行为。
这种方法适用于当[]uint8字段只在特定结构体中使用,且该结构体的JSON序列化逻辑需要特殊定制时。
package main
import (
"encoding/json"
"fmt"
"strings"
)
// Test 结构体包含一个字符串字段和一个[]uint8字段
type Test struct {
Name string
Array []uint8
}
// MarshalJSON 为Test类型实现json.Marshaler接口
func (t *Test) MarshalJSON() ([]byte, error) {
var arrayStr string
if t.Array == nil {
// 如果切片为nil,则JSON表示为null
arrayStr = "null"
} else {
// 将[]uint8转换为形如 "[104 101 108 108 111]" 的字符串
// strings.Fields会将其分割成 [" [104", "101", "108", "108", "111] "]
// strings.Join再用逗号连接,得到 "[104,101,108,108,111]"
arrayStr = strings.Join(strings.Fields(fmt.Sprintf("%d", t.Array)), ",")
}
// 使用fmt.Sprintf构建最终的JSON字符串
// %q 格式化字符串为带双引号的JSON字符串
// %s 格式化arrayStr为原始字符串,因为arrayStr已经包含了JSON数组的括号
jsonResult := fmt.Sprintf(`{"Name":%q,"Array":%s}`, t.Name, arrayStr)
return []byte(jsonResult), nil
}
func main() {
// 示例1: 包含有效[]uint8的结构体
t1 := &Test{"Go", []uint8{'h', 'e', 'l', 'l', 'o'}}
m1, err := json.Marshal(t1)
if err != nil {
fmt.Println("Error marshaling t1:", err)
}
fmt.Printf("Marshaled t1: %s\n", m1) // {"Name":"Go","Array":[104,101,108,108,111]}
// 示例2: 包含nil []uint8的结构体
t2 := &Test{"NilArray", nil}
m2, err := json.Marshal(t2)
if err != nil {
fmt.Println("Error marshaling t2:", err)
}
fmt.Printf("Marshaled t2: %s\n", m2) // {"Name":"NilArray","Array":null}
// 示例3: 包含空[]uint8的结构体 (空切片与nil切片不同)
t3 := &Test{"EmptyArray", []uint8{}}
m3, err := json.Marshal(t3)
if err != nil {
fmt.Println("Error marshaling t3:", err)
}
fmt.Printf("Marshaled t3: %s\n", m3) // {"Name":"EmptyArray","Array":[]}
}代码解析:
立即学习“go语言免费学习笔记(深入)”;
这种方法更具通用性和可重用性。当多个结构体或多个地方需要将[]uint8序列化为JSON数字数组时,可以定义一个包装类型,并为其实现MarshalJSON。
package main
import (
"encoding/json"
"fmt"
"strings"
)
// JSONableUint8Slice 是一个基于[]uint8的自定义类型
type JSONableUint8Slice []uint8
// MarshalJSON 为JSONableUint8Slice类型实现json.Marshaler接口
func (u JSONableUint8Slice) MarshalJSON() ([]byte, error) {
var result string
if u == nil {
// 如果切片为nil,则JSON表示为null
result = "null"
} else {
// 逻辑与策略一相同,将[]uint8转换为JSON数字数组字符串
result = strings.Join(strings.Fields(fmt.Sprintf("%d", u)), ",")
}
return []byte(result), nil
}
// AnotherTest 结构体使用自定义的JSONableUint8Slice类型
type AnotherTest struct {
Name string
Data JSONableUint8Slice
Value int
}
func main() {
// 示例1: 包含有效数据的结构体
at1 := &AnotherTest{"GoLang", []uint8{'w', 'o', 'r', 'l', 'd'}, 123}
m1, err := json.Marshal(at1)
if err != nil {
fmt.Println("Error marshaling at1:", err)
}
fmt.Printf("Marshaled at1: %s\n", m1) // {"Name":"GoLang","Data":[119,111,114,108,100],"Value":123}
// 示例2: 包含nil切片的结构体
at2 := &AnotherTest{"NilData", nil, 456}
m2, err := json.Marshal(at2)
if err != nil {
fmt.Println("Error marshaling at2:", err)
}
fmt.Printf("Marshaled at2: %s\n", m2) // {"Name":"NilData","Data":null,"Value":456}
}代码解析:
立即学习“go语言免费学习笔记(深入)”;
这种方法的好处在于:
var b strings.Builder
b.WriteString("[")
for i, v := range u {
if i > 0 {
b.WriteString(",")
}
b.WriteString(strconv.Itoa(int(v))) // 需要导入 "strconv"
}
b.WriteString("]")
return []byte(b.String()), nil通过实现json.Marshaler接口,Go语言开发者可以灵活地控制自定义类型的JSON序列化行为,从而满足特定的数据格式需求,即使面对[]byte这种有特殊默认处理的类型也能轻松应对。选择哪种策略取决于具体的应用场景和代码组织偏好。
以上就是Go语言中将[]uint8或[]byte序列化为JSON数字数组的策略的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号