0%

Web 中间件

简单说,中间件(middleware)就是处理HTTP请求的函数。 它最大的特点就是,一个中间件处理完,再传递给 下一个中间件。App实例在运行过程中,会调用一系列的中间件。
每个中间件可以从App实例,接收三个参数,依次为request对象(代表HTTP请求)、response对象(代表 HTTP回应),next回调函数(代表下一个中间件)。每个中间件都可以对HTTP请求(request对象)进行加工, 并且决定是否调用next方法,将request对象再传给下一个中间件。
一个不进行任何操作、只传递request对象的中间件,就是下面这样。

1
function uselessMiddleware(req, res, next) { 
  next();
}

上面代码的next就是下一个中间件。如果它带有参数,则代表抛出一个错误,参数为错误文本。

1
function uselessMiddleware(req, res, next) { 
  next('出错了!');
}

抛出错误以后,后面的中间件将不再执行,直到发现一个错误处理函数为止。

use方法

use是express注册中间件的方法,它返回一个函数。下面是一个连续调用两个中间件的例子。

1
var express = require("express");
var http = require("http");
var app = express();
app.use(function(request, response, next) {
  console.log("In comes a " + request.method + " to " + request.url); 
  next();
});
app.use(function(request, response) {
  response.writeHead(200, { "Content-Type": "text/plain" }); 
  response.end("Hello world!\n");
}); 
http.createServer(app).listen(1337);
  • 上面代码使用app.use方法,注册了两个中间件。收到HTTP请求后,先调用第一个中间件,在控制台输出一行 信息,然后通过next方法,将执行权传给第二个中间件,输出HTTP回应。由于第二个中间件没有调用next方 法,所以request对象就不再向后传递了。
  • use方法内部可以对访问路径进行判断,据此就能实现简单的路由,根据不同的请求网址,返回不同的网页内 容。
1
var express = require("express");
var http = require("http");
var app = express();
app.use(function(request, response, next) { 
  if (request.url == "/") {
response.writeHead(200, { "Content-Type": "text/plain" });
response.end("Welcome to the homepage!\n"); } else {
next(); 
  }
});
app.use(function(request, response, next) { 
  if (request.url == "/about") {
    response.writeHead(200, { "Content-Type": "text/plain" }); 
  } else {
    next();
    }
  });
app.use(function(request, response) { 
  response.writeHead(404, { "Content-Type": "text/plain" });
  response.end("404 error!\n");
});
http.createServer(app).listen(1337);

上面代码通过request.url属性,判断请求的网址,从而返回不同的内容。注意,app.use方法一共登记了 三个中间件,只要请求路径匹配,就不会将执行权交给下一个中间件。因此,最后一个中间件会返回404错误, 即前面的中间件都没匹配请求路径,找不到所要请求的资源。
除了在回调函数内部判断请求的网址,use方法也允许将请求网址写在第一个参数。这代表,只有请求路径匹配 这个参数,后面的中间件才会生效。无疑,这样写更加清晰和方便。

1
app.use('/path', someMiddleware);

上面代码表示,只对根目录的请求,调用某个中间件。
因此,上面的代码可以写成下面的样子。

1
var express = require("express"); 
var http = require("http");
var app = express();
app.use("/home", function(request, response, next) { 
  response.writeHead(200, { "Content-Type": "text/plain" }); 
  response.end("Welcome to the homepage!\n");
});
app.use("/about", function(request, response, next) { 
  response.writeHead(200, { "Content-Type": "text/plain" }); 
  response.end("Welcome to the about page!\n");
});
app.use(function(request, response) { 
  response.writeHead(404, { "Content-Type": "text/plain" }); 
  response.end("404 error!\n");
}); 
http.createServer(app).listen(1337);