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 setup15 app.set('views', path.join(__dirname, 'views'));16 app.set('view engine', 'jade');17 18 // uncomment after placing your favicon in /public19 //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 handler31 app.use(function(req, res, next) {32 var err = new Error('Not Found');33 err.status = 404;34 next(err);35 });36 37 // error handlers38 39 // development error handler40 // will print stacktrace41 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: err47 });48 });49 }50 51 // production error handler52 // no stacktraces leaked to user53 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 /public19 //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 handler31 app.use(function(req, res, next) {32 var err = new Error('Not Found');33 err.status = 404;34 next(err);35 });36 37 // error handlers38 39 // development error handler40 // will print stacktrace41 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: err47 });48 });49 }50 51 // production error handler52 // no stacktraces leaked to user53 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 });