Node.js开发入门—HelloWorld再分析

Posted 2020-10-01 gavanwanggw

在Node.js开发入门(1)我们用http模块实现了一个简单的HelloWorld站点，这次我们再来细致分析下代码。了解很多其它的细节。

先看看http版本号的HelloWorld代码：

代码就是这么简单：

// 引入http模块
var http = require("http"); 

// 创建server，指定处理client请求的函数
http.createServer(
    function(request, response) { 
        response.writeHead(200, {"Content-Type": "text/plain"}); 
        response.write("Hello World!"); 
        response.end(); 
    }
).listen(8000); 

console.log("Hello World is listening at port 8000");

HelloWorld代码分析

好啦，从如今開始逐行分析我们的HelloWorld。

引入模块

var http = require("http");

require方法用来引入一个模块，參数是模块的名字。比方File System模块。能够这么引入：

var fs = require("fs");

我们能够把require()方法当做全局方法使用。但实际上它更像属于某个模块的本地方法，它的文档參考这里：https://nodejs.org/api/globals.html。

require方法返回某个模块的实例，比方require(“http”)就返回一个HTTP实例。HTTP实例的參考文档在这里：https://nodejs.org/api/http.html。

我们看到。HTTP模块有一个方法createServer()，就牵涉到我们的第二行代码了。

创建server

HTTP模块的createServer()方法，接受一个方法作为參数，原型为：

http.createServer([requestListener])

requestListener是一个方法，会与http.Server类的request事件关联起来。这样当client请求到达时，requestListener就会被调用。

requestListener有两个參数，函数原型例如以下：

function (request, response) { }

第一个參数request的类型是http.IncomingMessage，实现了Readable Stream接口。第二个參数的类型是http.ServerResponse，实现了Writeable Stream接口。Stream的API在这里：https://nodejs.org/api/stream.html。

同一时候，request和response还是EventEmitter。能够发射特定的事件。EventEmitter的API在这里：https://nodejs.org/api/events.html#events_class_events_eventemitter，后面我们会讲怎样使用EventEmitter来发射事件、处理事件。

再回想一下我们创建server的代码：

http.createServer(
    function(request, response) { 
        response.writeHead(200, {"Content-Type": "text/plain"}); 
        response.write("Hello World!"); 
        response.end(); 
    }
).listen(8000); 

http.createServer返回一个http.Server实例。http.Server的listen方法能够让server监听在某个端口上。演示样例中是8000。

如你所见，我们提供了一个匿名函数给createServer方法。在这种方法中。我们通过response參数向client回写了“Hello World!”消息。

分析client请求

前面我们分析了http.createServer方法，它的參数是一个带两个參数的方法，一个代表了client发过来的请求。一个代表了要回写给client的响应。

我们来看看request參数。

request是http.IncomingMessage的实例，通过这个实例，我们能够拿到请求參数。比方HTTP方法、HTTP版本号、url、头部等。详细的API在这里：https://nodejs.org/api/http.html#http_http_incomingmessage。

我们通过改动HelloWorld.js来看看（另存为HelloWorld2.js）。代码例如以下：

// 引入http模块
var http = require("http"); 

// 创建server，指定处理client请求的函数
http.createServer(
    function(request, response) { 
        console.log("method - " + request.method);
        console.log("version - " + request.httpVersion);
        console.log("url - " + request.url);
        response.writeHead(200, {"Content-Type": "text/plain"}); 
        response.write("Hello World!"); 
        response.end(); 
    }
).listen(8000); 

console.log("Hello World start listen on port 8000");

如你所见，我使用console这个对象来输出了一些调试信息。打印了HTTP方法、版本号、url等信息。能够运行node HelloWorld2.js，浏览器訪问http://localhost:8000。然后跑到命令行看看输出了什么信息，我这里是这种：

发送响应给client

我们简简单单的HelloWorld已经能够发送一些响应数据给client，你在浏览器里能看到“Hello World!”字样。

这个响应是通过http.ServerResponse的实例response发送给client的。

http.ServerResponse也是一个Stream。还是一个EventEmitter。我们通过它给客户度返回HTTP状态码、数据、HTTP头部等信息。

解释一些基本概念。

HTTP响应由状态行+头部+数据组成。基本结构例如以下：

|——————————————————|
|HTTP version|status code|message|
|—————————————————–|
| HEADER-NAME-1: value |
|—————————————————–|
|HEADER-NAME-2: value |
|—————————————————–|
|HEADER-NAME-2: value |
|—————————————————–|
|空行（CRLF） |
|—————————————————–|
|可选数据(body) |
|—————————————————–|

HTTP状态码

就是200、301、302、403、404之类的数字，由server告诉client这次请求的状态，是成功了呢，还是找不到文件，还是……详细看这里http://kb.cnblogs.com/page/130970/。

在Node.js的HTTP模块，状态行就是通过http.ServerResponse的writeHead方法写给client的。writeHead方法原型例如以下：

response.writeHead(statusCode[, statusMessage][, headers])

这种方法的第一个參数，就是statusCode，也就是200、403之类的数字，剩下的參数是可选的。最后一个參数是headers，你能够在这里使用JSON对象表示法来写一些HTTP头部，比方：{“Content-Type”:”text/plain”,”Content-Length”:11}。第一个可选參数statusMessage用来指定一个状态描写叙述消息。能够不填写。

HTTP头部

头部就是一些key-value对。比方我们在HelloWorld里看到的”Content-Type”，就是用来说明数据类型的头部标签，相应的可能是文本文件、图片、视频、二进制等。

相似的还有”Content-Length”，用来指定数据长度。

还有非常多非常多，比方”Date”、”Connection”等。

详细还是參考前面的链接吧。

头部还能够使用http.ServerResponse的response.setHeader(name, value)方法来单独设置，一次能够设置一个HTTP头部。

数据

头部之后就是数据了。有些状态码，比方200，兴许都会有一些数据。而有些，比方301、404、403、500之类的。多数没有数据。

数据通过http.ServerResponse的write方法来写回给client，比方这样：

response.setHeader("Content-Type", "text/html");

这里要提一点，HTTP常见的数据传输编码方式有两种：

• 设置Content-Length，传输固定长度的数据
• 设置Transfer-Encoding头部为chunked，分块数据传输

像我们如今的HelloWorld演示样例，没有设置Content-Length头部。Node.js的HTTP模块就默觉得chunked编码。

我们使用Chrome浏览器的开发人员工具来查看网络数据。能够非常明白的看到。

例如以下图所看到的：

我标注出来的三处，都是HelloWorld演示样例传递给浏览器的HTTP头部信息。

我们通过http.ServerResponse的write方法向client写数据。

你能够一次写入全部数据。也能够把数据分开来多次写入。

当要传输的数据量较大时。分多次写入就是比較合理的做法，比方你向client发送大文件。就比較适合分多次写入。也能够利用Node.js的异步特性，获得不错的性能。

---

好啦，这次我们略微详细地分析了一遍HelloWorld，下次呢。我们实现一个简单的文件server，会使用到很多其它的Node.js模块和API。