- 创建服务器
- 方法,统一资源定位器和头部 (Method, URL and Headers)
- 请求主体 (Request Body)
- 错误处理
- 目前为止
- 参考文献:
即使刚刚接触 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
对象。
参考文献:
- [1]: Anatomy of an HTTP Transaction