Go语言json.Marshal多态机制

什么是 Go语言json.Marshal多态机制

在Go语言中，json.Marshal提供了强大的多态机制，允许不同类型的结构体根据自己的需求定制JSON序列化行为。这种机制主要通过实现json.Marshaler接口来实现。

Go语言的json.Marshal多态机制提供了强大的序列化定制能力，主要应用场景包括：

• 数据脱敏：隐藏或掩码敏感信息
• 权限控制：根据用户角色显示不同数据
• API版本兼容：同一数据结构支持多种输出格式
• 性能优化：减少不必要的字段序列化
• 日志安全：确保日志中不包含敏感信息
  通过实现MarshalJSON方法，我们可以在保持代码简洁的同时，实现复杂的业务需求。这种机制体现了Go语言接口设计的优雅性和实用性。

主要用于需要定制JSON输出的场景。json.Marshal多态机制的核心就是：当标准的JSON序列化无法满足需求时，提供自定义输出格式的能力。
每个自定义MarshalJSON都对应一个具体的业务需求

json.Marshaler接口

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

任何实现了MarshalJSON() ([]byte, error)方法的类型，在调用json.Marshal时都会自动使用其自定义的序列化逻辑。

demo场景1：用户信息脱敏

package mainimport ("encoding/json""fmt""strings"
)// 用户基础信息
type User struct {ID       int64  `json:"id"`Username string `json:"username"`Email    string `json:"email"`Phone    string `json:"phone"`Password string `json:"-"` // 完全隐藏
}// 实现自定义JSON序列化
func (u User) MarshalJSON() ([]byte, error) {// 创建一个匿名结构体用于序列化type UserAlias User // 避免无限递归return json.Marshal(&struct {UserAliasEmail string `json:"email"`Phone string `json:"phone"`}{UserAlias: UserAlias(u),Email:     maskEmail(u.Email),Phone:     maskPhone(u.Phone),})
}// 邮箱脱敏函数
func maskEmail(email string) string {if email == "" {return ""}parts := strings.Split(email, "@")if len(parts) != 2 {return email}username := parts[0]domain := parts[1]if len(username) <= 2 {return email}masked := string(username[0]) + "***" + string(username[len(username)-1])return masked + "@" + domain
}// 手机号脱敏函数
func maskPhone(phone string) string {if len(phone) < 7 {return phone}return phone[:3] + "****" + phone[len(phone)-4:]
}func main() {user := User{ID:       12345,Username: "john_doe",Email:    "john.doe@company.com",Phone:    "13800138000",Password: "secret123", // 这个字段不会出现在JSON中}data, err := json.Marshal(user)if err != nil {panic(err)}fmt.Println("脱敏后的用户信息:")fmt.Println(string(data))
}

输出：

{"id": 12345,"username": "john_doe","email": "j***e@company.com","phone": "138****8000"
}