Node.js 中 http 模块的深度剖析与实战应用小结

import http from 'http';

// 本地回环地址是一个特殊的ip地址（通常为 127.0.0.1），主要用于同一台主机的通信和测试
const hostname = '127.0.0.1'; // 重点：服务器监听的ip地址（本地回环地址），意味着服务器只接受来自本机的网络请求
const port = 8008; // 重点：服务器监听的端口号

const server = http.createServer((request, response) => {
  // 后续详细的请求与响应处理逻辑将在此展开
});

// ------ request
// request.method: http 请求的方法
// request.url: 请求的 url
console.log(`${request.method} ${request.url}`);
// 重点：可获取到诸如 GET、POST 等 HTTP 请求的具体方法以及请求指向的 URL 路径，这对于根据不同请求类型和目标路径来分流处理业务逻辑至关重要。例如，若为 GET 请求且路径为 /user，可针对性地查询用户信息并返回。
// console.log(request.headers) //http 请求的头部信息
console.log("referer:", request.headers.referer);
// 重点：referer 字段记录了发送请求的页面地址，服务器借此可精准知晓请求的来源，比如用于追踪用户是从哪个页面跳转而来，在分析用户行为、防盗链等场景应用广泛。
console.log("user-agent:", request.headers['user-agent']);
// 重点：user-agent 字符串详细描述了客户端使用的浏览器类型、版本以及操作系统等关键信息，服务器依据此能够针对不同客户端特性优化响应内容，实现兼容性适配，如为老旧浏览器提供简化版页面。
console.log("\n"); // 换行

// ------ response
response.statusCode = 200; // 重点：200 状态码表示请求成功，这是最常见的 HTTP 状态码之一，用于告知客户端请求已被服务器顺利接收并处理，不同的业务场景可能对应不同的状态码，如 404 表示资源未找到，500 表示服务器内部错误等，合理设置状态码有助于客户端正确解读服务器反馈。
response.setHeader('Content-Type', 'text/html; charset=UTF-8');
// 重点：设置内容类型为 'text/html; charset=UTF-8' 的响应头，明确告知客户端返回的数据格式为 HTML 文本且采用 UTF-8 编码，确保客户端能正确解析渲染服务器返回的内容，避免出现乱码等问题，根据返回数据类型不同（如 JSON、XML 等），需相应调整此头部设置。
// response.end("<h3>dengruicode.com</h3>") // 发送响应数据并结束响应
response.write("<h3>dengruicode.com</h3>");
response.end();
// 重点：先使用 response.write 写入要返回给客户端的具体内容，这里是一段简单的 HTML 标题，然后通过 response.end 正式结束响应过程，向客户端发送完整的响应数据，二者配合完成响应信息的传输。若有大量数据需要分多次发送，可多次调用 write 方法，最后以 end 收尾。

// ------ url http://127.0.0.1:8008/?id=1&web=dengruicode.com
let fullUrl = `http://${hostname}:${port}${request.url}`;
// 重点：首先巧妙地将服务器监听的地址、端口与客户端请求的 URL 部分拼接起来，构造出完整的 URL 字符串，为后续准确解析参数奠定基础。
let urlObj = new URL(fullUrl);
// 利用 URL 构造函数创建一个 URL 对象，该对象具备强大的解析功能，能将复杂的 URL 分解为各个有意义的组成部分，如协议、主机、路径、查询参数等，方便后续按需求提取信息。
const queryObj = new URLSearchParams(urlObj.search);
// 重点：结合 URL 对象中的 search 属性（其包含了查询参数部分），通过 URLSearchParams 构造函数进一步转化为查询参数对象，此时便可以轻松获取具体的参数值。
console.log("web:", queryObj.get('web'));
// 展示了如何精准获取名为 'web' 的参数值，在实际业务中，依据这些参数值可灵活调整服务器返回的数据内容，如根据用户 ID、查询关键词等参数提供个性化的服务。

server.listen(port, hostname, () => {
  console.log(`服务器已启动: http://${hostname}:${port}`);
});