Node.js http模块

雨点打透心脏的1/2处 2023-10-01 16:22 1阅读 0赞

我们知道 Node.js 最吸引人的功能是：可以创建一个轻量的，基于异步I/O的，以及事件驱动的 Web 服务器。

所谓Web服务器，其实就是http服务器，即可以接收来自客户端的http请求报文，并应答http响应报文给客户端。

### 创建Web服务器 ###

Node.js提供了极其简单的程序来快速地创建一个Web服务器。

// 引入http模块
    const http = require('http');
    
    // 创建http服务器
    const app = http.createServer()
    
    // http服务器实时监听request事件，该事件在客户端发送http请求到服务器时触发
    app.on('request', (req, res) => {
    })
    
    // 指定http服务器的port和ip
    app.listen(80, 'localhost')
    
    // 当listen方法调用后，listening事件触发
    app.on('listening', () => {
      console.log('服务启动在http://localhost:80');
    })

以上代码就可以创建一个web服务器，并且还可以继续简写

即：将监听的request事件的回调放在http.createServer的参数中，底层会自动将http.createServer的参数绑定给request事件。

将监听的listening事件的回调放在app.listen的参数中，底层会自动将app.listen的回调参数绑定给listening事件

我们知道运行在电脑上的每一个应用都需要占用一个端口，这样可以在网络通信过程中，快速根据端口号快速地找到主机上对应的应用。我们指定的端口号会在传输层作为TCP报文头（源端口）封装在数据包中。而我们指定的ip地址（如localhost）会在网络层作为IP头部（源IP）封装数据包中。而MAC头部是由数据链路层自动获取网卡物理地址后封装进数据包的，所以不需要我们指定。

### request事件回调的req,res参数 ###

上面创建Web服务器的代码中，我们需要实时监听服务器server对象上的request事件，当有客户端发送http请求到服务器时，server上的request事件就会被触发，并且服务器会自动创建两个对象，分别是：

对应客户端http请求报文的IncomingMessage类型的req对象，以及

对应服务器http响应报文http.ServerResponse(继承自OutcomingMessage类型)的res对象

IncomingMessage类又继承自stream.Readable

OutComingMessgae类继承自stream.Writable

所以req对象也是一个可读流对象，res对象也是一个可写流对象。

### http请求报文与req对象 ###

我们知道HTTP请求报文由四部分组成：请求行，请求头，空行，请求体

请求行中包含：请求方法，请求地址，HTTP版本

而req对象实际上也应该包含这些信息，下面是基于req对象来解析出HTTP请求报文信息：

const http = require('http');
    
    const app = http.createServer((req, res) => {
      console.log(req.method); // 请求行中的请求方法
      console.log(req.url); // 请求行中的请求地址
      console.log(req.httpVersion); // 请求行中的HTTP版本
    
      console.log(req.headers) // 请求头
    })
    
    app.listen(80, 'localhost', () => {
      console.log('服务启动在http://localhost:80');
    })

通过curl命令发起一个GET请求

curl http://127.0.0.1:80/test?name=qfc&age=18

![watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5LyP5Z-O5LmL5aSW_size_20_color_FFFFFF_t_70_g_se_x_16][]

可以发现，请求行，请求头信息已经获取到了

但是请求地址req.url信息，我们通常是将其分解为请求路径pathname和查询字符串query

Node.js提供了url模块专门用于处理url字符串

![watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5LyP5Z-O5LmL5aSW_size_20_color_FFFFFF_t_70_g_se_x_16 1][]

我们通过url.parse方法将req.url分解为：请求路径pathname和查询字符串query

当url.parse方法第二个参数指定为true的话，会将查询字符串进一步解析为查询对象

关于http请求体，只有在客户端发送POST请求时才会携带，并且POST请求体的数据量默认是没有限制的，即可能会很大，所以客户端可能会将请求体拆分为多段发送，而服务端则需要通过监听req对象（可读流）的data事件接收多次数据块，并在end事件中将多个数据块整合为原始http请求体

curl http://127.0.0.1:80/ -X POST -H "Content-Type:application/json" -d "{name:'qfc', age:18}"

通过以上curl命令发起一个POST请求，其中-X指定请求方法，-H指定请求头，-d指定请求体

![watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5LyP5Z-O5LmL5aSW_size_19_color_FFFFFF_t_70_g_se_x_16][]

### http响应报文与res对象 ###

我们知道HTTP响应报文也由四部分组成：状态行，响应头，空行，响应头

其中状态行包含：状态码，状态描述，HTTP版本

而HTTP响应报文是需要服务器来生成的，所以res对象需要支持产生一个HTTP响应报文，所以必须要指定以上HTTP响应报文的信息

![watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5LyP5Z-O5LmL5aSW_size_20_color_FFFFFF_t_70_g_se_x_16 2][]

使用如下命令发起HTTP请求，来触发服务器返回HTTP响应

curl -v http://localhost/

可以发现res对象可以通过如下方法：

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td style="width:189px;">res.status</td> 
   <td style="width:310px;">设置状态行中的状态码</td> 
  </tr> 
  <tr> 
   <td style="width:189px;">res.statusMessage</td> 
   <td style="width:310px;">设置状态行中的状态描述</td> 
  </tr> 
  <tr> 
   <td style="width:189px;">res.setHeader</td> 
   <td style="width:310px;">写入响应头，可以调用多次</td> 
  </tr> 
  <tr> 
   <td style="width:189px;">res.writeHeader</td> 
   <td style="width:310px;">结束响应头写入，并将响应头加入连接</td> 
  </tr> 
  <tr> 
   <td style="width:189px;">res.write</td> 
   <td style="width:310px;">写入响应体，可以调用多次，并加入连接</td> 
  </tr> 
  <tr> 
   <td style="width:189px;">res.end</td> 
   <td style="width:310px;">写入响应体，并加入连接，并告知服务器关闭连接</td> 
  </tr> 
 </tbody> 
</table>

以上代码还可以简写![watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5LyP5Z-O5LmL5aSW_size_20_color_FFFFFF_t_70_g_se_x_16 3][]

即使用wirteHead方法可以一次性设置状态码，状态描述，和响应头，

直接使用end方法设置响应体。

需要注意的是，http响应报文的响应头和响应体是分开发送的。即先发送响应头，再发送响应体。

而setHead只会设置响应头，而不会将响应头加入连接，而writeHead才会将响应头写入连接中发送。即writeHead是设置响应头的收尾动作。

另外需要注意setHead,writeHead一定要在发送响应体之前设置，否则无效。

而write,end方法都可以发送响应体到连接中，但是write只会写，而不会告诉服务器关闭连接，但是end方法会告诉服务器关闭连接

[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5LyP5Z-O5LmL5aSW_size_20_color_FFFFFF_t_70_g_se_x_16]: https://img-blog.csdnimg.cn/161f3bbe1ef145fc9367578e9caecb3d.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA5LyP5Z-O5LmL5aSW,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5LyP5Z-O5LmL5aSW_size_20_color_FFFFFF_t_70_g_se_x_16 1]: https://img-blog.csdnimg.cn/77dffdbfc7ec4f5eba91ba5a3ef5e800.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA5LyP5Z-O5LmL5aSW,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5LyP5Z-O5LmL5aSW_size_19_color_FFFFFF_t_70_g_se_x_16]: https://img-blog.csdnimg.cn/3f228ef1b3b044c48b8ca343d532e6f2.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA5LyP5Z-O5LmL5aSW,size_19,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5LyP5Z-O5LmL5aSW_size_20_color_FFFFFF_t_70_g_se_x_16 2]: https://img-blog.csdnimg.cn/1b176e4bdbdf4d39b7340dbf287c2c84.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA5LyP5Z-O5LmL5aSW,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBA5LyP5Z-O5LmL5aSW_size_20_color_FFFFFF_t_70_g_se_x_16 3]: https://img-blog.csdnimg.cn/1e71dc748edc4818a39e38e961b83c37.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBA5LyP5Z-O5LmL5aSW,size_20,color_FFFFFF,t_70,g_se,x_16