Micro框架HTTP响应内容协商：Accept头与格式选择终极指南

Micro框架HTTP响应内容协商：Accept头与格式选择终极指南

【免费下载链接】micro 项目地址: https://gitcode.com/gh_mirrors/micro/micro

在现代Web开发中，内容协商是构建灵活API的关键技术。Micro框架通过智能的HTTP响应内容协商机制，让你的微服务能够根据客户端的Accept头自动选择合适的响应格式，极大地提升了开发效率和使用体验。🚀

什么是HTTP内容协商？

HTTP内容协商是一种机制，允许客户端和服务器就传输内容的格式达成一致。当客户端发送请求时，可以通过Accept头指定期望的响应格式，而Micro框架能够自动识别这些请求并返回合适的格式。

Micro框架的内容协商机制

Micro框架内置了强大的内容协商功能，主要通过 send 函数实现。当你的微服务返回数据时，Micro会根据数据类型自动设置合适的Content-Type头：

• JSON对象：自动序列化为JSON并设置application/json; charset=utf-8
• 字符串：直接返回文本内容
• Buffer：作为二进制流返回，设置application/octet-stream
• Stream：管道传输，同样设置为application/octet-stream

智能响应格式选择

在 packages/micro/src/lib/index.ts 中，Micro框架的 send 函数实现了智能的内容协商：

// 对于JSON对象
if (typeof obj === 'object' || typeof obj === 'number') {
  str = JSON.stringify(obj);
  res.setHeader('Content-Type', 'application/json; charset=utf-8');
}

实际应用场景

JSON API响应

当你返回JavaScript对象时，Micro会自动将其序列化为JSON格式：

module.exports = async (req, res) => {
  return { message: 'Hello World', status: 'success' };
}

客户端将收到：

Content-Type: application/json; charset=utf-8
{"message":"Hello World","status":"success"}

文本内容响应

对于简单的字符串响应，Micro会保持原始格式：

module.exports = async (req, res) => {
  return 'Welcome to Micro';
};

高级内容协商技巧

自定义内容类型

虽然Micro提供了自动协商，但你也可以手动设置Content-Type：

const { send } = require('micro');

module.exports = async (req, res) => {
  res.setHeader('Content-Type', 'text/html');
  return '<h1>Hello World</h1>';
};

错误处理中的内容协商

Micro框架的错误处理也支持内容协商。在 packages/micro/src/lib/error.ts 中，错误信息会根据数据类型自动格式化：

throw createError(400, 'Invalid request data');

最佳实践

1. 信任框架：让Micro自动处理大多数内容协商场景
2. 一致性：保持API响应格式的一致性
3. 适当的手动控制：在特殊情况下手动设置Content-Type

总结

Micro框架的HTTP响应内容协商机制为开发者提供了极大的便利。通过智能的Accept头处理和自动格式选择，你可以专注于业务逻辑，而无需担心响应格式的细节处理。

无论是构建RESTful API还是简单的微服务，Micro的内容协商功能都能让你的代码更加简洁高效。💪

【免费下载链接】micro 项目地址: https://gitcode.com/gh_mirrors/micro/micro