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

距离我写 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 对象，它没有 views 和 setting ，但是包含所有的路由接口，比如 .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的。