Express 4.x APIexpress() express()用来创建一个Express的程序。express()方法是express var express = require ('express' );var app = express();
Methods express.static(root, [options]) express.static是Express中唯一的内建中间件。它以server-static 模块为基础开发，负责托管 Express 应用内的静态资源。root为静态资源的所在的根目录。options是可选的，支持以下的属性：
属性
描述
类型
默认值
dotfiles
是否响应点文件。供选择的值有”allow”，”deny”和”ignore”
String
“ignore”
etag
使能或者关闭etag
Boolean
true
extensions
设置文件延期回退
Boolean
true
index
发送目录索引文件。设置false将不发送。
Mixed
“index.html”
lastModified
设置文件在系统中的最后修改时间到Last-Modified头部。可能的取值有false和true。
Boolean
true
maxAge
在Cache-Control头部中设置
max-age属性，精度为毫秒(ms)或则一段
ms format 的字符串
Number
0
redirect
当请求的pathname是一个目录的时候，重定向到尾随”/“
Boolean
true
setHeaders
当响应静态文件请求时设置headers的方法
Funtion
如果你想获得更多关于使用中间件的细节，你可以查阅Serving static files in Express 。
Application() app对象一般用来表示Express程序。通过调用Express模块导出的顶层的express()方法来创建它:var express = require ('express' );var app = express();app.get('/' , function (req, res ) res.send('hello world!' ); }); app.listen(3000 );
app对象具有以下的方法：
它还有一些属性设置，这些属性可以改变程序的行为。获得更多的信息，可以查阅Application settings 。
Properties app.locals app.locals对象是一个javascript对象，它的属性就是程序本地的变量。app.locals.title app.locals.email
一旦设定，app.locals的各属性值将贯穿程序的整个生命周期，与其相反的是res.locals，它只在这次请求的生命周期中有效。
在程序中，你可以在渲染模板时使用这些本地变量。它们是非常有用的，可以为模板提供一些有用的方法，以及app级别的数据。通过req.app.locals(具体查看req.app )，Locals可以在中间件中使用。app.locals.title = 'My App' ; app.locals.strftime = require ('strftime' ); app.locals.email = 'me@myapp.com' ;
app.mountpath app.mountpath属性是子程序挂载的路径模式。
一个子程序是一个express的实例，其可以被用来作为路由句柄来处理请求。
var express = require ('express' );var app = express(); var admin = express(); admin.get('/' , function (req, res ) console .log(admin.mountpath); res.send('Admin Homepage' ); }); app.use('/admin' , admin); 它和req对象的baseUrl 属性比较相似，除了req.baseUrl是匹配的URL路径，而不是匹配的模式。如果一个子程序被挂载在多条路径模式，app.mountpath就是一个关于挂载路径模式项的列表，如下面例子所示。var admin = express();admin.get('/' , function (req, res ) console .log(admin.mountpath); res.send('Admin Homepage' ); }); var secret = express();secret.get('/' , function (req, res ) console .log(secret.mountpath); res.send('Admin secret' ); }); admin.use('secr*t' , secret); app.use(['/adm*n' , '/manager' ], admin);
Events app.on(‘mount’, callback(parent)) 当子程序被挂载到父程序时，mount事件被发射。父程序对象作为参数，传递给回调方法。var admin = express();admin.on('mount' , function (parent ) console .log('Admin Mounted' ); console .log(parent); }); admin.get('/' , function (req, res ) res.send('Admin Homepage' ); }); app.use('/admin' , admin);
Methods app.all(path, callback[, callback …] app.all方法和标准的app.METHOD()方法相似，除了它匹配所有的HTTP动词。loadUser可以在完成了一个任务后，调用next()方法来继续匹配随后的路由。app.all('*' , requireAuthentication, loadUser);
或者这种相等的形式:app.all('*' , requireAuthentication); app.all('*' , loadUser);
另一个例子是全局的白名单方法。这个例子和前面的很像，然而它只是限制以/api开头的路径。app.all('/api/*' , requireAuthentication);
app.delete(path, callback[, callback …]) 路由HTTP DELETE请求到有特殊回调方法的特殊的路径。获取更多的信息，可以查阅routing guide 。next('router')来绕过剩余的路由回调。你可以使用这个机制来为一个路由设置一些前提条件，如果不能满足当前路由的处理条件，那么你可以传递控制到随后的路由。app.delete('/' , function (req, res ) res.send('DELETE request to homepage' ); });
app.disable(name) 设置类型为布尔的设置名为name的值为false，此处的name是app settings table 中各属性的一个。调用app.set('foo', false)和调用app.disable('foo')是等价的。app.disable('trust proxy' ); app.get('trust proxy' );
app.disabled(name) 返回true如果布尔类型的设置值name被禁用为false，此处的name是app settings table 中各属性的一个。app.disabled('trust proxy' ); app.enable('trust proxy' ); app.disabled('trust proxy' );
app.enable(name) 设置布尔类型的设置值name为true，此处的name是app settings table 中各属性的一个。调用app.set('foo', true)和调用app.enable('foo')是等价的。app.enable('trust proxy' ); app.get('trust proxy' );
app.enabled(name) 返回true如果布尔类型的设置值name被启动为true，此处的name是app settings table 中各属性的一个。app.enabled('trust proxy' ); app.enable('trust proxy' ); app.enabled('trust proxy' );
app.engine(ext, callback) 注册给定引擎的回调，用来渲染处理ext文件。require()来加载基于文件扩展的引擎。例如，如果你尝试渲染一个foo.jade文件，Express在内部调用下面的内容，同时缓存require()结果供随后的调用，来加速性能。
app.engine('jade' , require ('jade' ).__express); 使用下面的方法对于那些没有提供开箱即用的.__express方法的模板，或者你希望使用不同的模板引擎扩展。.html文件：app.engine('html' , require ('ejs' ).renderFile);
在这个例子中，EJS提供了一个.renderFile方法，这个方法满足了Express规定的签名规则：(path, options, callback)，然而记住在内部它只是ejs.__express的一个别名，所以你可以在不做任何事的情况下直接使用.ejs扩展。consolidate.js 库映射模板引擎以下面的使用方式，所以他们可以无缝的和Express工作。var engines = require ('consolidate' );app.engine('haml' , engines.haml); app.engine('html' , engines.hogan);
app.get(name) 获得设置名为name的app设置的值，此处的name是app settings table 中各属性的一个。app.get('title' ); app.set('title' , 'My Site' ); app.get('title' );
app.get(path, callback [, callback …]) 路由HTTP GET请求到有特殊回调的特殊路径。获取更多的信息，可以查阅routing guide 。next('router')来绕过剩余的路由回调。你可以使用这个机制来为一个路由设置一些前提条件，如果请求没能满足当前路由的处理条件，那么传递控制到随后的路由。app.get('/' , function (req, res ) res.send('GET request to homepage' ); });
app.listen(port, [hostname], [backlog], [callback]) 绑定程序监听端口到指定的主机和端口号。这个方法和Node中的http.Server.listen() 是一样的。var express = require ('express' );var app = express();app.listen(3000 );
通过调用express()返回得到的app实际上是一个JavaScript的Function，被设计用来作为一个回调传递给Node HTTP servers来处理请求。这样，其就可以很简便的基于同一份代码提供http和https版本，所以app没有从这些继承(它只是一个简单的回调)。var express = require ('express' );var https = require ('https' );var http = require ('http' );http.createServer(app).listen(80 ); https.createServer(options, app).listen(443 );
app.listen()方法是下面所示的一个便利的方法(只针对HTTP协议):app.listen = function ( var server = http.createServer(this ); return server.listen.apply(server, arguments ); };
app.METHOD(path, callback [, callback …]) 路由一个HTTP请求，METHOD是这个请求的HTTP方法，比如GET，PUT，POST等等，注意是小写的。所以，实际的方法是app.get()，app.post()，app.put()等等。下面有关于方法的完整的表。routing guide 。
checkout connect copy delete get head lock merge mkactivity
mkcol move m-search notify options patch post propfind proppatch
purege put report search subscribe trace unlock unsubscribe
如果使用上述方法时，导致了无效的javascript的变量名，可以使用中括号符号，比如,app['m-search']('/', function ...
你可以提供多个回调函数，它们的行为和中间件一样，除了这些回调可以通过调用next('router')来绕过剩余的路由回调。你可以使用这个机制来为一个路由设置一些前提条件，如果请求没有满足当前路由的处理条件，那么传递控制到随后的路由。
本API文档把使用比较多的HTTP方法app.get()，app.post，app.put()，app.delete()作为一个个单独的项进行说明。然而，其他上述列出的方法以完全相同的方式工作。
app.all()是一个特殊的路由方法，它不属于HTTP协议中的规定的方法。它为一个路径加载中间件，其对所有的请求方法都有效。
app.all('/secret' , function (req, res ) console .log('Accessing the secret section...' ); next(); }); app.param([name], callback) 给路由参数添加回调触发器，这里的name是参数名或者参数数组，function是回调方法。回调方法的参数按序是请求对象，响应对象，下个中间件，参数值和参数名。name是数组，会按照各个参数在数组中被声明的顺序将回调触发器注册下来。还有，对于除了最后一个参数的其他参数，在他们的回调中调用next()来调用下个声明参数的回调。对于最后一个参数，在回调中调用next()将调用位于当前处理路由中的下一个中间件，如果name只是一个string那就和它是一样的(就是说只有一个参数，那么就是最后一个参数，和数组中最后一个参数是一样的)。:user出现在路由路径中，你可以映射用户加载的逻辑处理来自动提供req.user给这个路由，或者对输入的参数进行验证。app.param('user' , function (req, res, next, id ) User.find(id, function (error, user ) if (err) { next(err); } else if (user){ req.user = user; } else { next(new Error ('failed to load user' )); } }); });
对于Param的回调定义的路由来说，他们是局部的。它们不会被挂载的app或者路由继承。所以，定义在app上的Param回调只有是在app上的路由具有这个路由参数时才起作用。param的路由上，param回调都是第一个被调用的，它们在一个请求-响应循环中都会被调用一次并且只有一次，即使多个路由都匹配，如下面的例子：app.param('id' , function (req, res, next, id ) console .log('CALLED ONLY ONCE' ); next(); }); app.get('/user/:id' , function (req, res, next ) console .log('although this matches' ); next(); }); app.get('/user/:id' , function (req, res ) console .log('and this mathces too' ); res.end(); });
当GET /user/42，得到下面的结果:
CALLED ONLY ONCE
although this matches
and this matches too app.param(['id' , 'page' ], function (req, res, next, value ) console .log('CALLED ONLY ONCE with' , value); next(); }); app.get('/user/:id/:page' , function (req. res, next ) console .log('although this matches' ); next(); }); app.get('/user/:id/:page' , function (req, res, next ) console .log('and this matches too' ); res.end(); }); 当执行GET /user/42/3，结果如下：CALLED ONLY ONCE with 42
CALLED ONLY ONCE with 3
although this matches
and this mathes too
下面章节描述的app.param(callback)在v4.11.0之后被弃用。
通过只传递一个回调参数给app.param(name, callback)方法，app.param(naem, callback)方法的行为将被完全改变。这个回调参数是关于app.param(name, callback)该具有怎样的行为的一个自定义方法，这个方法必须接受两个参数并且返回一个中间件。app.param(name, callback)参数签名被修改成了app.param(name, accessId)。替换接受一个参数名和回调，app.param()现在接受一个参数名和一个数字。1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 var express = require ('express' );var app = express();app.param(function (param, option ) return function (req, res, next, val ) if (val == option) { next(); } else { res.sendStatus(403 ); } } }); app.param('id' , 1337 ); app.get('/user/:id' , function (req, res ) res.send('Ok' ); }); app.listen(3000 , function ( console .log('Ready' ); });
在这个例子中，app.param(name, callback)参数签名保持和原来一样，但是替换成了一个中间件，定义了一个自定义的数据类型检测方法来检测user id的类型正确性。app.param(function (param, validator ) return function (req, res, next, val ) if (validator(val)) { next(); } else { res.sendStatus(403 ); } } }); app.param('id' , function (candidate ) return !isNaN (parseFloat (candidate)) && isFinite (candidate); });
在使用正则表达式来，不要使用.。例如，你不能使用/user-.+/来捕获user-gami，用使用[\\s\\S]或者[\\w\\>W]来代替(正如/user-[\\s\\S]+/)。router.get('/[0-9]+-[[\\w]]*' , function );//captures '1-a_6 ' and '543-az (ser"-sder' but not '5-a s' router.get('/[0-9]+-[[\\S]]*', function ); //captures all (equivalent to '.*' ) router .get ('[[\\s\\S]]*', function );
app.path() 通过这个方法可以得到app典型的路径，其是一个string。var app = express() , blog = express() , blogAdmin = express(); app.use('/blog' , blog); app.use('/admin' , blogAdmin); console .log(app.path()); console .log(blog.path()); console .log(blogAdmin.path());
如果app挂载很复杂下，那么这个方法的行为也会很复杂：一种更好用的方式是使用req.baseUrl来获得这个app的典型路径。
app.post(path, callback, [callback …]) 路由HTTP POST请求到有特殊回调的特殊路径。获取更多的信息，可以查阅routing guide 。next('router')来绕过剩余的路由回调。你可以使用这个机制来为一个路由设置一些前提条件，如果请求没能满足当前路由的处理条件，那么传递控制到随后的路由。app.post('/' , function (req, res ) res.send('POST request to homepage' ) });
app.put(path, callback, [callback …]) 路由HTTP PUT请求到有特殊回调的特殊路径。获取更多的信息，可以查阅routing guide 。next('router')来绕过剩余的路由回调。你可以使用这个机制来为一个路由设置一些前提条件，如果请求没能满足当前路由的处理条件，那么传递控制到随后的路由。app.put('/' , function (req, res ) res.send('PUT request to homepage' ); });
app.render(view, [locals], callback) 通过callback回调返回一个view渲染之后得到的HTML文本。它可以接受一个可选的参数，可选参数包含了这个view需要用到的本地数据。这个方法类似于res.render()，除了它不能把渲染得到的HTML文本发送给客户端。
将app.render()当作是可以生成渲染视图字符串的工具方法。在res.render()内部，就是使用的app.render()来渲染视图。
如果使能了视图缓存，那么本地变量缓存就会保留。如果你想在开发的过程中缓存视图，设置它为true。在生产环境中，视图缓存默认是打开的。
app.render('email' , function (err, html ) }); app.render('email' , {name:'Tobi' }, function (err, html ) }); app.route(path) 返回一个单例模式的路由的实例，之后你可以在其上施加各种HTTP动作的中间件。使用app.route()来避免重复路由名字(因此错字错误)–说的意思应该是使用app.router()这个单例方法来避免同一个路径多个路由实例。var app = express();app.route('/events' ) .all(function (req, res, next ) }) .get(function (req, res, next ) res.json(...); }) .post(function (req, res, next ) })
app.set(name, value) 给name设置项赋value值，name是app settings table 中属性的一项。app.set('foo', ture)等价于调用app.enable('foo')。同样的，调用app.set('foo', false)等价于调用app.disable('foo')。app.get()来取得设置的值：app.set('title' , 'My Site' ); app.get('title' );
Application Settings name是程序设置之一，它将影响到程序的行为。下边列出了程序中的设置。
Property
Type
Value
Default
case sensitive routing
Boolean
启用区分大小写。
不启用。对/Foo和/foo处理是一样。
env
String
环境模型。
process.env.NODE_ENV(NODE_ENV环境变量)或者”development”
jsonp callback name
String
指定默认JSONP回调的名称。
?callback=
json replacer
String
JSON替代品回调
null
json spaces
Number
当设置了这个值后，发送缩进空格美化过的JSON字符串。
Disabled
query parser
Varied
设置值为
false来禁用
query parser，或者设置
simple,
extended，也可以自己实现
query string解析函数。
simple基于
Node原生的
query解析，
querystring 。
“extend”
strict routing
Boolean
启用严格的路由。
不启用。对/foo和/foo/的路由处理是一样。
subdomain offset
Number
用来删除访问子域的主机点分部分的个数
2
trust proxy
Varied
指示
app在一个反向代理的后面，使用
x-Forwarded-*来确定连接和客户端的IP地址。注意:
X-Forwarded-*头部很容易被欺骗，所有检测客户端的IP地址是靠不住的。
trust proxy默认不启用。当启用时，Express尝试通过前端代理或者一系列代理来获取已连接的客户端IP地址。
req.ips属性包含了已连接客户端IP地址的一个数组。为了启动它，需要设置在下面
trust proxy options table 中定义的值。
trust proxy的设置实现使用了
proxy-addr包。如果想获得更多的信息，可以查阅它的文档
Disable
views
String or Array
view所在的目录或者目录数组。如果是一个数组，将按在数组中的顺序来查找view。
process.cwd() + ‘/views’
view cache
Boolean
启用视图模板编译缓存。
在生成环境默认开启。
view engine
String
省略时，默认的引擎被扩展使用。
x-powered-by
Boolean
启用X-Powered-By:ExpressHTTP头部
true
Options for trust proxy settings Express behind proxies 来获取更多信息。
Type Value Boolean
如果为true，客户端的IP地址作为X-Forwarded-*头部的最左边的条目。如果为false，可以理解为app直接与英特网直连，客户端的IP地址衍生自req.connection.remoteAddress。false是默认设置。
IP addresses
一个IP地址，子网，或者一组IP地址，和委托子网。下面列出的是一个预先配置的子网名列表。
loopback - 127.0.0.1/8, ::1/128 linklocal - 169.254.0.0/16, fe80::/10 uniquelocal - 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, fc00::/7 使用下面方法中的任何一种来设置IP地址:
app. set ( ‘trust proxy’ , ‘loopback’ ) app. set ( ‘trust proxy’ , ‘loopback, 123.123.123.123’ ) app. set ( ‘trust proxy’ , ‘loopback, linklocal, uniquelocal’ ) app. set ( ‘trust proxy’ , [ ‘loopback’ , ‘linklocal’ , ‘uniquelocal’ ] ) 当指定IP地址之后, 这个IP地址或子网会被设置了这个IP地址或子网的app排除在外, 最靠近程序服务的没有委托的地址将被看做客户端IP地址。
Number
信任从反向代理到app中间小于等于n跳的连接为客户端。
Function
客户自定义委托代理信任机制。如果你使用这个，请确保你自己知道你在干什么。
app. set ( ‘trust proxy’ , function ( ip) { if ( ip === ‘127.0.0.1’ || ip === ‘123.123.123.123’ ) return true ; else return false ; } ) Options for etag settings ETag功能的实现使用了etag 包。如果你需要获得更多的信息，你可以查阅它的文档。
Type Value Boolean
设置为true，启用weak ETag。这个是默认设置。设置false，禁用所有的ETag。
String
strong，使能strong ETag。如果是weak，启用weak ETag。
Function
客户自定义ETag方法的实现. 如果你使用这个，请确保你自己知道你在干什么。
app. set ( ‘etag’ , function ( body, encoding) { return generateHash( body, encoding) ; } ) app.use([path,], function [, function…]) 挂载中间件 方法到路径上。如果路径未指定，那么默认为”/“。
一个路由将匹配任何路径如果这个路径以这个路由设置路径后紧跟着”/“。比如：app.use('/appale', ...)将匹配”/apple”，”/apple/images”，”/apple/images/news”等。
中间件中的req.originalUrl是req.baseUrl和req.path的组合，如下面的例子所示。app.use('/admin' , function (req, res, next ) console .log(req.originalUrl); console .log(req.baseUrl); console .log(req.path);});
在一个路径上挂载一个中间件之后，每当请求的路径的前缀部分匹配了这个路由路径，那么这个中间件就会被执行。/，中间件挂载没有指定路径，那么对于每个请求，这个中间件都会被执行。app.use(function (req, res, next ) console .log('Time: %d' , Date .now()); next(); });
中间件方法是顺序处理的，所以中间件包含的顺序是很重要的。app.use(function (req, res, next ) res.send('Hello World' ); }); app.use('/' , function (req, res ) res.send('Welcome' ); });
路径可以是代表路径的一串字符，一个路径模式，一个匹配路径的正则表达式，或者他们的一组集合。
下面是路径的简单的例子。
Type Example Path
app. use( ‘/abcd’ , function ( req, res, next) { next( ) ; } ) Path Pattern
app. use( ‘/abc?d’ , function ( req, res, next) { next( ) ; } ) . use( ‘/ab+cd’ , function ( req, res, next) { next( ) ; } ) . use( ‘/ab*cd’ , function ( req, res, next) { next( ) ; } ) . use( ‘/a(bc)?d’ , function ( req, res, next) { next( ) ; } ) Regular Expression
app. use( /\/abc|\/xyz/ , function ( req, res, next) { next( ) ; } ) Array
app. use( [ ‘/abcd’ , ‘/xyza’ , / \/ lmn| \/ pqr/ ] , function ( req, res, next) { next( ) ; } ) 方法可以是一个中间件方法，一系列中间件方法，一组中间件方法或者他们的集合。由于router和app实现了中间件接口，你可以像使用其他任一中间件方法那样使用它们。
Usage Example 单个中间件
你可以局部定义和挂载一个中间件。
app. use( function ( req, res, next) { next( ) ; } ) 一个
router是有效的中间件。
var router = express. Router( ) ; . get ( ‘/‘ , function ( req, res, next) { next( ) ; } ) . use( router) ; 一个
Express程序是一个有效的中间件。
var subApp = express( ) ; . get ( ‘/‘ , function ( req, res, next) { next( ) ; } ) . use( subApp) ; 一系列中间件
对于一个相同的挂载路径，你可以挂载超过一个的中间件。
var r1 = express. Router( ) ; . get ( ‘/‘ , function ( req, res, next) { next( ) ; } ) var r2 = express. Router( ) ; . get ( ‘/‘ , function ( req, res, next) { next( ) ; } ) . use( r1, r2) ; 一组中间件
在逻辑上使用一个数组来组织一组中间件。如果你传递一组中间件作为第一个或者唯一的参数，接着你需要指定挂载的路径。
var r1 = express. Router( ) ; . get ( ‘/‘ , function ( req, res, next) { next( ) ; } ) var r2 = express. Router( ) ; . get ( ‘/‘ , function ( req, res, next) { next( ) ; } ) . use( ‘/‘ , [ r1, r2] ) ; 组合
你可以组合下面的所有方法来挂载中间件。
function mw1( req, res, next) { next( ) ; } function mw2( req, res, next) { next( ) ; } var r1 = express. Router( ) ; . get ( ‘/‘ , function ( req, res, next) { next( ) ; } ) ; var r2 = express. Router( ) ; . get ( ‘/‘ , function ( req, res, next) { next( ) ; } ) ; var subApp = express( ) ; . get ( ‘/‘ , function ( req, res, next) { next( ) ; } ) ; . use( mw1, [ mw2, r1, r2] , subApp) ; 下面是一些例子，在Express程序中使用express.static中间件。public目录下的静态资源：app.use(express.static(__dirname + '/public' ));
在/static路径下挂载中间件来提供静态资源托管服务，只当请求是以/static为前缀的时候。app.use('/static' , express.static(express.__dirname + '/public' ));
通过在设置静态资源中间件之后加载日志中间件来关闭静态资源请求的日志。app.use(express.static(__dirname + '/public' )); app.use(logger());
托管静态资源从不同的路径，但./public路径比其他更容易被匹配：app.use(express.static(__dirname + '/public' )); app.use(express.static(__dirname + '/files' )); app.use(express.static(__dirname + '/uploads' ));
Request req对象代表了一个HTTP请求，其具有一些属性来保存请求中的一些数据，比如query string，parameters，body，HTTP headers等等。在本文档中，按照惯例，这个对象总是简称为req(http响应简称为res)，但是它们实际的名字由这个回调方法在那里使用时的参数决定。app.get('/user/:id' , function (req, res ) res.send('user' + req.params.id); });
其实你也可以这样写：app.get('/user/:id' , function (request, response ) response.send('user' + request.params.id); });
Properties 在Express 4中，req.files默认在req对象中不再是可用的。为了通过req.files对象来获得上传的文件，你可以使用一个multipart-handling(多种处理的工具集)中间件，比如busboy，multer，formidable，multipraty，connect-multiparty或者pez。
req.app 这个属性持有express程序实例的一个引用，其可以作为中间件使用。require()它，那么这个中间件可以通过req.app来获取express的实例。app.get("/viewdirectory" , require ('./mymiddleware.js' ));
module .exports = function (req, res ) res.send('The views directory is ' + req.app.get('views' )); }; req.baseUrl 一个路由实例挂载的Url路径。var greet = express.Router();greet.get('/jp' , function (req, res ) console .log(req.baseUrl); res.send('Konichiwa!' ); }); app.use('/greet' , greet);
即使你使用的路径模式或者一系列路径模式来加载路由，baseUrl属性返回匹配的字符串，而不是路由模式。下面的例子，greet路由被加载在两个路径模式上。app.use(['/gre+t' , 'hel{2}o' ], greet);
当一个请求路径是/greet/jp，baseUrl是/greet，当一个请求路径是/hello/jp，req.baseUrl是/hello。req.baseUrl和app对象的mountpath 属性相似，除了app.mountpath返回的是路径匹配模式。
req.body 在请求的body中保存的是提交的一对对键值数据。默认情况下，它是undefined，当你使用比如body-parser和multer这类解析body数据的中间件时，它是填充的。body-parser中间件来填充req.body。var app = require ('express' );var bodyParser = require ('body-parser' );var multer = require ('multer' )；var upload = multer(); app.use(bodyParser.json()); app.use(bodyParser.urlencoded({extended:true })); app.post('/profile' , upload.array(), function (req, res, next ) console .log(req.body); res.json(req.body); });
req.cookies 当使用cookie-parser中间件的时候，这个属性是一个对象，其包含了请求发送过来的cookies。如果请求没有带cookies，那么其值为{}。
获取更多信息，问题，或者关注，可以查阅cookie-parser 。
req.fresh 指示这个请求是否是新鲜的。其和req.stale是相反的。cache-control请求头没有no-cache指示和下面中的任一一个条件为true，那么其就为true：
if-modified-since请求头被指定，和last-modified请求头等于或者早于modified响应头。if-none-match请求头是*。if-none-match请求头在被解析进它的指令之后，不匹配etag响应头(完全不知道什么鬼)。req.hostname 包含了源自HostHTTP头部的hostname。trust proxy设置项被设置为启用值，X-Forwarded-Host头部被使用来代替Host。这个头部可以被客户端或者代理设置。
req.ips 当trust proxy设置项被设置为启用值，这个属性包含了一组在X-Forwarded-For请求头中指定的IP地址。不然，其就包含一个空的数组。这个头部可以被客户端或者代理设置。X-Forwarded-For是client，proxy1，proxy2，req.ips就是["clinet", "proxy1", "proxy2"]，这里proxy2就是最远的下游。
req.originalUrl
req.url不是一个原生的Express属性，它继承自Node’s http module 。
这个属性很像req.url；然而，其保留了原版的请求链接，允许你自由地重定向req.url到内部路由。比如，app.use()的mounting特点可以重定向req.url跳转到挂载点。
req.params 一个对象，其包含了一系列的属性，这些属性和在路由中命名的参数名是一一对应的。例如，如果你有/user/:name路由，name属性可作为req.params.name。这个对象默认值为{}。
当你使用正则表达式来定义路由规则，捕获组的组合一般使用req.params[n]，这里的n是第几个捕获租。这个规则被施加在无名通配符匹配，比如/file/*的路由：
req.path 包含请求URL的部分路径。
当在一个中间件中被调用，挂载点不包含在req.path中。你可以查阅app.use() 获得跟多的信息。
req.protocol 请求的协议，一般为http，当启用TLS加密，则为https。trust proxy设置一个启用的参数，如果存在X-Forwarded-Proto头部的话，其将被信赖和使用。这个头部可以被客户端或者代理设置。
req.query 一个对象，为每一个路由中的query string参数都分配一个属性。如果没有query string，它就是一个空对象，{}。req.query.q req.query.order req.query.shoe.color req.query.shoe.type
req.route 当前匹配的路由，其为一串字符。比如：app.get('/user/:id?' , function userIdHandler (req, res ) console .log(req.route); res.send('GET' ) })
前面片段的输出为:{ path:"/user/:id?" stack: [ { handle:[Function :userIdHandler], name:"userIdHandler" , params:undefined , path:undefined , keys:[], regexp:/^\/?$/i , method:'get' } ] methods:{get:true } }
req.secure 一个布尔值，如果建立的是TLS的连接，那么就为true。等价与：
req.signedCookies 当使用cookie-parser中间件的时候，这个属性包含的是请求发过来的签名cookies，不签名的并且为使用做好了准备(这句真不知道怎么翻译了…)。签名cookies驻留在不同的对象中来体现开发者的意图；不然，一个恶意攻击可以被施加在req.cookie值上(它是很容易被欺骗的)。记住，签名一个cookie不是把它藏起来或者加密；而是简单的防止篡改(因为签名使用的加密是私人的)。如果没有发送签名的cookie，那么这个属性默认为{}。
为了获取更多的信息，问题或者关注，可以参阅cookie-parser 。
req.stale 指示这个请求是否是stale(陈旧的)，它与req.fresh是相反的。更多信息，可以查看req.fresh 。
req.subdomains 请求中域名的子域名数组。
req.xhr 一个布尔值，如果X-Requested-With的值为XMLHttpRequest，那么其为true，其指示这个请求是被一个客服端库发送，比如jQuery。
Methods req.accepts(types) 检查这个指定的内容类型是否被接受，基于请求的Accept HTTP头部。这个方法返回最佳匹配，如果没有一个匹配，那么其返回undefined(在这个case下，服务器端应该返回406和”Not Acceptable”)。type值可以是一个单的MIME type字符串(比如application/json)，一个扩展名比如json，一个逗号分隔的列表，或者一个数组。对于一个列表或者数组，这个方法返回最佳项(如果有的话)。1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 req.accepts('html' ); req.accepts('html' ); req.accepts('text/html' ); req.accepts(['json' , 'text' ]); req.accepts('application/json' ); req.accepts('image/png' ); req.accepts('png' ); req.accepts(['html' , 'json' ]);
获取更多信息，或者如果你有问题或关注，可以参阅accepts 。
req.acceptsCharsets(charset[, …]) 返回指定的字符集集合中第一个的配置的字符集，基于请求的Accept-CharsetHTTP头。如果指定的字符集没有匹配的，那么就返回false。accepts 。
req.acceptsEncodings(encoding[, …]) 返回指定的编码集合中第一个的配置的编码，基于请求的Accept-EncodingHTTP头。如果指定的编码集没有匹配的，那么就返回false。accepts 。
req.acceptsLanguages(lang [, …]) 返回指定的语言集合中第一个的配置的语言，基于请求的Accept-LanguageHTTP头。如果指定的语言集没有匹配的，那么就返回false。accepts 。
req.get(field) 返回指定的请求HTTP头部的域内容(不区分大小写)。Referrer和Referer的域内容可互换。req.get('Content-type' ); req.get('content-type' ); req.get('Something' )
其是req.header(field)的别名。
req.is(type) 如果进来的请求的Content-type头部域匹配参数type给定的MIME type，那么其返回true。否则返回false。req.is('html' ); req.is('text/html' ); req.is('text/*' ); req.is('json' ); req.is('application/json' ); req.is('application/*' ); req.is('html' );
获取更多信息，或者如果你有问题或关注，可以参阅type-is 。
req.param(naem, [, defaultValue])
过时的。可以在适合的情况下，使用req.params，req.body或者req.query。
返回当前参数name的值。req.param('name' ) req.param('name' ) req.param('name' )
按下面给出的顺序查找：
req.params
req.body
req.query
可选的，你可以指定一个defaultValue来设置一个默认值，如果这个参数在任何一个请求的对象中都不能找到。
直接通过req.params，req.body，req.query取得应该更加的清晰-除非你确定每一个对象的输入。Body-parser中间件必须加载，如果你使用req.param()。详细请看req.body 。
Response res对象代表了当一个HTTP请求到来时，Express程序返回的HTTP响应。在本文档中，按照惯例，这个对象总是简称为res(http请求简称为req)，但是它们实际的名字由这个回调方法在那里使用时的参数决定。app.get('/user/:id' , function (req, res ) res.send('user' + req.params.id); });
这样写也是一样的：app.get('/user/:id' , function (request, response ) response.send('user' + request.params.id); });
Properties res.app 这个属性持有express程序实例的一个引用，其可以在中间件中使用。res.app和请求对象中的req.app属性是相同的。
布尔类型的属性，指示这个响应是否已经发送HTTP头部。app.get('/' , function (req, res ) console .log(res.headersSent); res.send('OK' ); console .log(res.headersSent); });
res.locals 一个对象，其包含了响应的能够反应出请求的本地参数和因此只提供给视图渲染，在请求响应的周期内(如果有的话)–我要翻译吐了。否则，其和app.locals是一样的。(不知道翻译的什么…)app.use(function (req, res, next ) res.locals.user = req.user; res.locals.authenticated = !req.user.anonymous; next(); });
Methods res.append(field [, value])
res.append()方法在Expresxs4.11.0以上版本才支持。
在指定的field的HTTP头部追加特殊的值value。如果这个头部没有被设置，那么将用value新建这个头部。value可以是一个字符串或者数组。res.append()之后调用app.set()函数将重置前面设置的值。res.append('Lind' , ['<http://localhost>' , '<http://localhost:3000>' ]); res.append('Set-Cookie' , 'foo=bar;Path=/;HttpOnly' ); res.append('Warning' , '199 Miscellaneous warning' );
res.attachment([filename]) 设置HTTP响应的Content-Disposition头内容为”attachment”。如果提供了filename，那么将通过res.type()获得扩展名来设置Content-Type，并且设置Content-Disposition内容为”filename=”parameter。res.attachment(); res.attachment('path/to/logo.png' );
res.cookie(name, value [,options]) 设置name和value的cookie，value参数可以是一串字符或者是转化为json字符串的对象。
属性
类型
描述
domain
String
设置cookie的域名。默认是你本app的域名。
expires
Date
cookie的过期时间，GMT格式。如果没有指定或者设置为0，则产生新的cookie。
httpOnly
Boolean
这个cookie只能被web服务器获取的标示。
maxAge
String
是设置过去时间的方便选项，其为过期时间到当前时间的毫秒值。
path
String
cookie的路径。默认值是/。
secure
Boolean
标示这个cookie只用被HTTPS协议使用。
signed
Boolean
指示这个cookie应该是签名的。
res.cookie()所作的都是基于提供的options参数来设置Set-Cookie头部。没有指定任何的options，那么默认值在RFC6265中指定。
使用实例：res.cookie('name' , 'tobi' , {'domain' :'.example.com' , 'path' :'/admin' , 'secure' :true }); res.cookie('remenberme' , '1' , {'expires' :new Date (Date .now() + 90000 ), 'httpOnly' :true });
maxAge是一个方便设置过期时间的方便的选项，其以当前时间开始的毫秒数来计算。下面的示例和上面的第二条功效一样。res.cookie('rememberme' , '1' , {'maxAge' :90000 }, "httpOnly" :true );
你可以设置传递一个对象作为value的参数。然后其将被序列化为Json字符串，被bodyParser()中间件解析。res.cookie('cart' , {'items' :[1 , 2 , 3 ]}); res.cookie('cart' , {'items' :[1 , 2 , 3 ]}, {'maxAge' :90000 });
当我们使用cookie-parser中间件的时候，这个方法也支持签名的cookie。简单地，在设置options时包含signed选项为true。然后res.cookie()将使用传递给cookieParser(secret)的密钥来签名这个值。res.cookie('name' , 'tobi' , {'signed' :true });
res.clearCookie(name [,options]) 根据指定的name清除对应的cookie。更多关于options对象可以查阅res.cookie()。res.cookie('name' , 'tobi' , {'path' :'/admin' }); res.clearCookie('name' , {'path' :'admin' });
res.download(path, [,filename], [,fn]) 传输path指定文件作为一个附件。通常，浏览器提示用户下载。默认情况下，Content-Disposition头部”filename=”的参数为path(通常会出现在浏览器的对话框中)。通过指定filename参数来覆盖默认值。fn指定的回调方法。这个方法使用res.sendFile()来传输文件。res.download('/report-12345.pdf' ); res.download('/report-12345.pdf' , 'report.pdf' ); res.download('report-12345.pdf' , 'report.pdf' , function (err ) if (err) {} else { } });
res.end([data] [, encoding]) 结束本响应的过程。这个方法实际上来自Node核心模块，具体的是response.end() method of http.ServerResponse 。res.send() 和res.json() 这类的方法。res.end(); res.status(404 ).end();
进行内容协商，根据请求的对象中AcceptHTTP头部指定的接受内容。它使用req.accepts() 来选择一个句柄来为请求服务，这些句柄按质量值进行排序。如果这个头部没有指定，那么第一个方法默认被调用。当不匹配时，服务器将返回406“Not Acceptable”，或者调用default回调。Content-Type请求头被设置，当一个回调方法被选择。然而你可以改变他，在这个方法中使用这些方法，比如res.set()或者res.type()。{"message":"hey"}，当请求的对象中Accept头部设置成”application/json”或者”/json”(不过如果是` /*`，然后这个回复就是”hey”)。res.format({ 'text/plain':function() { res.send('hey')' }, 'text/html':function() { res.send('<p>hey</p>'); }, 'application/json':function() { res.send({message:'hey'}); }, 'default':function() { res.status(406).send('Not Acceptable'); } })
除了规范化的MIME类型之外，你也可以使用拓展名来映射这些类型来避免冗长的实现：res.format({ text:function ( res.send('hey' ); }, html:function ( res.send('<p>hey</p>' ); }, json:function ( res.send({message:'hey' }); } })
res.get(field) 返回field指定的HTTP响应的头部。匹配是区分大小写。
res.json([body]) 发送一个json的响应。这个方法和将一个对象或者一个数组作为参数传递给res.send()方法的效果相同。不过，你可以使用这个方法来转换其他的值到json，例如null，undefined。(虽然这些都是bv伟德登录入口上无效的JSON)。res.json(null ); res.json({user:'tobi' }); res.status(500 ).json({error:'message' });
res.jsonp([body]) 发送一个json的响应，并且支持JSONP。这个方法和res.json()效果相同，除了其在选项中支持JSONP回调。res.jsonp(null ) res.jsonp({user:'tobi' }) res.status(500 ).jsonp({error:'message' })
默认情况下，jsonp的回调方法简单写作callback。可以通过jsonp callback name 设置来重写它。res.jsonp({user:'tobo' }) app.set('jsonp callback name' , 'cb' ) res.status(500 ).jsonp({error:'message' })
res.links(links) 连接这些links，links是以传入参数的属性形式提供，连接之后的内容用来填充响应的Link HTTP头部。res.links({ next:'http://api.example.com/users?page=2' , last:'http://api.example.com/user?page=5' });
效果：Link:<http: //api.example.com /users ?page =2 > ;"next" , <http: //api.example.com /users ?page =5 > ;"last"
res.location(path) 设置响应的LocationHTTP头部为指定的path参数。res.location('/foo/bar' ); res.location('http://example.com' ); res.location('back' );
当path参数为back时，其具有特殊的意义，其指定URL为请求对象的Referer头部指定的URL。如果请求中没有指定，那么其即为”/“。
Express传递指定的URL字符串作为回复给浏览器响应中的Location头部的值，不检测和操作，除了当是back这个case时。浏览器有推导预期URL从当前的URL或者指定的URL，和在Location指定的URL的责任；相应地重定向它。(我也不知道翻译的什么…)
res.redirect([status,] path) 重定向来源于指定path的URL，以及指定的HTTP status code status。如果你没有指定status，status code默认为”302 Found”。res.redirect('/foo/bar' ); res.redirect('http://example.com' ); res.redirect(301 , 'http://example.com' ); res.redirect('../login' );
重定向也可以是完整的URL，来重定向到不同的站点。res.redirect('http://google.com' );
重定向也可以相对于主机的根路径。比如，如果程序的路径为http://example.com/admin/post/new，那么下面将重定向到http://example.com/admim:
重定向也可以相对于当前的URL。比如，来之于http://example.com/blog/admin/(注意结尾的/)，下面将重定向到http://example.com/blog/admin/post/new。res.redirect('post/new' );
如果来至于http://example.com/blog/admin（没有尾部/），重定向post/new，将重定向到http://example.com/blog/post/new。如果你觉得上面很混乱，可以把路径段认为目录(有’/‘)或者文件，这样是可以的。相对路径的重定向也是可以的。如果你当前的路径为http://example.com/admin/post/new，下面的操作将重定向到http://example.com/admin/post：
back将重定向请求到referer ，当没有referer的时候，默认为/。
res.render(view [, locals] [, callback]) 渲染一个视图，然后将渲染得到的HTML文档发送给客户端。可选的参数为:
locals，定义了视图本地参数属性的一个对象。callback，一个回调方法。如果提供了这个参数，render方法将返回错误和渲染之后的模板，并且不自动发送响应。当有错误发生时，可以在这个回调内部，调用next(err)方法。
本地变量缓存使能视图缓存。在开发环境中缓存视图，需要手动设置为true；视图缓存在生产环境中默认开启。
res.render('index' ); res.render('index' , function (err, html ) res.send(html); }); res.render('user' , {name:'Tobi' }, function (err, html ) }); res.send([body]) 发送HTTP响应。body参数可以是一个Buffer对象，一个字符串，一个对象，或者一个数组。比如：res.send(new Buffer('whoop' )); res.send({some:'json' }); res.send('<p>some html</p>' ); res.status(404 ).send('Sorry, we cannot find that!' ); res.status(500 ).send({ error: 'something blew up' });
对于一般的非流请求，这个方法可以执行许多有用的的任务：比如，它自动给Content-LengthHTTP响应头赋值(除非先前定义)，也支持自动的HEAD和HTTP缓存更新。Buffer对象，这个方法设置Content-Type响应头为application/octet-stream，除非事先提供，如下所示:res.set('Content-Type' , 'text/html' ); res.send(new Buffer('<p>some html</p>' ));
当参数是一个字符串，这个方法设置Content-Type响应头为text/html：res.send('<p>some html</p>' );
当参数是一个对象或者数组，Express使用JSON格式来表示：res.send({user:'tobi' }); res.send([1 , 2 , 3 ]);
res.sendFile(path [, options] [, fn])
res.sendFile()从Express v4.8.0开始支持。
传输path指定的文件。根据文件的扩展名设置Content-TypeHTTP头部。除非在options中有关于root的设置，path一定是关于文件的绝对路径。options参数的细节:
属性
描述
默认值
可用版本
maxAge
设置
Cache-Control的
max-age属性，格式为毫秒数，或者是
ms format 的一串字符串
0
lastModified
设置Last-Modified头部为此文件在系统中的最后一次修改时间。设置false来禁用它
Enable
4.9.0+
headers
一个对象，包含了文件所在的sever的HTTP头部。(不知道怎么翻译了)
dotfiles
是否支持点开头文件名的选项。可选的值”allow”,”deny”,”ignore”
“ignore”
当传输完成或者发生了什么错误，这个方法调用fn回调方法。如果这个回调参数指定了和一个错误发生，回调方法必须明确地通过结束请求-响应循环或者传递控制到下个路由来处理响应过程。res.sendFile()的例子：1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 app.get('/file/:name' , function (req, res, next ) var options = { root:__dirname + '/public' , dotfile:'deny' , headers:{ 'x-timestamp' :Date .now(), 'x-sent' :true } }; var fileName = req.params.name; res.sendFile(fileName, options, function (err ) if (err) { console .log(err); res.status(err.status).end(); } else { console .log('sent' , fileName); } }); });
res.sendFile提供了文件服务的细粒度支持，如下例子说明：app.get('/user/:uid/photos/:file' , function (req, res ) var uid = req.params.uid , file = req.params.file; req.user.mayViewFilesFrom(uid, function (yes ) if (yes) { res.sendFile('/upload/' + uid + '/' + file); } else { res.status(403 ).send('Sorry! you cant see that.' ); } }); })
获取更多信息，或者你有问题或者关注，可以查阅send 。
res.sendStatus(statusCode) 设置响应对象的HTTP status code为statusCode并且发送statusCode的相应的字符串形式作为响应的Body。res.sendStatus(200 ); res.sendStatus(403 ); res.sendStatus(404 ); res.sendStatus(500 );
如果一个不支持的状态被指定，这个HTTP status依然被设置为statusCode并且用这个code的字符串作为Body。
More about HTTP Status Codes
res.set(field [, value]) 设置响应对象的HTTP头部field为value。为了一次设置多个值，那么可以传递一个对象为参数。res.set('Content-Type' , 'text/plain' ); res.set({ 'Content-Type' :'text/plain' , 'Content-Length' :'123' , 'ETag' :'123456' })
其和res.header(field [,value])效果一致。
res.status(code) 使用这个方法来设置响应对象的HTTP status。其是Node中response.statusCode 的一个连贯性的别名。res.status(403 ).end(); res.status(400 ).send('Bad Request' ); res.status(404 ).sendFile('/absolute/path/to/404.png' );
res.type(type) 设置Content-TypeHTTP头部为MIME type，如果这个指定的type能够被mime.lookup 确定。如果type包含/字符，那么设置Content-Type为type(我已经晕了)。res.type('.html' ); res.type('html' ); res.type('json' ); res.type('application/json' ); res.type('png' );
res.vary(field) 设置Vary响应头为field，如果已经不在那里。(不懂什么意思)res.vary('User-Agent' ).render('docs' );
Router 一个router对象是一个单独的实例关于中间件和路由。你可以认为其是一个”mini-application”（迷你程序），其具有操作中间件和路由方法的能力。每个Express程序有一个内建的app路由。app.use()方法的一个参数或者作为另一个路由的use()的参数。express对象有一个Router()方法，你可以使用Router()来创建一个新的router对象。
Router([options]) 如下，可以创建一个路由：var router = express.Router([options]);
options参数可以指定路由的行为，其有下列选择：
属性
描述
默认值
可用性
caseSensitive
是否区分大小写
默认不启用。对待/Foo和/foo一样。
mergeParams
保存父路由的res.params。如果父路由参数和子路由参数冲突，子路由参数优先。
false
4.5.0+
strict
使能严格路由。
默认不启用，/foo和/foo/被路由一样对待处理
你可以将router当作一个程序，可以在其上添加中间件和HTTP路由方法(例如get，put，post等等)。router.use(function (req, res, next ) next(); }); router.get('/events' , function (req, res, next ) });
你可以在一个特别的根URL上挂载一个路由，这样你就以将你的各个路由放到不同的文件中或者甚至是mini的程序。app.use('/calendar' , router);
Methods router.all(path, [callback, …] callback) 这个方法和router.METHOD()方法一样，除了这个方法会匹配所有的HTTP动作。loaduser可以执行一个任务，然后调用next()来将执行流程移交到随后的路由。router.all('*' , requireAuthentication, loadUser);
相等的形式:router.all('*' , requireAuthentication) router.all('*' , loadUser);
这是一个白名单全局功能的例子。这个例子很像前面的，不过其仅仅作用于以/api开头的路径:router.all('/api/*' , requireAuthentication);
router.METHOD(path, [callback, …] callback) router.METHOD()方法提供了路由方法在Express中，这里的METHOD是HTTP方法中的一个，比如GET，PUT，POST等等，但router中的METHOD是小写的。所以，实际的方法是router.get()，router.put()，router.post()等等。next('router')来绕过剩余的路由回调。你可以使用这个机制来为一个路由设置一些前提条件，如果请求没有满足当前路由的处理条件，那么传递控制到随后的路由。Query strings，例如，”GET /“将匹配下面的路由，”GET /?name=tobi”也是一样的。router.get('/' , function (req, res ) res.send('Hello World' ); });
如果你对匹配的path有特殊的限制，你可以使用正则表达式，例如，下面的可以匹配”GET /commits/71dbb9c”和”GET /commits/71bb92..4c084f9”。router.get(/^\/commits\/(\w+)(?:\.\.(\w+))?$/ , function (req, res ) var from = req.params[0 ]; var to = req.params[1 ]; res.send('commit range ' + from + '..' + to); });
router.param(name, callback) 给路由参数添加回调触发器，这里的name是参数名，function是回调方法。回调方法的参数按序是请求对象，响应对象，下个中间件，参数值和参数名。虽然name在bv伟德登录入口上是可选的，但是自Express V4.11.0之后版本不推荐使用(见下面)。
不像app.param()，router.param()不接受一个数组作为路由参数。
例如，当:user出现在路由路径中，你可以映射用户加载的逻辑处理来自动提供req.user给这个路由，或者对输入的参数进行验证。router.param('user' , function (req, res, next, id ) User.find(id, function (error, user ) if (err) { next(err); } else if (user){ req.user = user; } else { next(new Error ('failed to load user' )); } }); });
对于Param的回调定义的路由来说，他们是局部的。它们不会被挂载的app或者路由继承。所以，定义在router上的param回调只有是在router上的路由具有这个路由参数时才起作用。param的路由上，param回调都是第一个被调用的，它们在一个请求-响应循环中都会被调用一次并且只有一次，即使多个路由都匹配，如下面的例子：router.param('id' , function (req, res, next, id ) console .log('CALLED ONLY ONCE' ); next(); }); router.get('/user/:id' , function (req, res, next ) console .log('although this matches' ); next(); }); router.get('/user/:id' , function (req, res ) console .log('and this mathces too' ); res.end(); });
当GET /user/42，得到下面的结果:CALLED ONLY ONCE
although this matches
and this matches too
下面章节描述的router.param(callback)在v4.11.0之后被弃用。
通过只传递一个回调参数给router.param(name, callback)方法，router.param(naem, callback)方法的行为将被完全改变。这个回调参数是关于router.param(name, callback)该具有怎样的行为的一个自定义方法，这个方法必须接受两个参数并且返回一个中间件。router.param(name, callback)参数签名被修改成了router.param(name, accessId)。替换接受一个参数名和回调，router.param()现在接受一个参数名和一个数字。1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 var express = require ('express' );var app = express();var router = express.Router();router.param(function (param, option ) return function (req, res, next, val ) if (val == option) { next(); } else { res.sendStatus(403 ); } } }); router.param('id' , 1337 ); router.get('/user/:id' , function (req, res ) res.send('Ok' ); }); app.use(router); app.listen(3000 , function ( console .log('Ready' ); });
在这个例子中，router.param(name. callback)参数签名保持和原来一样，但是替换成了一个中间件，定义了一个自定义的数据类型检测方法来检测user id的类型正确性。router.param(function (param, validator ) return function (req, res, next, val ) if (validator(val)) { next(); } else { res.sendStatus(403 ); } } }); router.param('id' , function (candidate ) return !isNaN (parseFloat (candidate)) && isFinite (candidate); });
router.route(path) 返回一个单例模式的路由的实例，之后你可以在其上施加各种HTTP动作的中间件。使用app.route()来避免重复路由名字(因此错字错误)–后面这句不知道说的什么鬼，大概的意思就是避免同一个路径有两个路由实例。router.param()例子之上，下面的代码展示了怎么使用router.route()来指定各种HTTP方法的处理句柄。1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 var router = express.Router();router.param('user_id' , function (req, res, next, id ) req.user = { id:id, name:"TJ" }; next(); }); router.route('/users/:user_id' ) .all(function (req, res, next ) next(); }) .get(function (req, res, next ) res.json(req.user); }) .put(function (req, res, next ) req.user.name = req.params.name; res.json(req.user); }) .post(function (req, res, next ) next(new Error ('not implemented' )); }) .delete(function (req, res, next ) next(new Error ('not implemented' )); })
这种方法重复使用单个/usrs/:user_id路径来添加了各种的HTTP方法。
router.use([path], [function, …] function) 给可选的path参数指定的路径挂载给定的中间件方法，未指定path参数，默认值为/。app.use()。一个简单的例子和用例在下面描述。查阅app.use() 获得更多的信息。1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 var express = require ('express' );var app = express();var router = express.Router();router.use(function (req, res, next ) console .log('%s %s %s' , req.method, req.url, req.path); next(); }) router.use('/bar' , function (req, res, next ) next(); }) router.use(function (req, res, next ) res.send('hello world' )； }) app.use('/foo' , router); app.listen(3000 );
对于中间件function，挂载的路径是被剥离的和不可见的。关于这个特性主要的影响是对于不同的路径，挂载相同的中间件可能对代码不做改动，尽管其前缀已经改变。router.use()定义中间件的顺序很重要。中间们是按序被调用的，所以顺序决定了中间件的优先级。例如，通常日志是你将使用的第一个中间件，以便每一个请求都被记录。var logger = require ('morgan' );router.use(logger()); router.use(express.static(__dirname + '/public' )); router.use(function (req, res ) res.send('Hello' ); });
现在为了支持你不希望记录静态文件请求，但为了继续记录那些定义在logger()之后的路由和中间件。你可以简单的将static()移动到前面来解决：router.use(express.static(__dirname + '/public' )); router.use(logger()); router.use(function (req, res ) res.send('Hello' ); });
另外一个确凿的例子是从不同的路径托管静态文件，你可以将./public放到前面来获得更高的优先级:app.use(express.static(__dirname + '/public' )); app.use(express.static(__dirname + '/files' )); app.use(express.static(__dirname + '/uploads' ));
router.use()方法也支持命名参数，以便你的挂载点对于其他的路由而言，可以使用命名参数来进行预加载，这样做是很有益的。
本文来自：https://github.com/ZhouBox/express_api_4.x_chinese
]]>
