参考

描述

HTTP 模块

HTTP 模块是 NodeJS 中核心的内置模块，你可以通过该模块搭建 HTTP 或 HTTPS 服务器，而无需像 PHP 等服务器端语言需要其他软件（Aphche、Nginx、IIS等）提供服务器功能。

你可以向运行在 NodeJS 运行时中的 JavaScript 文件中添加如下代码以导入该模块。

const http = require('http');

搭建 HTTP 服务器

http.createServer()

在 NodeJS 中，你可以通过 http.createServer() 创建一个服务器对象，我们可以通过这个服务器对象来实现许多功能。所以，请记住它：

http.createServer([, requestListener])

注：

1. 你可以向 http.createServer() 方法传递一个回调函数以指定当服务器端接收到客户端的请求时需要执行的回调函数。该函数可以由两个形参，用以接收 http.IncomingMessage 对象（该对象代表一个客户端请求对象） 及 http.ServerResponse 对象（该对象代表一个服务器端响应对象）。
2. 如果你没有为 http.createServer() 方法传递一个回调函数，那么你可以通过 http.createServer() 返回的服务器对象的 on 方法来监听 request 事件并为该事件指定当服务器端接收到客户端的请求时需要执行的回调函数。就像这样：

const http = require('http');


const server = http.createServer();
server.on('request', (req, res) => {
    // 此处存放指定当服务器端接收到客户端的
    // 请求时需要执行的 JavaScript 代码。
});

监听

你可以通过服务器对象的 listen() 来监听某个端口，计算机可以向这个端口发送请求与服务器进行交互。

server.listen(port, [host], [backlog], [callback]);

其中：

注：

当服务器开始监听后，将触发 listening 事件。如果你没有为 server.listen() 提供一个回调函数来指定服务器开始监听时需要进行的处理。那么，你可以通过 server.on() 方法来监听 listening 事件并为其指定服务器开始监听时需要调用的回调函数。

检测服务器端口是否被占用

在创建服务器时，你需要为服务器指定一个监听端口。如果该端口已经被其他应用所占用，则 NodeJS 将抛出错误。你应该对该错误进行捕获，否则，后续代码将无法正常执行。

你可以提前在终端中使用命令来检测某个端口是否已经被使用；你也可以通过 NodeJS 来对错误进行捕获，并在该错误是由于已经被其他应用所占用使用其他的端口号。

终端

在 Windows 终端中你可以输入如下命令来检测某个端口是否被占用：

netstat -ano | findstr <端口号> 

举个栗子：

下面我们来尝试检测端口 3360 是否被占用：

注：

若执行命令后，终端中没有输出任何内容，则表明该端口没有被使用；
若执行命令后，终端中输出的内容与图中类似，则表明该端口已经被使用。

Error Code

除了可以使用命令来查看外，我们还可以通过对错误对象（可能是因为端口被占用而抛出的错误对象）的错误代码来判断是否是由于目标端口被占用而导致监听失败并对此进行处理（尝试使用另一个端口）。

const http = require('http');

// 创建服务器对象
const server = http.createServer();
// 默认监听端口 3360
server.listen(3360);

// 对错误进行捕获
server.on('error', (err) => {
    if(err.code == 'EADDRINUSE'){
        // 如果目标端口被占用将使用
        // NodeJS 随机分配的端口号
        server.listen(0);
    }
});

// 在成功监听后，向终端输出被监听的端口号
server.on('listening', () => {
    console.log('【HTTP Server is running at http://127.0.0.1:' + server.address().port + ' 】')
})

打印结果：

【服务器正在监听本机端口 56398】

注：

1. 由于本机端口 3360 已被使用，所以该程序使用了 NodeJS 为其分配的随机端口 56398 。
2. 我们可以通过 server.on() 方法来捕获错误，并在为该方法提供的回调函数中提供一个参数用以接收被捕获错误的错误对象。
3. 错误对象的 code 属性包含了错误代码，当错误代码为 EADDRINUSE 时，表明该错误是由于被监听端口已经被占用所产生的。
4. EADDRINUSE 的全称应该为 Error Address In Use ，记住它有助于记住错误代码。
5. 使用 server.listen() 或 server.listen(0) 在目标端口被占用的情况下，使用由 NodeJS 提供的随机端口。如果随机端口仍被占用，则将继续触发错误代码为 EADDRINUSE 的错误，并再次使用 NodeJS 提供的随机端口，直到成功的监听了一个端口。

超时处理

处理客户端的请求

在服务器对本机端口监听后，客户端便可以通过本机 IP 地址及端口号对本机进行访问。此时我们并没有对来自客户端的请求进行处理，所以此时如果你访问服务器，你可能会看到空白的网页以及一个永不停止的进度条（这是由于我们没有对客户端进行响应而导致的）：

我们可以通过监听 request 事件来对客户端的请求进行响应，也可以通过 http.createServer() 创建服务器对象时，为该函数提供一个回调函数来处理客户端的请求。

这里我们将通过监听 request 事件来对客户端的请求进行响应。

request 事件

server.on('request', (req, res) => {});

你可以向 server.on() 方法传递一个回调函数以指定当服务器端接收到客户端的请求时需要执行的回调函数。该函数可以由两个形参，分别用以接收 http.IncomingMessage 对象（该对象可用于向客户端发送请求） 及 http.ServerResponse 对象（该对象代表一个服务器端响应对象）。

http.IncomingMessage

该对象的部分属性及方法如下：

http.ServerResponse

该对象的部分属性及方法如下：

注：

1. 如果你在一个响应中使用了 write() 及 end() 则 end() 方法应该位于所有 write() 之后，否则将有部分 write() （位于 end() 之后的 write()）将无法发挥其功能。例如：

const http = require('http');

// 创建服务器对象
const server = http.createServer();
// 默认监听端口 3360
server.listen(3360);

// 对错误进行捕获
server.on('error', (err) => {
    if(err.code == 'EADDRINUSE'){
        // 如果目标端口被占用将使用
        // NodeJS 随机分配的端口号
        server.listen(0);
    }
});

// 在成功监听后，向终端输出被监听的端口号
server.on('listening', () => {
    console.log('【HTTP Server is running at http://127.0.0.1:' + server.address().port + ' 】')
})

// 对客户端的请求进行响应
server.on('request', (req, res) => {
    res.write('<h1>Hello World</h1>', () => {
        console.log('win');
    });
    res.write('<h3>Hello NodeJS</h3>')
})

效果：

而如果我们将该代码中的第一个 write() 使用 end() 进行替换：

// 对客户端的请求进行响应
server.on('request', (req, res) => {
    res.end('<h1>Hello World</h1>', () => {
        console.log('win');
    });
    res.write('<h3>Hello NodeJS</h3>')
})

效果：

2. 你应该为所有的响应使用 end() 方法，这有利于节约服务器的资源。

中文乱码问题

问题

如果你直接向客户端发送包含中文的响应数据，将会产生中文乱码问题：

const http = require('http');

// 创建服务器对象
const server = http.createServer();
// 默认监听端口 3360
server.listen(3360);

// 对错误进行捕获
server.on('error', (err) => {
    if(err.code == 'EADDRINUSE'){
        // 如果目标端口被占用将使用
        // NodeJS 随机分配的端口号
        server.listen(0);
    }
});

// 在成功监听后，向终端输出被监听的端口号
server.on('listening', () => {
    console.log('【HTTP Server is running at http://127.0.0.1:' + server.address().port + ' 】')
})

// 对客户端的请求进行响应
server.on('request', (req, res) => {
    res.write('<h1>Hello World</h1>', () => {
        console.log('win');
    });
    // 向客户端发送包含中文的响应内容
    res.end('<h3>Hello 中国</h3>')
})

效果：

解决

你可以通过设置合适的响应头信息来使客户端的浏览器正确解析中文字符以解决中文乱码问题。

const http = require('http');

// 创建服务器对象
const server = http.createServer();
// 默认监听端口 3360
server.listen(3360);

// 对错误进行捕获
server.on('error', (err) => {
    if(err.code == 'EADDRINUSE'){
        // 如果目标端口被占用将使用
        // NodeJS 随机分配的端口号
        server.listen(0);
    }
});

// 在成功监听后，向终端输出被监听的端口号
server.on('listening', () => {
    console.log('【HTTP Server is running at http://127.0.0.1:' + server.address().port + ' 】')
})

// 对客户端的请求进行响应
server.on('request', (req, res) => {
    // 通过响应头告知客户端发送内容的文本类型及编码方式
    res.setHeader('content-type', 'text/html; charset=utf-8')
    res.write('<h1>Hello World</h1>', () => {
        console.log('Win');
    });
    // 向客户端发送包含中文的响应内容
    res.end('<h3>Hello 中国</h3>')
})

效果：

代码总汇

const http = require('http');

// 创建服务器对象
const server = http.createServer();
// 默认监听端口 3360
server.listen(3360);

// 对错误进行捕获
server.on('error', (err) => {
    if(err.code == 'EADDRINUSE'){
        // 如果目标端口被占用将使用
        // NodeJS 随机分配的端口号
        server.listen(0);
    }
});

// 在成功监听后，向终端输出被监听的端口号
server.on('listening', () => {
    console.log('【HTTP Server is running at http://127.0.0.1:' + server.address().port + ' 】')
})

// 对客户端的请求进行响应
server.on('request', (req, res) => {
    // 通过响应头告知客户端发送内容的文本类型及编码方式
    res.setHeader('content-type', 'text/html; charset=utf-8')
    res.write('<h1>Hello World</h1>', () => {
        console.log('Win');
    });
    // 向客户端发送包含中文的响应内容
    res.end('<h3>Hello 中国</h3>')
})

遗留问题

在执行最终代码后，你若对服务器进行访问，服务器将打印两次 Win。也就是说 访问一次服务器将触发两次 request 事件，具体原因暂不明确。如有知道的朋友，还望不吝赐教。