当前位置：首页 > news >正文

http 模块

news 来源：原创 2025/5/21 9:19:21

在现代 Web 开发中，HTTP 协议是客户端与服务器之间通信的基础。Node.js 自带的 http 模块提供了一种简单而强大的方式来创建 HTTP 服务器和客户端，使得开发者可以直接使用 JavaScript 编写高效的网络应用。本文将详细介绍 http 模块的基本概念、核心功能以及如何利用它构建一个基本的 HTTP 服务器。

什么是 http 模块？

基本概念

http 模块是 Node.js 标准库的一部分，它提供了用于创建 HTTP 服务器和客户端的功能。无论是搭建 RESTful API 还是处理动态网页请求，http 模块都能提供必要的工具支持。通过这个模块，你可以轻松地监听 HTTP 请求、发送响应以及处理各种类型的 HTTP 方法（如 GET、POST 等）。

模块导入

要使用 http 模块，首先需要将其导入到你的项目中：

const http = require('http');

创建 HTTP 服务器

最简单的服务器示例

下面是一个最基础的例子，展示了如何使用 http 模块创建一个 HTTP 服务器并监听特定端口上的请求：

const http = require('http');

// 创建服务器实例
const server = http.createServer((req, res) => {
    // 设置响应头
    res.writeHead(200, { 'Content-Type': 'text/plain' });
    // 发送响应数据
    res.end('Hello World\n');
});

// 监听指定端口
server.listen(3000, () => {
    console.log('Server running at http://localhost:3000/');
});

在这个例子中，每当有新的 HTTP 请求到达时，回调函数就会被调用，并且可以通过 req 对象获取请求信息，通过 res 对象发送响应信息。

处理不同的 HTTP 方法

除了 GET 请求外，你还可以根据不同的 HTTP 方法执行不同的逻辑。例如，以下代码展示了如何区分 GET 和 POST 请求：

const server = http.createServer((req, res) => {
    if (req.method === 'GET') {
        res.writeHead(200, { 'Content-Type': 'text/plain' });
        res.end('This is a GET request.\n');
    } else if (req.method === 'POST') {
        let body = '';
        req.on('data', chunk => {
            body += chunk.toString(); // 将数据片段转换为字符串并拼接
        });
        req.on('end', () => {
            res.writeHead(200, { 'Content-Type': 'text/plain' });
            res.end(`Received POST data: ${body}\n`);
        });
    } else {
        res.writeHead(405, { 'Content-Type': 'text/plain' });
        res.end('Method Not Allowed\n');
    }
});

发送 HTTP 请求

除了作为服务器端框架外，http 模块也可以用来发起 HTTP 请求。这在开发爬虫或与其他服务进行交互时非常有用。

发起 GET 请求

下面是一个使用 http 模块发起 GET 请求的例子：

const options = {
    hostname: 'www.example.com',
    port: 80,
    path: '/',
    method: 'GET'
};

const req = http.request(options, (res) => {
    let data = '';

    // 数据接收事件
    res.on('data', (chunk) => {
        data += chunk;
    });

    // 请求结束事件
    res.on('end', () => {
        console.log(data);
    });
});

// 错误处理
req.on('error', (e) => {
    console.error(`Request failed: ${e.message}`);
});

// 结束请求
req.end();

发起 POST 请求

对于 POST 请求，你需要设置请求体并在请求头中指定内容类型：

const postData = JSON.stringify({
    message: 'Hello from Node.js'
});

const options = {
    hostname: 'www.example.com',
    port: 80,
    path: '/path',
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Content-Length': Buffer.byteLength(postData)
    }
};

const req = http.request(options, (res) => {
    let data = '';

    res.on('data', (chunk) => {
        data += chunk;
    });

    res.on('end', () => {
        console.log(data);
    });
});

req.on('error', (e) => {
    console.error(`Request failed: ${e.message}`);
});

req.write(postData);
req.end();

高级功能

使用 HTTPS

为了保证数据传输的安全性，通常需要使用 HTTPS 而不是 HTTP。Node.js 提供了 https 模块来支持 SSL/TLS 加密连接。你需要准备好 SSL 证书和私钥文件，然后按照类似的方式配置服务器：

const https = require('https');
const fs = require('fs');

const options = {
    key: fs.readFileSync('path/to/key.pem'),
    cert: fs.readFileSync('path/to/cert.pem')
};

https.createServer(options, (req, res) => {
    res.writeHead(200);
    res.end('Hello Secure World\n');
}).listen(443);