node.js 中 HTTP 协议事务处理的解析(上)
即使刚刚接触 node.js 的新手也能很轻松的创建网络应用,但是处理请求的回调函数以及其中的参数,也经常给新手带来疑惑。下文参考官网的资料,分析 node.js 在对 HTTP协议的事务处理过程中的几个重要定义以及原理过程。
创建服务器
所有的 node.js 网络应用都需要创建服务器,我们首先使用语法糖 createServer 来创建服务器。
var http = require('http');
var server = http.createServer(function(request, response) {
// 神奇发生在这里!
});
现在具体分析一下语句中的各个成分,访问服务器的 HTTP 请求 (HTTP Request) 都由http.createServer 中的回调函数来处理,因此我们称它为请求处理器 (Request Handler) 。 实际上从http.createServer 返回的 server 对象是 http.Server 的一个实例,同时也是一个 EventEmitter (http.Server 继承自 net.Server 而 net.Server 是一个 EventEmitter),而 http.createServer 的请求处理器会自动添加一个 'request' 事件。
根据上述分析,我们来分解语法糖。首先初始化一个 http.Server 实例,然后为它添加监听器,这样会得到一个更具体的代码。
var server = http.createServer();
server.on('request', function(request, response) {
// 神奇同样会发生在这里!
});
当 HTTP 请求到达服务器时,会触发 'request' 事件,请求处理器会使用 request 和 response 两个对象来处理相关事务。request 对象是 http.IncomingMessage 的一个实例,而 response 对象则是 http.ServerResponse 的一个实例。具体属性可参考官网的 API 文档。
方法,统一资源定位器和头部 (Method, URL and Headers)
在处理一个HTTP 请求时,首先希望了解的就是 method 和 URL, 并以此采取合适的处理手段。 node.js 将这些属性很自然的赋予在 request 对象上。
var method = request.method;
var url = request.url;
var headers = request.headers;
var userAgent = headers['user-agent'];
代码中的 method 对应 HTTP 协议中的动词方法,如: 'GET', 'DELETE' 。 url 则对应没有协议,主机和端口的 URL , 如: '/status?name=ryan' 。 headers 需要注意的是,为了方便解析都使用小写字母。
请求主体 (Request Body)
收到 POST 和 PUT 请求时,node 就需要解析请求主体。 获取主体数据比较复杂, 首先利用 request 对象传递一个回调函数来实现 ReadableStream 接口,然后通过对流的 'data' 和 'end' 事件的监听来抓取数据流。
每次响应 'data' 事件的数据块是一个 Buffer ,如果想输出字符串数据,那么最佳方案是将数据块集中到一个数组,然后在 'end' 事件中连接数组并字符串化。
var body = [];
request.on('data', function(chunk) {
body.push(chunk);
}).on('end', function() {
body = Buffer.concat(body).toString();
// 至此, `body` 是请求主体的字符串形式。
});
错误处理
当 request 流中出现错误,将触发流的 'error' 事件,如果程序没有监听该事件,错误会被抛出同时程序有可能崩溃。 因此在 request 流上添加 'error' 事件监听器显得异常重要。
request.on('error', function(err) {
// 打印错误信息
console.error(err.stack);
});
目前为止
我们学习了创建服务器,从 request 中获取 method, URL, headers 以及 body, 将这些内容联系起来:
var http = require('http');
http.createServer(function(request, response) {
var headers = request.headers;
var method = request.method;
var url = request.url;
var body = [];
request.on('error', function(err) {
console.error(err);
}).on('data', function(chunk) {
body.push(chunk);
}).on('end', function() {
body = Buffer.concat(body).toString();
});
}).listen(8080); // http 协议的监听端口为 8080
如果运行这个程序,并在浏览器中输入 http://localhost:8080 , 那么你的请求会超时,没有任何内容返回到浏览器。因为到目前为止我们还没有接触到 response 对象, 它是 http.ServerResponse 的实例,同时也是一个 WritableStream 。 后面的内容将详细学习response 对象。