expressjs路由匹配规则

expressjs作为nodejs的MVC框架，其路由规则与大部分其他MVC框架类似，略有不同，研究后做个小记。

expressjs路由在app.js中配置，app.js源码如下（不同的版本会有所不同，以下为express 4.13.1）：

 1 var express = require(‘express‘);
 2 var path = require(‘path‘);
 3 var favicon = require(‘serve-favicon‘);
 4 var logger = require(‘morgan‘);
 5 var cookieParser = require(‘cookie-parser‘);
 6 var bodyParser = require(‘body-parser‘);
 7
 8 var routes = require(‘./routes/index‘);
 9 var users = require(‘./routes/users‘);
112 var app = express();
13
14 // view engine setup
15 app.set(‘views‘, path.join(__dirname, ‘views‘));
16 app.set(‘view engine‘, ‘jade‘);
17
18 // uncomment after placing your favicon in /public
19 //app.use(favicon(path.join(__dirname, ‘public‘, ‘favicon.ico‘)));
20 app.use(logger(‘dev‘));
21 app.use(bodyParser.json());
22 app.use(bodyParser.urlencoded({ extended: false }));
23 app.use(cookieParser());
24 app.use(express.static(path.join(__dirname, ‘public‘)));
25
26 app.use(‘/‘, routes);
27 app.use(‘/users‘, users);30 // catch 404 and forward to error handler
31 app.use(function(req, res, next) {
32   var err = new Error(‘Not Found‘);
33   err.status = 404;
34   next(err);
35 });
36
37 // error handlers
38
39 // development error handler
40 // will print stacktrace
41 if (app.get(‘env‘) === ‘development‘) {
42   app.use(function(err, req, res, next) {
43     res.status(err.status || 500);
44     res.render(‘error‘, {
45       message: err.message,
46       error: err
47     });
48   });
49 }
50
51 // production error handler
52 // no stacktraces leaked to user
53 app.use(function(err, req, res, next) {
54   res.status(err.status || 500);
55   res.render(‘error‘, {
56     message: err.message,
57     error: {}
58   });
59 });
60
61
62 module.exports = app;

先对app.js进行说明,app.js文件中包含以下功能块：

1.模块的加载

 1 var express = require(‘express‘);
 2 var path = require(‘path‘);
 3 var favicon = require(‘serve-favicon‘);
 4 var logger = require(‘morgan‘);
 5 var cookieParser = require(‘cookie-parser‘);
 6 var bodyParser = require(‘body-parser‘);
 7
 8 var routes = require(‘./routes/index‘);//express默认生成的index和users文件
 9 var users = require(‘./routes/users‘);

2.设置视图view和模板引擎(express默认jade）

15 app.set(‘views‘, path.join(__dirname, ‘views‘));
16 app.set(‘view engine‘, ‘jade‘);//express默认为jade，如果想用ejs模板，直接修改，前提是要安装。

3.中间件配置app.use

8 // uncomment after placing your favicon in /public
19 //app.use(favicon(path.join(__dirname, ‘public‘, ‘favicon.ico‘)));
20 app.use(logger(‘dev‘));
21 app.use(bodyParser.json());
22 app.use(bodyParser.urlencoded({ extended: false }));
23 app.use(cookieParser());
24 app.use(express.static(path.join(__dirname, ‘public‘)));

4.配置路由

26 app.use(‘/‘, routes);//将routes模块提交给app

27 app.use(‘/users‘, users);//将users模块提交给app

第一个参数为路由路径，即url路径；第二个参数为模块名称，即在加载模块的时候赋予的变量名。

也就是将该路径与模块建立映射关系，如/users路径将于users模块建立关系。当输入url请求过来后，express会解析到相应的模块去处理请求，如上users.js模块。

在users.js中可以直接返回数据或者加载视图。

如果要加载视图，那么该路径一定要与view中的目录结构相匹配，否则无法加载。例如路由是/new/newslist，那么视图view下要有匹配的目录/views/new/newslist。

routes的目录与views目录结构相对应，才能加载成功。express根据路由/new/newslist去找routes下的newslist.js模块（文件），newslist.js文件中通过render去加载视图，代码如下:

var express = require(‘express‘);
var router = express.Router();//从express中取出router

/* GET users listing. */
router.get(‘/‘, function(req, res, next) {
  res.render(‘newslist‘, { title: ‘Express‘ });
});

module.exports = router;

express会根据之前配置的路由去views下找相应的模板文件viewslist.jade进行操作。

5.处理404和500错误

 // catch 404 and forward to error handler
31 app.use(function(req, res, next) {
32   var err = new Error(‘Not Found‘);
33   err.status = 404;
34   next(err);
35 });
36
37 // error handlers
38
39 // development error handler
40 // will print stacktrace
41 if (app.get(‘env‘) === ‘development‘) {
42   app.use(function(err, req, res, next) {
43     res.status(err.status || 500);
44     res.render(‘error‘, {
45       message: err.message,
46       error: err
47     });
48   });
49 }
50
51 // production error handler
52 // no stacktraces leaked to user
53 app.use(function(err, req, res, next) {
54   res.status(err.status || 500);
55   res.render(‘error‘, {
56     message: err.message,
57     error: {}
58   });
59 });