express 4.x.x 文档翻译

来源:互联网 发布:算法第四版课后题答案 编辑:程序博客网 时间:2024/05/19 22:55

持续更新,一边学习一边翻译整理。

app.use([path,] function [, function…])

执行指定路径上的 中间件。path 参数默认为“/”。

路由将会匹配所有包含[path]参数的路径。如:app.use('/apple',...)会匹配"/apple","/apple/images","/apple/images/news"等。

注意,中间件的 req.originalUrl 参数是和 req.baseUrl 、* req.path* 配合使用的,示例如下:

app.use('/admin', function(req, res, next) {  // GET 'http://www.example.com/admin/new'  console.log(req.originalUrl);   // '/admin/new'  console.log(req.baseUrl);      // '/admin'  console.log(req.path);         // '/new'  next();});

将一个中间件跟路径对应之后,如果路径匹配,则处理HTTP请求时会执行该中间件。
由于路径默认为“/”,则不设置 path 的中间件在每一次HTTP请求中都会被执行。

//在每次HTTP请求下都会打印一次服务器日期app.use(function (req, res, next) {  console.log('Time: %d', Date.now());  next();});

注意:对于sub-app
- 如果有默认值则不会继承设置的值。你必须在 sub-app中重新设置。
- 如果没有默认值,则会继承。
更多细节,请参考Application setting.
中间件是按序执行的,因此在代码中务必注意出现的顺序。

// 这个中间件将会阻止请求向后执行app.use(function(req, res, next) {  res.send('Hello World');});// 请求将永远不会执行到这里app.get('/', function (req, res) {  res.send('Welcome');});

path 参数可以是一个字符串,一个变量,一个正则表达式或一个数组。原始文档中有很多例子,我使用Markdown不好复制。大家可以戳这里去看。
function 参数可以是一个中间件,可以是一系列中间件(以逗号分隔),可以是一个数组,也可以是他们的组合。routerapp 实现了中间件的接口,你也可以直接使用他们作为function
(例子表格待补充)

0 0