Web 服务器开发 - 响应处理 - 设置响应头与状态码

Node.js Web 服务器开发 - 响应处理 - 设置响应头与状态码

在 Node.js 中开发 Web 服务器时，响应处理是至关重要的环节。其中，设置响应头和状态码能够帮助我们更好地与客户端进行交互，向客户端传递必要的信息，确保数据的正确传输和处理。本文将详细介绍如何在 Node.js 中设置响应头与状态码，并通过示例代码进行演示。

1. 响应头和状态码的作用

响应头

响应头包含了服务器向客户端传递的额外信息，例如内容类型、缓存控制、字符编码等。客户端可以根据这些信息来正确处理响应内容。常见的响应头有：
| 响应头名称 | 作用 |
| —— | —— |
| Content-Type | 指定响应内容的类型，如 text/html、application/json 等 |
| Content-Length | 表示响应内容的长度（字节数） |
| Cache-Control | 控制缓存策略，如 no-cache、max-age=3600 等 |

状态码

状态码用于表示请求的结果。不同的状态码代表不同的含义，客户端可以根据状态码来判断请求是否成功，以及如何处理响应。常见的状态码分类如下：
| 状态码范围 | 含义 |
| —— | —— |
| 1xx | 信息性状态码，表示请求已接收，继续处理 |
| 2xx | 成功状态码，表示请求已成功处理 |
| 3xx | 重定向状态码，表示需要进一步操作以完成请求 |
| 4xx | 客户端错误状态码，表示客户端请求有错误 |
| 5xx | 服务器错误状态码，表示服务器处理请求时发生错误 |

2. 在 Node.js 中设置响应头和状态码

示例代码

以下是一个简单的 Node.js Web 服务器示例，演示了如何设置响应头和状态码：

const http = require('http');
// 创建 HTTP 服务器
const server = http.createServer((req, res) => {
    // 设置响应状态码
    res.statusCode = 200;
    // 设置响应头
    res.setHeader('Content-Type', 'text/html; charset=utf-8');
    res.setHeader('Cache-Control', 'no-cache');
    // 发送响应内容
    res.end('<h1>Hello, World!</h1>');
});
// 监听端口
const port = 3000;
server.listen(port, () => {
    console.log(`服务器正在监听端口 ${port}`);
});

代码解释

1. 引入 http 模块：http 模块是 Node.js 内置的用于创建 HTTP 服务器和客户端的模块。
2. 创建 HTTP 服务器：使用 http.createServer() 方法创建一个 HTTP 服务器，并传入一个回调函数。该回调函数接收两个参数：req 表示请求对象，res 表示响应对象。
3. 设置响应状态码：通过 res.statusCode 属性设置响应状态码。在本例中，设置为 200 表示请求成功。
4. 设置响应头：使用 res.setHeader() 方法设置响应头。在本例中，设置了 Content-Type 和 Cache-Control 两个响应头。
5. 发送响应内容：使用 res.end() 方法发送响应内容。该方法会结束响应并将内容发送给客户端。
6. 监听端口：使用 server.listen() 方法监听指定的端口。当服务器启动成功后，会在控制台输出提示信息。

自定义状态码和响应头

除了常见的状态码和响应头，我们还可以自定义状态码和响应头。以下是一个示例：

const http = require('http');
const server = http.createServer((req, res) => {
    // 设置自定义状态码
    res.statusCode = 418; // I'm a teapot
    // 设置自定义响应头
    res.setHeader('X-Custom-Header', 'Hello, Node.js!');
    res.setHeader('Content-Type', 'text/plain; charset=utf-8');
    res.end('I\'m a teapot!');
});
const port = 3000;
server.listen(port, () => {
    console.log(`服务器正在监听端口 ${port}`);
});

在这个示例中，我们设置了一个自定义的状态码 418，并设置了一个自定义的响应头 X-Custom-Header。客户端在接收到响应时，会看到这个自定义的状态码和响应头。

3. 总结

在 Node.js 中开发 Web 服务器时，设置响应头和状态码是非常重要的。通过合理设置响应头和状态码，我们可以向客户端传递必要的信息，确保数据的正确传输和处理。在实际开发中，我们可以根据具体需求选择合适的状态码和响应头，并根据需要自定义状态码和响应头。

希望本文能够帮助你更好地理解和掌握在 Node.js 中设置响应头和状态码的方法。如果你有任何疑问或建议，欢迎留言讨论。