草依山的Javascript世界

一个Javascript程序猿的学习纪录剩地,不仅仅是JS,还有Linux、Mac、nodeJs、吃、玩!

express4.x新特性以及如何从3.x升级到4.x

距离我写expressx2.x升级3.x已经过去一年多的时间了,这期间express发展很迅速,已经是nodejs社区事实上的web框架之王。最近express发布了4.0.0-rc3,其中又有了一些改变,下面我们来看看有哪些改变,以及如何从3.x升级到4.x。

移除内置中间件

4.x版本不再依赖Connect,之前内置的所有中间件除了static都被分离为单独的模块了,也就是如果你的3.x的代码是:

app.configure(function() {
    app.use(express.static(__dirname + '/public'));
    app.use(express.logger('dev'));
    app.use(express.bodyParser());
    app.use(express.methodOverride());
});

在4.x各个模块需要单独安装,然后require,可以使用npm install --save xxxx,这样可以自动把模块保存到你的package.json里,4.x的代码示例:

var app = express();
var express  = require('express');
var morgan = require('morgan'); //logger模块的这个新名字真是神奇
var bodyParser = require('body-parser');
var methodOverride = require('method-override');

app.use(express.static(__dirname + '/public'));
app.use(morgan('dev'));
app.use(bodyParser());
app.use(methodOverride());

下面是3.x的内置模块和4.x模块的对照表,你可以发现,模块名有点混乱,有的是把驼峰改成了连字符,有的是反过来的,有的前缀express,有的是没有,真不知道怎么命名的,这个应该好好跟grunt或者gulp学习一下。

3.x 4.x
bodyParser body-parser
compress compression
cookieSession cookie-session
logger morgan
cookieParser cookie-parser
session express-session
favicon serve-favicon
response-time response-time
error-handler errorhandler
method-override method-override
timeout connect-timeout
vhost vhost
csrf csurf
directory serve-index
static serve-static

强化的路由功能

4.x提供了一个更棒的Router对象和route接口,可以更方便的把路由分解成单独的文件

不要再手动执行app.use(app.routers), app.use和app[get post]混用的时候,将会按照它们调用的顺序执行

例如有一个3.x的代码

app.use(cookieParser());
app.use(bodyParser());
app.use(app.router); // 这行要干掉

// 在路由之后执行
app.use(function(req, res, next);
// 错误处理的中间件
app.use(function(err, req, res, next) {});

//正常的路由挂载
app.get('/' ...);
app.post(...);

换成了4.x的:

app.use(cookieParser());
app.use(bodyParser());

//正常的路由挂载, 这里和app.use混用的时候
//如果需要中间件调用之前处理就必须use之前挂载
app.get('/' ...);
app.post(...);

// 在路由之后执行
app.use(function(req, res, next);
// 错误处理的中间件
app.use(function(err, req, res, next) {});

4.x更方便的路由, app.route方法会返回一个Route实例,它可以继续使用所有的HTTP方法,并且它还有一个all方法,可以在所有的HTTP方法上生效

app.route('/users')
  .get(function(req, res, next) {})
  .post(function(req, res, next) {})

Router 对象

这是4.x里新增加的一个对象,它有点像迷你版的app对象,它没有viewssetting,但是包含所有的路由接口,比如 .use, .route, .param, .get

它可以帮助我们更好组织代码,假如项目里有个routes/people.js

var people = express.Router();

people.use(function(req, res, next) {
});

people.get('/', function(req, res, next) {
});

可以把它挂在 /people下,所有的/people/*处理都会由people.js里的Router来处理了

app.use('/people', require('./routes/people').people);

更多关于Router的内容可以看文档

删除app.configure方法

这个方法使用还是比较多的,如果你用来判断环境的代码,比如3.x下的

app.configure('development', function() {
   // configure stuff here
});

在4.x下,这个方法完全没有了,你需要换成

var env = process.env.NODE_ENV || 'development';
if ('development' == env) {
   // configure stuff here
}

删除express.createServer()

这个在3.x的时代就已经废弃了,直接使用 express()就行了

删除res.charset

使用res.set('content-type')或者res.type()来设置默认的charset,使用res.setHeader时不会再默认加charset了

req.accepted改为req.accepts

有几个相关的方法都改名了

  • req.accepts()
  • req.acceptsEncodings()
  • req.acceptsCharsets()
  • req.acceptsLanguages()

req.params的改变

这个属性现在是一个对象,不再是一个数组

res.locals

不再是一个方法,现在它就是一个纯对象,只用来数据

req.is

去掉了,可以使用type-is模块

总结

总的来说,改动还是挺大的,如果你想升级,最好留有足够的时间来把你的代码调整为4.x的。

如果发现这篇文章里有什么错误,欢迎留言反馈。

喜欢看英文的朋友,可以直接看下面的文章:

文章地址: express4.x新特性以及如何从3.x升级到4.x
欢迎关注我的微博与我交流:@草依山
Github上也有一些东西:[Github]
所有文章坚决抵制jb51.net的转载!
2014-03-18

相关文章

2017-03-22 一次算PI的小尝试
2017-02-13 new做了些什么
2016-09-29 [翻译]bash的各种文件载入执行顺序
2016-05-31 phantomjs在linux下截图中文字体问题
2016-04-24 Promise的错误处理

文章修改纪录

加载中...
Copyright © 2013. Create By 草依山, Fork