概述
Express 4 对 Express 3 进行了重大更改,这意味着,如果您在现有 Express 3 应用程序的依赖项中更新了 Express 版本,那么该应用程序将无法工作。
升级到 Express 4
卸载 Express 3
npm remove express --save
安装 Express 4
npm install express --save
升级到 Express 4 应用程序生成器
卸载 Express 3 应用程序生成器
npm remove express -g
or sudo npm remove express -g
安装 Express 4 应用程序生成器
npm install express-generator -g
or sudo npm install express-generator -g
创建 Express 4 app
$ express appName
启动 app
$ npm start
之前 Express 3 中启动 app 的命令是node app.js
,大家可以看到 app.js 现在成为了一个模块,再看 package.json 中的启动脚本,可以发现实际的启动命令是node ./bin/www
。由 Express 4 生成的 app.js 是作为一个模块,所以不再能够将其作为应用程序独立启动(除非修改代码)。现在是由 ./bin/www 加载 app.js 模块进行启动。
如何修改为 Express 3 风格进行启动
不使用 www,而要保持node app.js
风格的话,请删除 app.js 文件末尾的module.exports = app;
行。在 app.js 头部加上var debug = require('debug')('app4');
。在最后加上如下代码:
app.set('port', process.env.PORT || 3000);
var server = app.listen(app.get('port'), function () { debug('Express server listening on port ' + server.address().port)})
然后,将 package.json 文件中的 "start": "node ./bin/www"
更改为 "start": "node app.js"
。
Express 4 中的更改
对 Express 核心和中间件系统的更改
Express 4 不再依赖于 Connect,从其核心移除了所有内置的中间件(除了 express.static
函数),需要自己单独安装和显式添加所需中间件。
app.use 可以使用参数
app.use('/book/:id', function (req, res, next) { console.log('ID:', req.params.id) next()})
路由系统
应用程序现在隐式装入路由中间件,所以无需担心其他中间件相对于路由中间件的装入顺序。
定义路由的方式并未改变,但是路由系统新增了两个功能,用于帮助组织路由:
- 一个新方法
app.route()
,用于为路由路径创建可链接的路由处理程序。 - 一个新类
express.Router
,用于创建可安装的模块化路由处理程序。
其他修改
对象 | 描述 |
---|---|
Node.js | Express 4 需要 Node.js 0.10.x 或更高版本,已取消对 Node.js 0.8.x 的支持。 |
http.createServer() | 不再需要 http 模块,除非您要直接使用它 (socket.io/SPDY/HTTPS)。可以使用 app.listen() 函数来启动此应用程序。 |
app.configure() | 已移除 app.configure() 函数。使用 process.env.NODE_ENV 或 app.get('env') 功能来检测环境并相应配置该应用程序。 |
json spaces | 缺省情况下,已禁用 json spaces 应用程序属性。 |
req.accepted() | 使用 req.accepts()、req.acceptsEncodings()、req.acceptsCharsets() 和 req.acceptsLanguages()。 |
res.location() | 不再解析相对 URL。 |
req.params | 原来是数组;现在是对象。 |
res.locals | 原来是函数;现在是对象。 |
res.headerSent | 更改为 res.headersSent。 |
app.route | 现在可作为 app.mountpath 使用。 |
res.on('header') | 已移除。 |
res.charset | 已移除。 |
res.setHeader('Set-Cookie', val) | 功能现在已限制为设置基本 cookie 值。更多的功能请使用 res.cookie()。 |
Express 4 中的其他细节
详见 Moving to Express 4(English edition)
或 迁移到 Express 4(中文版)