告别格式烦恼：Express JSON/XML响应处理实战指南

告别格式烦恼：Express JSON/XML响应处理实战指南

【免费下载链接】express Fast, unopinionated, minimalist web framework for node. 项目地址: https://gitcode.com/GitHub_Trending/ex/express

你是否还在为Express接口返回不同数据格式头疼？客户要XML报表、移动端要JSON数据，难道需要写两套接口？本文将通过content-negotiation示例，教你用30行代码实现智能数据序列化，让一套接口自动适配多种格式需求。

数据序列化（Data Serialization）基础

数据序列化是将内存中的JavaScript对象转换为网络传输格式的过程。Express作为极简Web框架，默认提供JSON序列化支持，通过res.json()方法可直接将对象转为JSON字符串。但企业级应用常需支持XML等格式，这就需要掌握内容协商（Content Negotiation）技术。

5分钟实现JSON响应

Express内置的JSON序列化能力开箱即用。以下是web-service示例中的经典用法：

app.get('/api/users', (req, res) => {
  const users = [{ id: 1, name: '张三' }, { id: 2, name: '李四' }];
  res.json(users); // 自动设置Content-Type: application/json
});

上述代码会返回标准JSON响应：

[{"id":1,"name":"张三"},{"id":2,"name":"李四"}]

XML响应处理方案

Express没有内置XML序列化，需借助xmlbuilder库。通过content-negotiation/users.js的实现思路，我们可以这样扩展：

const xmlbuilder = require('xmlbuilder');

app.get('/api/users', (req, res) => {
  const users = [{ id: 1, name: '张三' }, { id: 2, name: '李四' }];
  
  if (req.accepts('xml')) {
    const root = xmlbuilder.create('users');
    users.forEach(user => root.ele('user', { id: user.id }, user.name));
    res.set('Content-Type', 'application/xml');
    res.send(root.end({ pretty: true }));
  } else {
    res.json(users);
  }
});

智能内容协商实现

Express的req.accepts()方法可根据请求头自动选择响应格式。content-negotiation/index.js展示了最佳实践：

app.get('/users', (req, res) => {
  res.format({
    'application/json': () => res.json(users),
    'application/xml': () => {
      const root = xmlbuilder.create('users');
      users.forEach(u => root.ele('user', { id: u.id }, u.name));
      res.send(root.end());
    },
    'text/plain': () => res.send(users.map(u => u.name).join('\n'))
  });
});

内容协商流程图

生产环境优化建议

1. 格式校验：使用express-validator验证输入数据
2. 错误处理：统一异常响应格式，参考error示例
3. 性能优化：对大数据集使用流式响应，避免内存溢出

通过本文介绍的内容协商技术，你可以让Express接口同时支持JSON、XML等多种格式，满足不同客户端需求。完整示例代码可查看examples/content-negotiation/目录，建议结合官方文档深入学习。

收藏本文，下次遇到格式转换需求时，30行代码即可快速解决！

【免费下载链接】express Fast, unopinionated, minimalist web framework for node. 项目地址: https://gitcode.com/GitHub_Trending/ex/express