Node.jsHTTP模块详解：创建服务器、响应请求与客户端请求
Node.js 的 http 模块是 Node.js 核心模块之一，它允许你创建HTTP服务器和客户端。以下是一些关键知识点和代码示例：
1. 创建HTTP 服务器
使用 http.createServer() 方法可以创建一个新的 HTTP 服务器实例。这个方法接受一个回调函数，该函数在服务器接收到请求时被调用，参数为 req （请求对象）和 res （响应对象）。
const http = require('http');
const server = http.createServer((req, res) => {
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end('Hello World
');
});
server.listen(3000, () => {
console.log(`服务器运行在 http://localhost:3000/`);
});
2. 响应方法
Node.js 的 http 模块提供了多种方法来响应 HTTP 请求。以下是 http.ServerResponse 对象的一些常用方法及其作用：
-
作用 ：发送一个 HTTP 响应头到客户端。 statusCode 是状态码， reasonPhrase 是可选的状态短语（例如：“OK”）， headers 是一个包含头部字段的对象。
-
示例 ：
```
res.writeHead(200, { 'Content-Type': 'text/plain' });
```
-
作用 ：发送一个 HTTP 响应体的片段。 chunk 是要发送的数据块， encoding 是数据的编码，默认为 'utf8' 。
-
示例 ：
```
res.write('Hello, ');
res.write('World!', 'utf8');
```
-
作用 ：发送 HTTP 响应体的最后一个片段，并关闭连接。如果提供了 data ，则会先发送这个数据。
-
示例 ：
```
res.end('This is the end of the response.');
```
-
作用 ：设置响应头字段 name 的值为 value 。
-
示例 ：
```
res.setHeader('Content-Type', 'application/json');
```
-
作用 ：返回响应头字段 name 的值。
-
示例 ：
```
const contentType = res.getHeader('Content-Type');
```
-
作用 ：移除响应头字段 name 。
-
示例 ：
```
res.removeHeader('Content-Type');
```
-
作用 ：添加 HTTP 尾部字段，这些字段在响应体之后发送。
-
示例 ：
```
res.addTrailers({ 'Content-MD5': '7895bf4e1c23b21b' });
```
-
作用 ：刷新响应体缓冲区，发送任何缓冲的数据到客户端。
-
示例 ：
```
res.flush();
```
-
作用 ：结束响应。如果响应体已经发送完毕，这个方法没有效果。如果响应体还在发送中，这个方法会发送剩余的数据。
-
示例 ：
```
res.finish();
```
* **作用**：设置响应的超时时间。如果响应在 `msecs` 毫秒内没有结束，那么响应将被自动结束。
* **示例**：
res.setTimeout(3000, () => {
console.log('Response timed out');
});
* **作用**：销毁流，这将发送一个 RST 包到 TCP 层，立即关闭连接。
* **示例**：
res.destroy(new Error('Something went wrong'));
这些方法提供了控制 HTTP 响应的灵活性，允许开发者根据需要发送不同类型的响应。在实际应用中，你可能会根据业务逻辑和客户端的需求来选择使用这些方法。
3. 请求方法
在Node.js中， http 模块提供了 request 方法来发送客户端请求到服务器。以下是 http.request 方法的一些常用方式：
const http = require(‘http’);
const options = {
hostname: ‘www.example.com’,
port: 80,
path: ‘/path’,
method: ‘GET’
};
const req = http.request(options, (res) => {
console.log( 状态码: ${res.statusCode} );
res.on(‘data’, (chunk) => {
console.log( 收到数据块: ${chunk} );
});
res.on(‘end’, () => {
console.log(‘响应结束’);
});
});
req.on(‘error’, (e) => {
console.error( 请求遇到问题: ${e.message} );
});
// 结束请求
req.end();
const http = require(‘http’);
const querystring = require(‘querystring’);
const postData = querystring.stringify({
key1: ‘value1’,
key2: ‘value2’
});
const options = {
hostname: ‘www.example.com’,
port: 80,
path: ‘/path’,
method: ‘POST’,
headers: {
‘Content-Type’: ‘application/x-www-form-urlencoded’,
‘Content-Length’: Buffer.byteLength(postData)
}
};
const req = http.request(options, (res) => {
// 处理响应
});
req.on(‘error’, (e) => {
// 处理请求错误
});
req.write(postData);
req.end();
const http = require(‘http’);
const JSON.stringify;
const data = {
key1: ‘value1’,
key2: ‘value2’
};
const options = {
hostname: ‘www.example.com’,
port: 80,
path: ‘/path’,
method: ‘POST’,
headers: {
‘Content-Type’: ‘application/json’,
‘Content-Length’: Buffer.byteLength(JSON.stringify(data))
}
};
const req = http.request(options, (res) => {
// 处理响应
});
req.on(‘error’, (e) => {
// 处理请求错误
});
req.write(JSON.stringify(data));
req.end();
const http = require(‘http’);
const querystring = require(‘querystring’);
const params = {
key1: ‘value1’,
key2: ‘value2’
};
const options = {
hostname: ‘www.example.com’,
port: 80,
path: /path?${querystring.stringify(params)} ,
method: ‘GET’
};
const req = http.request(options, (res) => {
// 处理响应
});
req.on(‘error’, (e) => {
// 处理请求错误
});
req.end();
const http = require(‘http’);
let redirectCount = 0;
const options = {
hostname: ‘www.example.com’,
port: 80,
path: ‘/path’,
method: ‘GET’
};
const req = http.request(options, (res) => {
if (res.statusCode === 301 || res.statusCode === 302) {
if (redirectCount < 10) {
redirectCount++;
const location = res.headers.location;
options.path = location;
const newReq = http.request(options, (res) => {
// 处理响应
});
newReq.end();
} else {
console.log(‘Too many redirects’);
}
} else {
// 处理响应
}
});
req.on(‘error’, (e) => {
// 处理请求错误
});
req.end();
这些示例展示了如何使用Node.js的 http 模块发送不同类型的HTTP请求，包括基本的GET请求、POST请求、发送JSON数据、处理GET参数和自动处理重定向。
4. 处理 POST 请求
对于 POST 请求，你可以监听请求对象的 data 和 end 事件来处理请求体中的数据。
const http = require('http');
const server = http.createServer((req, res) => {
if (req.method === 'POST' && req.url === '/submit') {
let body = '';
req.on('data', chunk => {
body += chunk.toString();
});
req.on('end', () => {
res.writeHead(200, { 'Content-Type': 'text/plain' });
res.end(`Received data: ${body}`);
});
} else {
res.writeHead(404, { 'Content-Type': 'text/plain' });
res.end('404 Not Found');
}
});
server.listen(3000, () => {
console.log('Server running at http://localhost:3000/');
});
5. Http状态码
在Node.js的 http 模块中，设置响应头和状态码是通过 http.ServerResponse 对象的方法 writeHead 来完成的。以下是如何设置响应头和状态码的示例：
const http = require('http');
const server = http.createServer((req, res) => {
// 设置状态码为200（OK），并设置响应头
res.writeHead(200, {
'Content-Type': 'text/plain', // mime类型
'Custom-Header': 'Custom Value'
});
// 发送响应体
res.end('Hello, World!');
});
server.listen(3000, () => {
console.log('Server running at http://localhost:3000/');
});
状态码的类型
HTTP状态码分为几种类型，每种类型表示不同的响应类别：
-
100 Continue ：表明客户端可以继续发送请求体。
-
101 Switching Protocols ：服务器根据客户端的请求切换到了不同的协议。
-
200 OK ：请求成功。
-
201 Created ：请求成功，并且服务器创建了新的资源。
-
202 Accepted ：请求已被接受，但未被执行。
-
301 Moved Permanently ：请求的资源已被永久移动到新位置。
-
302 Found ：请求的资源临时移动到另一个URI。
-
304 Not Modified ：如果请求的资源未修改，可以返回此状态码，无需再次发送资源内容。
-
400 Bad Request ：服务器无法理解请求，请求无效或格式错误。
-
401 Unauthorized ：请求需要用户的身份认证。
-
403 Forbidden ：服务器理解请求，但是拒绝执行。
-
404 Not Found ：服务器找不到请求的资源。
-
500 Internal Server Error ：服务器遇到了一个预料之外的情况，导致无法完成请求。
-
501 Not Implemented ：服务器不支持请求的功能，无法完成请求。
-
503 Service Unavailable ：服务器目前无法处理请求，可能是过载或停机维护。
状态码是HTTP协议的核心部分，它们为客户端提供了请求处理结果的标准化信息。正确使用状态码可以帮助客户端更好地理解服务器响应的含义，并据此进行适当的操作。
6. MIME类型
MIME（Multipurpose Internet Mail Extensions，多用途互联网邮件扩展）类型，也称为媒体类型，是一种标准，用于定义文件的格式和类型。在HTTP协议中，MIME类型用于告诉浏览器或接收端如何处理传输的数据。每个MIME类型由两部分组成：类型和子类型，中间用斜杠（/）分隔。
以下是一些常见的MIME类型及其描述：
-
text/html ：HTML文档。
-
text/css ：层叠样式表（CSS）。
-
text/javascript ：JavaScript代码。
-
text/plain ：纯文本文件。
-
text/xml ：XML文档。
-
image/gif ：GIF图片。
-
image/jpeg ：JPEG图片。
-
image/png ：PNG图片。
-
image/svg+xml ：SVG矢量图。
-
audio/mpeg ：MP3音频文件。
-
audio/wav ：WAV音频文件。
-
audio/ogg ：OGG音频文件。
-
video/mpeg ：MPEG视频文件。
-
video/mp4 ：MP4视频文件。
-
video/ogg ：OGG视频文件。
-
application/json ：JSON数据。
-
application/xml ：XML数据。
-
application/pdf ：PDF文档。
-
application/zip ：ZIP压缩文件。
-
application/javascript ：JavaScript代码（通常用于外链脚本）。
-
font/ttf ：TrueType字体。
-
font/otf ：OpenType字体。
-
font/woff ：Web Open Font Format。
-
font/woff2 ：Web Open Font Format 2.0。
-
multipart/form-data ：用于表单数据的编码类型。
-
binary/octet-stream ：任意的二进制数据。
-
application/octet-stream ：用于二进制文件，如可执行文件或字节流。
MIME类型在HTTP响应的 Content-Type 头字段中指定，告诉浏览器如何处理接收到的数据。同样，在发送HTTP请求时， Accept 请求头字段可以包含客户端能够处理的MIME类型列表，这允许服务器根据客户端的能力返回合适的数据格式。
7. 处理 JSON 数据
Node.js 的 http 模块可以处理 JSON 格式的数据，以下代码展示了如何返回 JSON 响应：
const http = require('http');
const server = http.createServer((req, res) => {
const jsonResponse = {
message: 'Hello, World!',
status: 'success',
};
res.writeHead(200, { 'Content-Type': 'application/json' });
res.end(JSON.stringify(jsonResponse));
});
server.listen(3000, () => {
console.log('Server running at http://localhost:3000/');
});
这些是 Node.js http 模块的一些基本知识点和代码示例，可以帮助你开始使用 Node.js 进行 HTTP 通信。
