Express的API

现在学node,不来点Express,都不好意思给人打招呼。但是,我刚接触的时候,觉得好多API,感觉乱糟糟的,没办法,大脑容量不够。不过有一样东西叫地铁,在上面可以让人想清楚很多事情(-_-!

先来一段最简单的node版hello world

 
  1. var http = require('http');

  2. http.createServer(function (req, res) {

  3. res.writeHead(200, {'Content-Type': 'text/plain'});

  4. res.end('Hello World\n');

  5. }).listen(1337, '127.0.0.1');

  6.  

上面这段代码来自nodejs的官网,非常简单,就是来一个请求,就用传给createServer的匿名函数来处理请求。

下面来看看使用Express的代码

 
  1. var app = express();

  2. //...中间忽略

  3. http.createServer(app).listen(app.get('port'), function(){

  4. console.log('Express server listening on port ' + app.get('port'));

  5. });

  6.  

对比可以看出,执行express()后,会返回一个函数,赋值给app,app的签名应该为

 
  1. function(req,res){//...}

  2.  

然后请求都会被app这个函数处理(因为这个app是执行express后的结果,下面将不加区分的使用app和express两个词)。

可以认为,在express内部,有一个函数的数组,暂时叫这个数组tasks,每来一个请求express内部会依次执行这个数组中的函数(这里说依次并不严谨,每个函数必须满足一定条件才行,这个后面说),应该可以想到,在这个函数数组里,每个函数的签名应该像下面那样

 
  1. function(req,res){//...}

  2.  

但是,实际上是

 
  1. function(req,res,next){//...}

  2.  

这个next,是指下一个函数。后面我们会写一些试验来体验一下这个next,先总结一下:

对于一个典型的使用express的app.js(这个满大街都是代码,就不贴了),做了以下几件事

  • 1.导入相关模块
  • 2.执行过 var app = express() 后,
    • 使用app.set 设置express内部的一些参数(options)
    • 使用app.use 来注册函数,可以简单的认为是向那个(被我叫做)tasks的数组进行push操作
  • 3.通过http.createServer 用app来处理请求

试验1. 向express中注册自定义函数

注册进express中的函数,需要满足(请见下面更正)

1.长成下面这个样子

 
  1. function(req,res,next){

  2. //...我们自己的逻辑

  3. next();

  4. }

  5.  

2.app.use(customerFunc) 要写在下面两句的前面

 
  1. app.use(app.router);

  2. app.use(express.static(path.join(__dirname, 'public')));

  3.  

关于第2点,是因为路由后或请求静态资源后,一次请求响应的生命周期实质上已经结束,加在这后面进行请求处理,没有任何意义。

关于第1点,写点代码就好了,

 
  1. app.use(function(req,res,next){

  2. console.log("111");

  3. next();

  4. });

  5.  

如果不写next(),那么后面注册的函数就不会执行,运行试一下就知道了。

再来一个:

 
  1. app.use(function(req,res,next){

  2. console.log('111');

  3. next();

  4. console.log('222');

  5. });

  6.  
  7. app.use(function(req,res,next){

  8. console.log("333");

  9. next();

  10. });

  11.  

那么控制台的输出的顺序是:111 333 222

试验二 next()的工作原理

整个处理请求的模型还是很简单的,在理解的上面的过程后,能不能不借助express,自己实现上面的过程呢,主要是怎么处理next()那一块

我写了一个简单的实现,测试可用,这里和大家进行讨论,主要是 第5行 起的那个函数,虽然很简短,还是花了一些时间(囧

 
  1. var http = require('http');

  2. function express(){

  3. var funcs = [];

  4.  
  5. var expr = function(req,res){

  6. var i = 0;

  7. function next(){

  8. var task = funcs[i++];

  9. if(!task) return;

  10. task(req,res,next);

  11. }

  12. next();

  13. }

  14. expr.use=function(f){

  15. funcs.push(f);

  16. }

  17. return expr;

  18. }

  19. var app = express();

  20.  
  21. app.use(function(req,res,next){

  22. console.log('haha');

  23. next();

  24. });

  25. app.use(function(req,res,next){

  26. console.log('hehe');

  27. next();

  28. });

  29. app.use(function(req,res){

  30. res.end("there is nothing happened");

  31. });

  32.  
  33. http.createServer(app).listen('3000', function(){

  34. console.log('Express server listening on port 3000');

  35. });

  36.  

启动服务后,每来一个请求,控制台会依次输出haha hehe,然后浏览器是there is nothing happened

当然如果要更深一步,可以去看原代码,实际上这一部分的主要代码是在connect中的,在connect/lib/proto.js 这个源文件中,主要是app.use,和app.handle 两个函数中

更正:

上面说,自定义的函数应该满足两个条件,一般使用是那样。但是,也可以两个都不满足。。。比如,自定义函数可以是4参数的,放在最后做通用error处理。在下面两句之后

 
  1. app.use(app.router);

  2. app.use(express.static(path.join(__dirname, 'public')));

  3.  

可以加一个

 
  1. app.use(function(err,req,res,next){

  2. if(err){

  3. //自己的处理错误的逻辑

  4. console.log(err.message);

  5. console.log(err.stack);

  6. res.end('404')

  7. }

  8. });