http模块概览

大多数nodejs开发者都是冲着开发web server的目的选择了nodejs。正如官网所展示的,借助http模块,可以几行代码就搞定一个超迷你的web server。

在nodejs中,http可以说是最核心的模块,同时也是比较复杂的一个模块。上手很简单,但一旦深入学习,不少初学者就会觉得头疼,不知从何入手。

本文先从一个简单的例子出发,引出http模块最核心的四个实例。看完本文,应该就能够对http模块有个整体的认识。

一个简单的例子

在下面的例子中,我们创建了1个web服务器、1个http客户端

  • 服务器server:接收来自客户端的请求,并将客户端请求的地址返回给客户端。
  • 客户端client:向服务器发起请求,并将服务器返回的内容打印到控制台。

代码如下所示,只有几行,但包含了不少信息量。下一小节会进行简单介绍。

  1. var http = require('http');
  2. // http server 例子
  3. var server = http.createServer(function(serverReq, serverRes){
  4. var url = serverReq.url;
  5. serverRes.end( '您访问的地址是:' + url );
  6. });
  7. server.listen(3000);
  8. // http client 例子
  9. var client = http.get('http://127.0.0.1:3000', function(clientRes){
  10. clientRes.pipe(process.stdout);
  11. });

例子解释

在上面这个简单的例子里,涉及了4个实例。大部分时候,serverReq、serverRes 才是主角。

  • server:http.Server实例,用来提供服务,处理客户端的请求。
  • client:http.ClientReques实例,用来向服务端发起请求。
  • serverReq/clientRes:其实都是 http.IncomingMessage实。serverReq 用来获取客户端请求的相关信息,如request header;而clientRes用来获取服务端返回的相关信息,比如response header。
  • serverRes:http.ServerResponse实例

关于http.IncomingMessage、http.ServerResponse

先讲下 http.ServerResponse 实例。作用很明确,服务端通过http.ServerResponse 实例,来个请求方发送数据。包括发送响应表头,发送响应主体等。

接下来是 http.IncomingMessage 实例,由于在 server、client 都出现了,初学者难免有点迷茫。它的作用是

在server端:获取请求发送方的信息,比如请求方法、路径、传递的数据等。
在client端:获取 server 端发送过来的信息,比如请求方法、路径、传递的数据等。

http.IncomingMessage实例 有三个属性需要注意:method、statusCode、statusMessage。

  • method:只在 server 端的实例有(也就是 serverReq.method)
  • statusCode/statusMessage:只在 client 端 的实例有(也就是 clientRes.method)

关于继承与扩展

http.Server

  • http.Server 继承了 net.Server (于是顺带需要学一下 net.Server 的API、属性、相关事件)
  • net.createServer(fn),回调中的 socket 是个双工的stream接口,也就是说,读取发送方信息、向发送方发送信息都靠他。

备注:socket的客户端、服务端是相对的概念,所以其实 net.Server 内部也是用了 net.Socket(不负责任猜想)

  1. // 参考:https://cnodejs.org/topic/4fb1c1fd1975fe1e1310490b
  2. var net = require('net');
  3. var PORT = 8989;
  4. var HOST = '127.0.0.1';
  5. var server = net.createServer(function(socket){
  6. console.log('Connected: ' + socket.remoteAddress + ':' + socket.remotePort);
  7. socket.on('data', function(data){
  8. console.log('DATA ' + socket.remoteAddress + ': ' + data);
  9. console.log('Data is: ' + data);
  10. socket.write('Data from you is "' + data + '"');
  11. });
  12. socket.on('close', function(){
  13. console.log('CLOSED: ' +
  14. socket.remoteAddress + ' ' + socket.remotePort);
  15. });
  16. });
  17. server.listen(PORT, HOST);
  18. console.log(server instanceof net.Server); // true

http.ClientRequest

http.ClientRequest 内部创建了一个socket来发起请求,代码如下

当你调用 http.request(options) 时,内部是这样的

  1. self.onSocket(net.createConnection(options));

http.ServerResponse

  • 实现了 Writable Stream interface,内部也是通过socket来发送信息。

http.IncomingMessage

  • 实现了 Readable Stream interface,参考这里
  • req.socket —> 获得跟这次连接相关的socket