Golang适配器模式：XML转JSON改造教程

本文深入探讨了在Golang项目中如何通过适配器模式安全、高效地将遗留XML接口改造为符合Swagger规范的JSON API，强调适配器并非临时过渡方案，而是隔离变更风险、保障多系统稳定调用的必要边界；文章从设计原则（如对外只暴露JSON契约、严守字段映射与结构一致性）、常见陷阱（空值处理、类型错位、嵌套panic防范）到职责划分（坚决剥离HTTP网络逻辑，保持适配器无副作用、易测可控）层层展开，并点明核心挑战实为业务语义对齐——所有隐含规则必须显式表达，确保可维护性与长期可演进性。

为什么不能直接改老代码，而要加适配器

因为旧 XML 接口被多个下游系统调用，上线时间紧、测试成本高，动 ParseXML 或 WriteXML 会触发全链路回归；新 JSON API 又必须按 Swagger 定义的字段名和嵌套结构返回。硬改等于重写，风险远高于包一层——适配器不是过渡方案，是隔离变更的必要边界。

Adapter 结构体怎么设计才不泄漏 XML 细节

关键在「只暴露 JSON 侧契约」：Adapter 不该有 xml.Unmarshal 相关字段，也不该把 XMLNode 类型透传出去。它只接收原始 XML 字节或字符串，只返回符合新 API 的 struct 指针或 error。

• 输入用 []byte 或 io.Reader，避免依赖具体 XML 解析库（比如别用 xml.Decoder 做成员变量）
• 输出 struct 必须用 json tag，且字段名与新 API 文档完全一致，例如 UserID 对应 "user_id"
• 绝不导出内部 XML 模型，哪怕只是临时解析用，也定义在 adapter 包内匿名 struct 或私有类型里

// ✅ 正确：对外只承诺 JSON 结构
type UserJSON struct {
    UserID   int    `json:"user_id"`
    FullName string `json:"full_name"`
}

func (a *XMLToJSONAdapter) Convert(xmlData []byte) (*UserJSON, error) { ... }

// ❌ 错误：把 XML 模型暴露出去
type UserXML struct { XMLName xml.Name `xml:"user"` ... }
func (a *XMLToJSONAdapter) Parse(xmlData []byte) (*UserXML, error) { ... }

处理字段映射时最容易踩的空指针和类型错位

XML 常有可选字段、空字符串、数字混成字符串（如 25 vs ），JSON API 却要求 int 字段非空。直接 strconv.Atoi 会 panic，用 xml.Unmarshal 到 struct 再转又容易漏判零值。

• 对数值字段，先用 strings.TrimSpace 清空再判断是否为空，再尝试转换，失败就返回明确 error（如 fmt.Errorf("invalid age: %q", rawAge)）
• 对布尔字段，XML 常用 "true"/"false"、"1"/"0"、甚至空标签，统一收口到一个 parseBoolFromXML 工具函数
• 嵌套结构别硬解两层，用 xml.Unmarshal 到中间 struct 后，立刻校验关键字段是否存在，避免后续访问 user.Profile.Name 时 panic

要不要在 Adapter 里做 HTTP 请求转发

不要。Adapter 的职责是数据格式转换，不是网络调度。如果旧接口是 HTTP XML 端点，应该由上层 handler 调用 http.Client 获取响应体，再把 resp.Body 交给 Adapter；同理，新 API 的响应写入也该由 handler 控制 json.NewEncoder(w)。

• Adapter 保持无副作用，方便单元测试（喂入字节，断言输出 struct）
• HTTP 超时、重试、鉴权这些逻辑放在 handler 层，和 Adapter 解耦
• 如果真要复用连接池，把 *http.Client 当参数传进 Convert 方法，而不是存在 Adapter 实例里

复杂点永远在字段语义对齐——比如 XML 里的 active 要映射成 JSON 的 "status": 1，这种业务规则不能藏在适配器深处，得显式写成映射表或 switch 分支，否则半年后没人记得当初为什么 active=1。

本篇关于《Golang适配器模式：XML转JSON改造教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！