node.js express 中文参考手册

酒店家具 發表於 2019-9-5 12:07:00

https://www.runoob.com/w3cnote/express-4-x-api.html
原文地址：https://www.zybuluo.com/bajian/note/444152
<div id="editor-reader-full" class="editor-reader-full-shown">
<div id="wmd-preview" class="wmd-preview wmd-preview-full-reader" data-medium-element="true">
<div class="md-section-divider"> </div>
<h1 id="express-4x-api" data-anchor-id="xzv9">Express 4.x API</h1>
<code>express</code> <code>翻译</code> <code>api文档</code> <code>中文</code>
<hr>
<div class="md-section-divider"> </div>
<h2 id="express" data-anchor-id="g84f">express()</h2>
<code>express()</code>用来创建一个Express的程序。<code>express()</code>方法是express模块导出的顶层方法。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>var express = require('express');</code></li>
<li class="L1"><code>var app = express();</code></li>
</ol>
<div class="md-section-divider"> </div>
<h3 id="methods" data-anchor-id="wc6i">Methods</h3>
<div class="md-section-divider"> </div>
<h4 id="expressstaticroot-options" data-anchor-id="28ae">express.static(root, )</h4>
<code>express.static</code>是Express中唯一的内建中间件。它以server-static模块为基础开发，负责托管 Express 应用内的静态资源。  参数<code>root</code>为静态资源的所在的根目录。  参数<code>options</code>是可选的，支持以下的属性：
<table class="table table-striped-white table-bordered" data-anchor-id="64aw">
<thead>
<tr><th>属性</th><th>描述</th><th>类型</th><th>默认值</th></tr>

</thead>
<tbody>
<tr>
<td>dotfiles</td>
<td>是否响应点文件。供选择的值有"allow"，"deny"和"ignore"</td>
<td>String</td>
<td>"ignore"</td>

</tr>
<tr>
<td>etag</td>
<td>使能或者关闭etag</td>
<td>Boolean</td>
<td>true</td>

</tr>
<tr>
<td>extensions</td>
<td>设置文件延期回退</td>
<td>Boolean</td>
<td>true</td>

</tr>
<tr>
<td>index</td>
<td>发送目录索引文件。设置false将不发送。</td>
<td>Mixed</td>
<td>"index.html"</td>

</tr>
<tr>
<td>lastModified</td>
<td>设置文件在系统中的最后修改时间到<code>Last-Modified</code>头部。可能的取值有<code>false</code>和<code>true</code>。</td>
<td>Boolean</td>
<td>true</td>

</tr>
<tr>
<td>maxAge</td>
<td>在Cache-Control头部中设置<code>max-age</code>属性，精度为毫秒(ms)或则一段ms format的字符串</td>
<td>Number</td>
<td>0</td>

</tr>
<tr>
<td>redirect</td>
<td>当请求的pathname是一个目录的时候，重定向到尾随"/"</td>
<td>Boolean</td>
<td>true</td>

</tr>
<tr>
<td>setHeaders</td>
<td>当响应静态文件请求时设置headers的方法</td>
<td>Funtion</td>
<td> </td>

</tr>

</tbody>

</table>
如果你想获得更多关于使用中间件的细节，你可以查阅Serving static files in Express。
<div class="md-section-divider"> </div>
<h2 id="application" data-anchor-id="90ia">Application()</h2>
<code>app</code>对象一般用来表示Express程序。通过调用Express模块导出的顶层的<code>express()</code>方法来创建它:
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>var express = require('express');</code></li>
<li class="L1"><code>var app = express();</code></li>
<li class="L2"><code></code></li>
<li class="L3"><code>app.get('/', function(req, res) {</code></li>
<li class="L4"><code> res.send('hello world!');</code></li>
<li class="L5"><code>});</code></li>
<li class="L6"><code></code></li>
<li class="L7"><code>app.listen(3000);</code></li>

</ol>
<code>app</code>对象具有以下的方法：
<ul data-anchor-id="life">
<li>路由HTTP请求；具体可以看app.METHOD和app.param这两个例子。</li>
<li>配置中间件；具体请看app.route。</li>
<li>渲染HTML视图；具体请看app.render。</li>
<li>注册模板引擎；具体请看app.engine。</li>

</ul>
它还有一些属性设置，这些属性可以改变程序的行为。获得更多的信息，可以查阅Application settings。
<div class="md-section-divider"> </div>
<h3 id="properties" data-anchor-id="68ot">Properties</h3>
<div class="md-section-divider"> </div>
<h4 id="applocals" data-anchor-id="1ny2">app.locals</h4>
<code>app.locals</code>对象是一个javascript对象，它的属性就是程序本地的变量。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.locals.title</code></li>
<li class="L1"><code>// => 'My App'</code></li>
<li class="L2"><code></code></li>
<li class="L3"><code>app.locals.email</code></li>
<li class="L4"><code>// => 'me@myapp.com'</code></li>

</ol>
一旦设定，<code>app.locals</code>的各属性值将贯穿程序的整个生命周期，与其相反的是<code>res.locals</code>，它只在这次请求的生命周期中有效。
在程序中，你可以在渲染模板时使用这些本地变量。它们是非常有用的，可以为模板提供一些有用的方法，以及<code>app</code>级别的数据。通过<code>req.app.locals</code>(具体查看req.app)，Locals可以在中间件中使用。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.locals.title = 'My App';</code></li>
<li class="L1"><code>app.locals.strftime = require('strftime');</code></li>
<li class="L2"><code>app.locals.email = 'me@myapp.com';</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="appmountpath" data-anchor-id="tncp">app.mountpath</h4>
<code>app.mountpath</code>属性是子程序挂载的路径模式。
<blockquote class="white-blockquote" data-anchor-id="g94s">
一个子程序是一个<code>express</code>的实例，其可以被用来作为路由句柄来处理请求。

</blockquote>
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>var express = require('express');</code></li>
<li class="L1"><code>var app = express(); // the main app</code></li>
<li class="L2"><code>var admin = express(); // the sub app</code></li>
<li class="L3"><code>admin.get('/', function(req, res) {</code></li>
<li class="L4"><code> console.log(admin.mountpath); // /admin</code></li>
<li class="L5"><code> res.send('Admin Homepage');</code></li>
<li class="L6"><code>});</code></li>
<li class="L7"><code></code></li>
<li class="L8"><code>app.use('/admin', admin); // mount the sub app</code></li>

</ol>
它和req对象的baseUrl属性比较相似，除了<code>req.baseUrl</code>是匹配的URL路径，而不是匹配的模式。如果一个子程序被挂载在多条路径模式，<code>app.mountpath</code>就是一个关于挂载路径模式项的列表，如下面例子所示。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>```</code></li>
<li class="L1"><code>var admin = express();</code></li>
<li class="L2"><code>admin.get('/', function(req, res) {</code></li>
<li class="L3"><code> console.log(admin.mountpath); // ['adm*n', '/manager'] </code></li>
<li class="L4"><code> res.send('Admin Homepage');</code></li>
<li class="L5"><code>});</code></li>
<li class="L6"><code></code></li>
<li class="L7"><code>var secret = express();</code></li>
<li class="L8"><code>secret.get('/', function(req, res) {</code></li>
<li class="L9"><code> console.log(secret.mountpath); // /secr*t</code></li>
<li class="L0"><code> res.send('Admin secret');</code></li>
<li class="L1"><code>});</code></li>
<li class="L2"><code></code></li>
<li class="L3"><code>admin.use('secr*t', secret); // load the 'secret' router on '/secr*t', on the 'admin' sub app</code></li>
<li class="L4"><code>app.use(['/adm*n', '/manager'], admin); // load the 'admin' router on '/adm*n' and'/manager' , on the parent app</code></li>

</ol>
<div class="md-section-divider"> </div>
<h3 id="events" data-anchor-id="atey">Events</h3>
<div class="md-section-divider"> </div>
<h4 id="apponmount-callbackparent" data-anchor-id="e4zv">app.on('mount', callback(parent))</h4>
当子程序被挂载到父程序时，<code>mount</code>事件被发射。父程序对象作为参数，传递给回调方法。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>var admin = express();</code></li>
<li class="L1"><code>admin.on('mount', function(parent) {</code></li>
<li class="L2"><code> console.log('Admin Mounted');</code></li>
<li class="L3"><code> console.log(parent); // refers to the parent app</code></li>
<li class="L4"><code>});</code></li>
<li class="L5"><code></code></li>
<li class="L6"><code>admin.get('/', function(req, res) {</code></li>
<li class="L7"><code> res.send('Admin Homepage');</code></li>
<li class="L8"><code>});</code></li>
<li class="L9"><code></code></li>
<li class="L0"><code>app.use('/admin', admin);</code></li>

</ol>
<div class="md-section-divider"> </div>
<h3 id="methods-1" data-anchor-id="78h0">Methods</h3>
<div class="md-section-divider"> </div>
<h4 id="appallpath-callback-callback" data-anchor-id="b9s5">app.all(path, callback[, callback ...]</h4>
<code>app.all</code>方法和标准的<code>app.METHOD()</code>方法相似，除了它匹配所有的HTTP动词。  对于给一个特殊前缀映射一个全局的逻辑处理，或者无条件匹配，它是很有效的。例如，如果你把下面内容放在所有其他的路由定义的前面，它要求所有从这个点开始的路由需要认证和自动加载一个用户。记住这些回调并不是一定是终点:<code>loadUser</code>可以在完成了一个任务后，调用<code>next()</code>方法来继续匹配随后的路由。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.all('*', requireAuthentication, loadUser);</code></li>

</ol>
或者这种相等的形式:
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.all('*', requireAuthentication);</code></li>
<li class="L1"><code> app.all('*', loadUser);</code></li>

</ol>
另一个例子是全局的白名单方法。这个例子和前面的很像，然而它只是限制以<code>/api</code>开头的路径。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.all('/api/*', requireAuthentication);</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="appdeletepath-callback-callback" data-anchor-id="cotj">app.delete(path, callback[, callback ...])</h4>
路由<code>HTTP DELETE</code>请求到有特殊回调方法的特殊的路径。获取更多的信息，可以查阅routing guide。  你可以提供多个回调函数，它们的行为和中间件一样，除了这些回调可以通过调用<code>next('router')</code>来绕过剩余的路由回调。你可以使用这个机制来为一个路由设置一些前提条件，如果不能满足当前路由的处理条件，那么你可以传递控制到随后的路由。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.delete('/', function(req, res) {</code></li>
<li class="L1"><code> res.send('DELETE request to homepage');</code></li>
<li class="L2"><code>});</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="appdisablename" data-anchor-id="6rin">app.disable(name)</h4>
设置类型为布尔的设置名为<code>name</code>的值为<code>false</code>，此处的<code>name</code>是app settings table中各属性的一个。调用<code>app.set('foo', false)</code>和调用<code>app.disable('foo')</code>是等价的。  比如:
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.disable('trust proxy');</code></li>
<li class="L1"><code>app.get('trust proxy');</code></li>
<li class="L2"><code>// => false</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="appdisabledname" data-anchor-id="e0m6">app.disabled(name)</h4>
返回<code>true</code>如果布尔类型的设置值<code>name</code>被禁用为<code>false</code>，此处的<code>name</code>是app settings table中各属性的一个。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.disabled('trust proxy');</code></li>
<li class="L1"><code> // => true</code></li>
<li class="L2"><code> app.enable('trust proxy');</code></li>
<li class="L3"><code> app.disabled('trust proxy');</code></li>
<li class="L4"><code> // => false</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="appenablename" data-anchor-id="3dff">app.enable(name)</h4>
设置布尔类型的设置值<code>name</code>为<code>true</code>，此处的<code>name</code>是app settings table中各属性的一个。调用<code>app.set('foo', true)</code>和调用<code>app.enable('foo')</code>是等价的。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.enable('trust proxy');</code></li>
<li class="L1"><code> app.get('trust proxy');</code></li>
<li class="L2"><code> // => true</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="appenabledname" data-anchor-id="l1e0">app.enabled(name)</h4>
返回<code>true</code>如果布尔类型的设置值<code>name</code>被启动为<code>true</code>，此处的<code>name</code>是app settings table中各属性的一个。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.enabled('trust proxy');</code></li>
<li class="L1"><code> // => false</code></li>
<li class="L2"><code> app.enable('trust proxy');</code></li>
<li class="L3"><code> app.enabled('trust proxy');</code></li>
<li class="L4"><code> // => true</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="appengineext-callback" data-anchor-id="gpid">app.engine(ext, callback)</h4>
注册给定引擎的回调，用来渲染处理ext文件。  默认情况下，Express需要使用<code>require()</code>来加载基于文件扩展的引擎。例如，如果你尝试渲染一个<code>foo.jade</code>文件，Express在内部调用下面的内容，同时缓存<code>require()</code>结果供随后的调用，来加速性能。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.engine('jade', require('jade').__express);</code></li>

</ol>
使用下面的方法对于那些没有提供开箱即用的<code>.__express</code>方法的模板，或者你希望使用不同的模板引擎扩展。  比如，使用EJS模板引擎来渲染<code>.html</code>文件：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.engine('html', require('ejs').renderFile);</code></li>

</ol>
在这个例子中，EJS提供了一个<code>.renderFile</code>方法，这个方法满足了Express规定的签名规则：<code>(path, options, callback)</code>，然而记住在内部它只是<code>ejs.__express</code>的一个别名，所以你可以在不做任何事的情况下直接使用<code>.ejs</code>扩展。  一些模板引擎没有遵循这种规范，consolidate.js库映射模板引擎以下面的使用方式，所以他们可以无缝的和Express工作。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>var engines = require('consolidate');</code></li>
<li class="L1"><code>app.engine('haml', engines.haml);</code></li>
<li class="L2"><code>app.engine('html', engines.hogan);</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="appgetname" data-anchor-id="e5xb">app.get(name)</h4>
获得设置名为<code>name</code>的app设置的值，此处的<code>name</code>是app settings table中各属性的一个。  如下：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.get('title');</code></li>
<li class="L1"><code>// => undefined</code></li>
<li class="L2"><code></code></li>
<li class="L3"><code>app.set('title', 'My Site');</code></li>
<li class="L4"><code>app.get('title');</code></li>
<li class="L5"><code>// => 'My Site'</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="appgetpath-callback-callback" data-anchor-id="hgje">app.get(path, callback [, callback ...])</h4>
路由<code>HTTP GET</code>请求到有特殊回调的特殊路径。获取更多的信息，可以查阅routing guide。  你可以提供多个回调函数，它们的行为和中间件一样，除了这些回调可以通过调用<code>next('router')</code>来绕过剩余的路由回调。你可以使用这个机制来为一个路由设置一些前提条件，如果请求没能满足当前路由的处理条件，那么传递控制到随后的路由。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.get('/', function(req, res) {</code></li>
<li class="L1"><code> res.send('GET request to homepage');</code></li>
<li class="L2"><code> });</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="applistenport-hostname-backlog-callback" data-anchor-id="n34h">app.listen(port, , , )</h4>
绑定程序监听端口到指定的主机和端口号。这个方法和<code>Node</code>中的http.Server.listen()是一样的。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> var express = require('express');</code></li>
<li class="L1"><code> var app = express();</code></li>
<li class="L2"><code> app.listen(3000);</code></li>

</ol>
通过调用<code>express()</code>返回得到的<code>app</code>实际上是一个JavaScript的<code>Function</code>，被设计用来作为一个回调传递给<code>Node HTTP servers</code>来处理请求。这样，其就可以很简便的基于同一份代码提供http和https版本，所以app没有从这些继承(它只是一个简单的回调)。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> var express = require('express');</code></li>
<li class="L1"><code> var https = require('https');</code></li>
<li class="L2"><code> var http = require('http');</code></li>
<li class="L3"><code></code></li>
<li class="L4"><code> http.createServer(app).listen(80);</code></li>
<li class="L5"><code> https.createServer(options, app).listen(443);</code></li>

</ol>
<code>app.listen()</code>方法是下面所示的一个便利的方法(只针对HTTP协议):
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.listen = function() {</code></li>
<li class="L1"><code> var server = http.createServer(this);</code></li>
<li class="L2"><code> return server.listen.apply(server, arguments);</code></li>
<li class="L3"><code> };</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="appmethodpath-callback-callback" data-anchor-id="ynjy">app.METHOD(path, callback [, callback ...])</h4>
路由一个HTTP请求，<code>METHOD</code>是这个请求的HTTP方法，比如<code>GET</code>，<code>PUT</code>，<code>POST</code>等等，注意是小写的。所以，实际的方法是<code>app.get()</code>，<code>app.post()</code>，<code>app.put()</code>等等。下面有关于方法的完整的表。  获取更多信息，请看routing guide。  Express支持下面的路由方法，对应与同名的HTTP方法：
<table class="table table-striped-white table-bordered" data-anchor-id="662o">
<tbody>
<tr>
<td>
<ul>
<li>checkout</li>
<li>connect</li>
<li>copy</li>
<li>delete</li>
<li>get</li>
<li>head</li>
<li>lock</li>
<li>merge</li>
<li>mkactivity</li>

</ul>

</td>
<td>
<ul>
<li>mkcol</li>
<li>move</li>
<li>m-search</li>
<li>notify</li>
<li>options</li>
<li>patch</li>
<li>post</li>
<li>propfind</li>
<li>proppatch</li>

</ul>

</td>
<td>
<ul>
<li>purege</li>
<li>put</li>
<li>report</li>
<li>search</li>
<li>subscribe</li>
<li>trace</li>
<li>unlock</li>
<li>unsubscribe</li>

</ul>

</td>

</tr>

</tbody>

</table>
<blockquote class="white-blockquote" data-anchor-id="2m75">
如果使用上述方法时，导致了无效的javascript的变量名，可以使用中括号符号，比如,<code>app['m-search']('/', function ...</code>

</blockquote>
你可以提供多个回调函数，它们的行为和中间件一样，除了这些回调可以通过调用<code>next('router')</code>来绕过剩余的路由回调。你可以使用这个机制来为一个路由设置一些前提条件，如果请求没有满足当前路由的处理条件，那么传递控制到随后的路由。
<blockquote class="white-blockquote" data-anchor-id="bupz">
本API文档把使用比较多的HTTP方法<code>app.get()</code>，<code>app.post</code>，<code>app.put()</code>，<code>app.delete()</code>作为一个个单独的项进行说明。然而，其他上述列出的方法以完全相同的方式工作。

</blockquote>
<code>app.all()</code>是一个特殊的路由方法，它不属于HTTP协议中的规定的方法。它为一个路径加载中间件，其对所有的请求方法都有效。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.all('/secret', function (req, res) {</code></li>
<li class="L1"><code> console.log('Accessing the secret section...');</code></li>
<li class="L2"><code> next(); // pass control to the next handler</code></li>
<li class="L3"><code> });</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="appparamname-callback" data-anchor-id="s66n">app.param(, callback)</h4>
给路由参数添加回调触发器，这里的<code>name</code>是参数名或者参数数组，<code>function</code>是回调方法。回调方法的参数按序是<code>请求对象</code>，<code>响应对象</code>，<code>下个中间件</code>，<code>参数值</code>和<code>参数名</code>。  如果<code>name</code>是数组，会按照各个参数在数组中被声明的顺序将回调触发器注册下来。还有，对于除了最后一个参数的其他参数，在他们的回调中调用<code>next()</code>来调用下个声明参数的回调。对于最后一个参数，在回调中调用<code>next()</code>将调用位于当前处理路由中的下一个中间件，如果<code>name</code>只是一个<code>string</code>那就和它是一样的(就是说只有一个参数，那么就是最后一个参数，和数组中最后一个参数是一样的)。  例如，当<code>:user</code>出现在路由路径中，你可以映射用户加载的逻辑处理来自动提供<code>req.user</code>给这个路由，或者对输入的参数进行验证。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.param('user', function(req, res, next, id) {</code></li>
<li class="L1"><code> User.find(id, function(error, user) {</code></li>
<li class="L2"><code> if (err) {</code></li>
<li class="L3"><code> next(err);</code></li>
<li class="L4"><code> }</code></li>
<li class="L5"><code> else if (user){</code></li>
<li class="L6"><code> req.user = user;</code></li>
<li class="L7"><code> } else {</code></li>
<li class="L8"><code> next(new Error('failed to load user'));</code></li>
<li class="L9"><code> }</code></li>
<li class="L0"><code> });</code></li>
<li class="L1"><code> });</code></li>

</ol>
对于<code>Param</code>的回调定义的路由来说，他们是局部的。它们不会被挂载的app或者路由继承。所以，定义在<code>app</code>上的<code>Param</code>回调只有是在<code>app</code>上的路由具有这个路由参数时才起作用。  在定义<code>param</code>的路由上，<code>param</code>回调都是第一个被调用的，它们在一个请求-响应循环中都会被调用一次并且只有一次，即使多个路由都匹配，如下面的例子：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.param('id', function(req, res, next, id) {</code></li>
<li class="L1"><code> console.log('CALLED ONLY ONCE');</code></li>
<li class="L2"><code> next();</code></li>
<li class="L3"><code>});</code></li>
<li class="L4"><code></code></li>
<li class="L5"><code>app.get('/user/:id', function(req, res, next) {</code></li>
<li class="L6"><code> console.log('although this matches');</code></li>
<li class="L7"><code> next();</code></li>
<li class="L8"><code>});</code></li>
<li class="L9"><code></code></li>
<li class="L0"><code>app.get('/user/:id', function(req, res) {</code></li>
<li class="L1"><code> console.log('and this mathces too');</code></li>
<li class="L2"><code> res.end();</code></li>
<li class="L3"><code>});</code></li>

</ol>
当<code>GET /user/42</code>，得到下面的结果:
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code class="language-log"> CALLED ONLY ONCE</code></li>
<li class="L1"><code class="language-log"> although this matches</code></li>
<li class="L2"><code class="language-log"> and this matches too</code></li>

</ol>
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.param(['id', 'page'], function(req, res, next, value) {</code></li>
<li class="L1"><code> console.log('CALLED ONLY ONCE with', value);</code></li>
<li class="L2"><code> next();</code></li>
<li class="L3"><code>});</code></li>
<li class="L4"><code></code></li>
<li class="L5"><code>app.get('/user/:id/:page', function(req. res, next) {</code></li>
<li class="L6"><code> console.log('although this matches');</code></li>
<li class="L7"><code> next();</code></li>
<li class="L8"><code>});</code></li>
<li class="L9"><code></code></li>
<li class="L0"><code>app.get('/user/:id/:page', function (req, res, next) {</code></li>
<li class="L1"><code> console.log('and this matches too');</code></li>
<li class="L2"><code> res.end();</code></li>
<li class="L3"><code>});</code></li>

</ol>
当执行<code>GET /user/42/3</code>，结果如下：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code class="language-log">CALLED ONLY ONCE with 42</code></li>
<li class="L1"><code class="language-log">CALLED ONLY ONCE with 3</code></li>
<li class="L2"><code class="language-log">although this matches</code></li>
<li class="L3"><code class="language-log">and this mathes too</code></li>

</ol>
<blockquote class="white-blockquote" data-anchor-id="7r4l">
下面章节描述的<code>app.param(callback)</code>在v4.11.0之后被弃用。

</blockquote>
通过只传递一个回调参数给<code>app.param(name, callback)</code>方法，<code>app.param(naem, callback)</code>方法的行为将被完全改变。这个回调参数是关于<code>app.param(name, callback)</code>该具有怎样的行为的一个自定义方法，这个方法必须接受两个参数并且返回一个中间件。  这个回调的第一个参数就是需要捕获的url的参数名，第二个参数可以是任一的JavaScript对象，其可能在实现返回一个中间件时被使用。  这个回调方法返回的中间件决定了当URL中包含这个参数时所采取的行为。  在下面的例子中，<code>app.param(name, callback)</code>参数签名被修改成了<code>app.param(name, accessId)</code>。替换接受一个参数名和回调，<code>app.param()</code>现在接受一个参数名和一个数字。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> var express = require('express');</code></li>
<li class="L1"><code> var app = express();</code></li>
<li class="L2"><code></code></li>
<li class="L3"><code> app.param(function(param, option){</code></li>
<li class="L4"><code> return function(req, res, next, val) {</code></li>
<li class="L5"><code> if (val == option) {</code></li>
<li class="L6"><code> next();</code></li>
<li class="L7"><code> }</code></li>
<li class="L8"><code> else {</code></li>
<li class="L9"><code> res.sendStatus(403);</code></li>
<li class="L0"><code> }</code></li>
<li class="L1"><code> }</code></li>
<li class="L2"><code> });</code></li>
<li class="L3"><code></code></li>
<li class="L4"><code> app.param('id', 1337);</code></li>
<li class="L5"><code></code></li>
<li class="L6"><code> app.get('/user/:id', function(req, res) {</code></li>
<li class="L7"><code> res.send('Ok');</code></li>
<li class="L8"><code> });</code></li>
<li class="L9"><code></code></li>
<li class="L0"><code> app.listen(3000, function() {</code></li>
<li class="L1"><code> console.log('Ready');</code></li>
<li class="L2"><code> });</code></li>

</ol>
在这个例子中，<code>app.param(name, callback)</code>参数签名保持和原来一样，但是替换成了一个中间件，定义了一个自定义的数据类型检测方法来检测<code>user id</code>的类型正确性。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.param(function(param, validator) {</code></li>
<li class="L1"><code> return function(req, res, next, val) {</code></li>
<li class="L2"><code> if (validator(val)) {</code></li>
<li class="L3"><code> next();</code></li>
<li class="L4"><code> }</code></li>
<li class="L5"><code> else {</code></li>
<li class="L6"><code> res.sendStatus(403);</code></li>
<li class="L7"><code> }</code></li>
<li class="L8"><code> }</code></li>
<li class="L9"><code> });</code></li>
<li class="L0"><code></code></li>
<li class="L1"><code> app.param('id', function(candidate) {</code></li>
<li class="L2"><code> return !isNaN(parseFloat(candidate)) && isFinite(candidate);</code></li>
<li class="L3"><code> });</code></li>

</ol>
<blockquote class="white-blockquote" data-anchor-id="b54w">
在使用正则表达式来，不要使用<code>.</code>。例如，你不能使用<code>/user-.+/</code>来捕获<code>user-gami</code>，用使用<code>[\\s\\S]</code>或者<code>[\\w\\>W]</code>来代替(正如<code>/user-[\\s\\S]+/</code>)。
<ol class="linenums">
<li class="L0"><code>//captures '1-a_6' but not '543-azser-sder'</code></li>
<li class="L1"><code>router.get('/+-[[\\w]]*', function);</code></li>
<li class="L2"><code></code></li>
<li class="L3"><code>//captures '1-a_6' and '543-az(ser"-sder' but not '5-a s'</code></li>
<li class="L4"><code>router.get('/+-[[\\S]]*', function);</code></li>
<li class="L5"><code></code></li>
<li class="L6"><code>//captures all (equivalent to '.*')</code></li>
<li class="L7"><code>router.get('[[\\s\\S]]*', function);</code></li>

</ol></blockquote>
<div class="md-section-divider"> </div>
<h4 id="apppath" data-anchor-id="7o1c">app.path()</h4>
通过这个方法可以得到<code>app</code>典型的路径，其是一个<code>string</code>。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> var app = express()</code></li>
<li class="L1"><code> , blog = express()</code></li>
<li class="L2"><code> , blogAdmin = express();</code></li>
<li class="L3"><code></code></li>
<li class="L4"><code> app.use('/blog', blog);</code></li>
<li class="L5"><code> app.use('/admin', blogAdmin);</code></li>
<li class="L6"><code></code></li>
<li class="L7"><code> console.log(app.path()); // ''</code></li>
<li class="L8"><code> console.log(blog.path()); // '/blog'</code></li>
<li class="L9"><code> console.log(blogAdmin.path()); // '/blog/admin'</code></li>

</ol>
如果<code>app</code>挂载很复杂下，那么这个方法的行为也会很复杂：一种更好用的方式是使用<code>req.baseUrl</code>来获得这个app的典型路径。
<div class="md-section-divider"> </div>
<h4 id="apppostpath-callback-callback" data-anchor-id="3frf">app.post(path, callback, )</h4>
路由<code>HTTP POST</code>请求到有特殊回调的特殊路径。获取更多的信息，可以查阅routing guide。  你可以提供多个回调函数，它们的行为和中间件一样，除了这些回调可以通过调用<code>next('router')</code>来绕过剩余的路由回调。你可以使用这个机制来为一个路由设置一些前提条件，如果请求没能满足当前路由的处理条件，那么传递控制到随后的路由。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.post('/', function(req, res) {</code></li>
<li class="L1"><code> res.send('POST request to homepage')</code></li>
<li class="L2"><code> });</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="appputpath-callback-callback" data-anchor-id="zr73">app.put(path, callback, )</h4>
路由<code>HTTP PUT</code>请求到有特殊回调的特殊路径。获取更多的信息，可以查阅routing guide。  你可以提供多个回调函数，它们的行为和中间件一样，除了这些回调可以通过调用<code>next('router')</code>来绕过剩余的路由回调。你可以使用这个机制来为一个路由设置一些前提条件，如果请求没能满足当前路由的处理条件，那么传递控制到随后的路由。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.put('/', function(req, res) {</code></li>
<li class="L1"><code> res.send('PUT request to homepage');</code></li>
<li class="L2"><code> });</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="apprenderview-locals-callback" data-anchor-id="pfys">app.render(view, , callback)</h4>
通过<code>callback</code>回调返回一个<code>view</code>渲染之后得到的HTML文本。它可以接受一个可选的参数，可选参数包含了这个<code>view</code>需要用到的本地数据。这个方法类似于<code>res.render()</code>，除了它不能把渲染得到的HTML文本发送给客户端。
<blockquote class="white-blockquote" data-anchor-id="ql2x">
将<code>app.render()</code>当作是可以生成渲染视图字符串的工具方法。在<code>res.render()</code>内部，就是使用的<code>app.render()</code>来渲染视图。
如果使能了视图缓存，那么本地变量缓存就会保留。如果你想在开发的过程中缓存视图，设置它为<code>true</code>。在生产环境中，视图缓存默认是打开的。

</blockquote>
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.render('email', function(err, html) {</code></li>
<li class="L1"><code> // ...</code></li>
<li class="L2"><code> });</code></li>
<li class="L3"><code></code></li>
<li class="L4"><code> app.render('email', {name:'Tobi'}, function(err, html) {</code></li>
<li class="L5"><code> // ...</code></li>
<li class="L6"><code> });</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="approutepath" data-anchor-id="ahkw">app.route(path)</h4>
返回一个单例模式的路由的实例，之后你可以在其上施加各种HTTP动作的中间件。使用<code>app.route()</code>来避免重复路由名字(例如错字错误)--说的意思应该是使用<code>app.router()</code>这个单例方法来避免同一个路径多个路由实例。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>var app = express();</code></li>
<li class="L1"><code></code></li>
<li class="L2"><code>app.route('/events')</code></li>
<li class="L3"><code>.all(function(req, res, next) {</code></li>
<li class="L4"><code>// runs for all HTTP verbs first</code></li>
<li class="L5"><code>// think of it as route specific middleware!</code></li>
<li class="L6"><code>})</code></li>
<li class="L7"><code>.get(function(req, res, next) {</code></li>
<li class="L8"><code>res.json(...);</code></li>
<li class="L9"><code>})</code></li>
<li class="L0"><code>.post(function(req, res, next) {</code></li>
<li class="L1"><code>// maybe add a new event...</code></li>
<li class="L2"><code>})</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="appsetname-value" data-anchor-id="21wj">app.set(name, value)</h4>
给<code>name</code>设置项赋<code>value</code>值，<code>name</code>是app settings table中属性的一项。  对于一个类型是布尔型的属性调用<code>app.set('foo', ture)</code>等价于调用<code>app.enable('foo')</code>。同样的，调用<code>app.set('foo', false)</code>等价于调用<code>app.disable('foo')</code>。  可以使用<code>app.get()</code>来取得设置的值：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.set('title', 'My Site');</code></li>
<li class="L1"><code> app.get('title'); // 'My Site'</code></li>

</ol>
Application Settings  如果<code>name</code>是程序设置之一，它将影响到程序的行为。下边列出了程序中的设置。
<table class="table table-striped-white table-bordered" data-anchor-id="nl9c">
<thead>
<tr><th>属性</th><th>类型</th><th>值</th><th>默认</th></tr>

</thead>
<tbody>
<tr>
<td>case sensitive routing</td>
<td>Boolean</td>
<td>启用区分大小写。</td>
<td>不启用。对<code>/Foo</code>和<code>/foo</code>处理是一样。</td>

</tr>
<tr>
<td>env</td>
<td>String</td>
<td>环境模型。</td>
<td>process.env.NODE_ENV(NODE_ENV环境变量)或者"development"</td>

</tr>
<tr>
<td>etag</td>
<td>Varied</td>
<td>设置<code>ETag</code>响应头。可取的值，可以查阅etag options table。更多关于HTTP ETag header。</td>
<td>weak</td>

</tr>
<tr>
<td>jsonp callback name</td>
<td>String</td>
<td>指定默认JSONP回调的名称。</td>
<td>?callback=</td>

</tr>
<tr>
<td>json replacer</td>
<td>String</td>
<td>JSON替代品回调</td>
<td>null</td>

</tr>
<tr>
<td>json spaces</td>
<td>Number</td>
<td>当设置了这个值后，发送缩进空格美化过的JSON字符串。</td>
<td>Disabled</td>

</tr>
<tr>
<td>query parser</td>
<td>Varied</td>
<td>设置值为<code>false</code>来禁用<code>query parser</code>，或者设置<code>simple</code>,<code>extended</code>，也可以自己实现<code>query string</code>解析函数。<code>simple</code>基于<code>Node</code>原生的<code>query</code>解析，querystring。</td>
<td>"extend"</td>

</tr>
<tr>
<td>strict routing</td>
<td>Boolean</td>
<td>启用严格的路由。</td>
<td>不启用。对<code>/foo</code>和<code>/foo/</code>的路由处理是一样。</td>

</tr>
<tr>
<td>subdomain offset</td>
<td>Number</td>
<td>用来删除访问子域的主机点分部分的个数</td>
<td>2</td>

</tr>
<tr>
<td>trust proxy</td>
<td>Varied</td>
<td>指示<code>app</code>在一个反向代理的后面，使用<code>x-Forwarded-*</code>来确定连接和客户端的IP地址。注意:<code>X-Forwarded-*</code>头部很容易被欺骗，所有检测客户端的IP地址是靠不住的。<code>trust proxy</code>默认不启用。当启用时，Express尝试通过前端代理或者一系列代理来获取已连接的客户端IP地址。<code>req.ips</code>属性包含了已连接客户端IP地址的一个数组。为了启动它，需要设置在下面trust proxy options table中定义的值。<code>trust proxy</code>的设置实现使用了<code>proxy-addr</code>包。如果想获得更多的信息，可以查阅它的文档</td>
<td>Disable</td>

</tr>
<tr>
<td>views</td>
<td>String or Array</td>
<td><code>view</code>所在的目录或者目录数组。如果是一个数组，将按在数组中的顺序来查找<code>view</code>。</td>
<td>process.cwd() + '/views'</td>

</tr>
<tr>
<td>view cache</td>
<td>Boolean</td>
<td>启用视图模板编译缓存。</td>
<td>在生成环境默认开启。</td>

</tr>
<tr>
<td>view engine</td>
<td>String</td>
<td>省略时，默认的引擎被扩展使用。</td>
<td> </td>

</tr>
<tr>
<td>x-powered-by</td>
<td>Boolean</td>
<td>启用<code>X-Powered-By:Express</code>HTTP头部</td>
<td>true</td>

</tr>

</tbody>

</table>
Options for <code>trust proxy</code> settings  查阅Express behind proxies来获取更多信息。
<table class="table table-striped-white table-bordered" data-anchor-id="xv0e">
<thead>
<tr><th>Type</th><th>Value</th></tr>

</thead>
<tbody>
<tr>
<td>Boolean</td>
<td>
如果为<code>true</code>，客户端的IP地址作为<code>X-Forwarded-*</code>头部的最左边的条目。如果为<code>false</code>，可以理解为<code>app</code>直接与英特网直连，客户端的IP地址衍生自<code>req.connection.remoteAddress</code>。<code>false</code>是默认设置。

</td>

</tr>
<tr>
<td>IP addresses</td>
<td>
一个IP地址，子网，或者一组IP地址，和委托子网。下面列出的是一个预先配置的子网名列表。
<ul>
<li>loopback - <code>127.0.0.1/8</code>, <code>::1/128</code></li>
<li>linklocal - <code>169.254.0.0/16</code>, <code>fe80::/10</code></li>
<li>uniquelocal - <code>10.0.0.0/8</code>, <code>172.16.0.0/12</code>, <code>192.168.0.0/16</code>, <code>fc00::/7</code></li>

</ul>
使用下面方法中的任何一种来设置IP地址:
<pre class="language-javascript"><code class="language-javascript">app.set('trust proxy', 'loopback') // specify a single subnet
app.set('trust proxy', 'loopback, 123.123.123.123') // specify a subnet and an address
app.set('trust proxy', 'loopback, linklocal, uniquelocal') // specify multiple subnets as CSV
app.set('trust proxy', ['loopback', 'linklocal', 'uniquelocal']) // specify multiple subnets as an array</code></pre>
当指定IP地址之后, 这个IP地址或子网会被设置了这个IP地址或子网的`app`排除在外, 最靠近程序服务的没有委托的地址将被看做客户端IP地址。
</td>
</tr>
<tr>
<td>Number</td>
<td>
信任从反向代理到app中间小于等于n跳的连接为客户端。
</td>
</tr>
<tr>
<td>Function</td>
<td>
客户自定义委托代理信任机制。如果你使用这个，请确保你自己知道你在干什么。
<pre class="language-javascript"><code class="language-javascript">app.set('trust proxy', function (ip) {
if (ip === '127.0.0.1' || ip === '123.123.123.123') return true; // trusted IPs
else return false;
})</code></pre>
</td>
</tr>
</tbody>
</table>
Options for <code>etag</code> settings  <code>ETag</code>功能的实现使用了etag包。如果你需要获得更多的信息，你可以查阅它的文档。
<table class="table table-striped-white table-bordered" data-anchor-id="iewr">
<thead>
<tr><th>Type</th><th>Value</th></tr>

</thead>
<tbody>
<tr>
<td>Boolean</td>
<td>
设置为<code>true</code>，启用weak ETag。这个是默认设置。设置<code>false</code>，禁用所有的ETag。

</td>

</tr>
<tr>
<td>String</td>
<td>如果是<code>strong</code>，使能strong ETag。如果是<code>weak</code>，启用<code>weak</code> ETag。</td>

</tr>
<tr>
<td>Function</td>
<td>
客户自定义`ETag`方法的实现. 如果你使用这个，请确保你自己知道你在干什么。
<pre class="language-javascript"><code class="language-javascript">app.set('etag', function (body, encoding) {
return generateHash(body, encoding); // consider the function is defined
})</code></pre>
</td>
</tr>
</tbody>
</table>
<div class="md-section-divider"> </div>
<h4 id="appusepath-function-function" data-anchor-id="zkfp">app.use(, function [, function...])</h4>
挂载中间件方法到路径上。如果路径未指定，那么默认为"/"。
<blockquote class="white-blockquote" data-anchor-id="2xmd">
一个路由将匹配任何路径如果这个路径以这个路由设置路径后紧跟着"/"。比如：<code>app.use('/appale', ...)</code>将匹配"/apple"，"/apple/images"，"/apple/images/news"等。
中间件中的<code>req.originalUrl</code>是<code>req.baseUrl</code>和<code>req.path</code>的组合，如下面的例子所示。
<ol class="linenums">
<li class="L0"><code>app.use('/admin', function(req, res, next) {</code></li>
<li class="L1"><code>// GET 'http://www.example.com/admin/new'</code></li>
<li class="L2"><code>console.log(req.originalUrl); // '/admin/new'</code></li>
<li class="L3"><code>console.log(req.baseUrl); // '/admin'</code></li>
<li class="L4"><code>console.log(req.path);// '/new'</code></li>
<li class="L5"><code>});</code></li>
</ol></blockquote>
在一个路径上挂载一个中间件之后，每当请求的路径的前缀部分匹配了这个路由路径，那么这个中间件就会被执行。  由于默认的路径为<code>/</code>，中间件挂载没有指定路径，那么对于每个请求，这个中间件都会被执行。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> // this middleware will be executed for every request to the app.</code></li>
<li class="L1"><code> app.use(function(req, res, next) {</code></li>
<li class="L2"><code> console.log('Time: %d', Date.now());</code></li>
<li class="L3"><code> next();</code></li>
<li class="L4"><code> });</code></li>

</ol>
中间件方法是顺序处理的，所以中间件包含的顺序是很重要的。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> // this middleware will not allow the request togo beyond it</code></li>
<li class="L1"><code> app.use(function(req, res, next) {</code></li>
<li class="L2"><code> res.send('Hello World');</code></li>
<li class="L3"><code> });</code></li>
<li class="L4"><code></code></li>
<li class="L5"><code> // this middleware will never reach this route</code></li>
<li class="L6"><code> app.use('/', function(req, res) {</code></li>
<li class="L7"><code> res.send('Welcome');</code></li>
<li class="L8"><code> });</code></li>

</ol>
路径可以是代表路径的一串字符，一个路径模式，一个匹配路径的正则表达式，或者他们的一组集合。
<blockquote class="white-blockquote" data-anchor-id="pzmt">
下面是路径的简单的例子。

</blockquote>
<table class="table table-striped-white table-bordered" data-anchor-id="75xt">
<thead>
<tr><th>Type</th><th>Example</th></tr>

</thead>
<tbody>
<tr>
<td>Path</td>
<td>
<pre class="language-javascript"><code class="language-javascript">// will match paths starting with /abcd
app.use('/abcd', function (req, res, next) {
next();
})</code></pre>
</td>
</tr>
<tr>
<td>Path Pattern</td>
<td>
<pre class="language-javascript"><code class="language-javascript">// will match paths starting with /abcd and /abd
app.use('/abc?d', function (req, res, next) {
next();
})

// will match paths starting with /abcd, /abbcd, /abbbbbcd and so on
app.use('/ab+cd', function (req, res, next) {
next();
})

// will match paths starting with /abcd, /abxcd, /abFOOcd, /abbArcd and so on
app.use('/ab\*cd', function (req, res, next) {
next();
})

// will match paths starting with /ad and /abcd
app.use('/a(bc)?d', function (req, res, next) {
next();
})</code></pre>
</td>
</tr>
<tr>
<td>Regular Expression</td>
<td>
<pre class="language-javascript"><code class="language-javascript">// will match paths starting with /abc and /xyz
app.use(/\/abc|\/xyz/, function (req, res, next) {
next();
})</code></pre>
</td>
</tr>
<tr>
<td>Array</td>
<td>
<pre class="language-javascript"><code class="language-javascript">// will match paths starting with /abcd, /xyza, /lmn, and /pqr
app.use(['/abcd', '/xyza', /\/lmn|\/pqr/], function (req, res, next) {
next();
})</code></pre>
</td>
</tr>
</tbody>
</table>
方法可以是一个中间件方法，一系列中间件方法，一组中间件方法或者他们的集合。由于<code>router</code>和<code>app</code>实现了中间件接口，你可以像使用其他任一中间件方法那样使用它们。
<table class="table table-striped-white table-bordered" data-anchor-id="h6ar">
<thead>
<tr><th>Usage</th><th>Example</th></tr>
</thead>
<tbody>
<tr>
<td>单个中间件</td>
<td>你可以局部定义和挂载一个中间件。
<pre class="language-javascript"><code class="language-javascript">app.use(function (req, res, next) {
next();
})
</code></pre>
一个<code>router</code>是有效的中间件。
<pre class="language-javascript"><code class="language-javascript">var router = express.Router();
router.get('/', function (req, res, next) {
next();
})
app.use(router);
</code></pre>
一个<code>Express</code>程序是一个有效的中间件。
<pre class="language-javascript"><code class="language-javascript">var subApp = express();
subApp.get('/', function (req, res, next) {
next();
})
app.use(subApp);
</code></pre>
</td>
</tr>
<tr>
<td>一系列中间件</td>
<td>对于一个相同的挂载路径，你可以挂载超过一个的中间件。
<pre class="language-javascript"><code class="language-javascript">var r1 = express.Router();
r1.get('/', function (req, res, next) {
next();
})

var r2 = express.Router();
r2.get('/', function (req, res, next) {
next();
})

app.use(r1, r2);
</code></pre>
</td>
</tr>
<tr>
<td>一组中间件</td>
<td>在逻辑上使用一个数组来组织一组中间件。如果你传递一组中间件作为第一个或者唯一的参数，接着你需要指定挂载的路径。
<pre class="language-javascript"><code class="language-javascript">var r1 = express.Router();
r1.get('/', function (req, res, next) {
next();
})

var r2 = express.Router();
r2.get('/', function (req, res, next) {
next();
})

app.use('/', );
</code></pre>
</td>
</tr>
<tr>
<td>组合</td>
<td>你可以组合下面的所有方法来挂载中间件。
<pre class="language-javascript"><code class="language-javascript">function mw1(req, res, next) { next(); }
function mw2(req, res, next) { next(); }

var r1 = express.Router();
r1.get('/', function (req, res, next) { next(); });

var r2 = express.Router();
r2.get('/', function (req, res, next) { next(); });

var subApp = express();
subApp.get('/', function (req, res, next) { next(); });

app.use(mw1, , subApp);
</code></pre>
</td>
</tr>
</tbody>
</table>
下面是一些例子，在<code>Express</code>程序中使用<code>express.static</code>中间件。  为程序托管位于程序目录下的<code>public</code>目录下的静态资源：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>// GET /style.css etc</code></li>
<li class="L1"><code>app.use(express.static(__dirname + '/public'));</code></li>

</ol>
在<code>/static</code>路径下挂载中间件来提供静态资源托管服务，只当请求是以<code>/static</code>为前缀的时候。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>// GET /static/style.css etc.</code></li>
<li class="L1"><code>app.use('/static', express.static(express.__dirname + '/public'));</code></li>

</ol>
通过在设置静态资源中间件之后加载日志中间件来关闭静态资源请求的日志。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.use(express.static(__dirname + '/public'));</code></li>
<li class="L1"><code> app.use(logger());</code></li>

</ol>
托管静态资源从不同的路径，但<code>./public</code>路径比其他更容易被匹配：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.use(express.static(__dirname + '/public'));</code></li>
<li class="L1"><code>app.use(express.static(__dirname + '/files'));</code></li>
<li class="L2"><code>app.use(express.static(__dirname + '/uploads'));</code></li>

</ol>
<div class="md-section-divider"> </div>
<h2 id="request" data-anchor-id="a03r">Request</h2>
<code>req</code>对象代表了一个HTTP请求，其具有一些属性来保存请求中的一些数据，比如<code>query string</code>，<code>parameters</code>，<code>body</code>，<code>HTTP headers</code>等等。在本文档中，按照惯例，这个对象总是简称为<code>req</code>(http响应简称为<code>res</code>)，但是它们实际的名字由这个回调方法在那里使用时的参数决定。  如下例子:
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.get('/user/:id', function(req, res) {</code></li>
<li class="L1"><code> res.send('user' + req.params.id);</code></li>
<li class="L2"><code> });</code></li>

</ol>
其实你也可以这样写：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> app.get('/user/:id', function(request, response) {</code></li>
<li class="L1"><code> response.send('user' + request.params.id);</code></li>
<li class="L2"><code> });</code></li>

</ol>
<div class="md-section-divider"> </div>
<h3 id="properties-1" data-anchor-id="8eb9">Properties</h3>
在<code>Express 4</code>中，<code>req.files</code>默认在<code>req</code>对象中不再是可用的。为了通过<code>req.files</code>对象来获得上传的文件，你可以使用一个<code>multipart-handling</code>(多种处理的工具集)中间件，比如<code>busboy</code>，<code>multer</code>，<code>formidable</code>，<code>multipraty</code>，<code>connect-multiparty</code>或者<code>pez</code>。
<div class="md-section-divider"> </div>
<h4 id="reqapp" data-anchor-id="v4bi">req.app</h4>
这个属性持有<code>express</code>程序实例的一个引用，其可以作为中间件使用。  如果你按照这个模式，你创建一个模块导出一个中间件，这个中间件只在你的主文件中<code>require()</code>它，那么这个中间件可以通过<code>req.app</code>来获取express的实例。  例如:
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> // index.js</code></li>
<li class="L1"><code> app.get("/viewdirectory", require('./mymiddleware.js'));</code></li>

</ol>
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>// mymiddleware.js</code></li>
<li class="L1"><code>module.exports = function(req, res) {</code></li>
<li class="L2"><code> res.send('The views directory is ' + req.app.get('views'));</code></li>
<li class="L3"><code>};</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="reqbaseurl" data-anchor-id="h6mb">req.baseUrl</h4>
一个路由实例挂载的Url路径。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> var greet = express.Router();</code></li>
<li class="L1"><code> greet.get('/jp', function(req, res) {</code></li>
<li class="L2"><code> console.log(req.baseUrl); // greet</code></li>
<li class="L3"><code> res.send('Konichiwa!');</code></li>
<li class="L4"><code> });</code></li>
<li class="L5"><code> app.use('/greet', greet);</code></li>

</ol>
即使你使用的路径模式或者一系列路径模式来加载路由，<code>baseUrl</code>属性返回匹配的字符串，而不是路由模式。下面的例子，<code>greet</code>路由被加载在两个路径模式上。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.use(['/gre+t', 'hel{2}o'], greet); // load the on router on '/gre+t' and '/hel{2}o'</code></li>

</ol>
当一个请求路径是<code>/greet/jp</code>，<code>baseUrl</code>是<code>/greet</code>，当一个请求路径是<code>/hello/jp</code>，<code>req.baseUrl</code>是<code>/hello</code>。  <code>req.baseUrl</code>和<code>app</code>对象的mountpath属性相似，除了<code>app.mountpath</code>返回的是路径匹配模式。
<div class="md-section-divider"> </div>
<h4 id="reqbody" data-anchor-id="ht1g">req.body</h4>
在请求的body中保存的是提交的一对对键值数据。默认情况下，它是<code>undefined</code>，当你使用比如<code>body-parser</code>和<code>multer</code>这类解析<code>body</code>数据的中间件时，它是填充的。  下面的例子，给你展示了怎么使用<code>body-parser</code>中间件来填充<code>req.body</code>。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> var app = require('express');</code></li>
<li class="L1"><code> var bodyParser = require('body-parser');</code></li>
<li class="L2"><code> var multer = require('multer')；// v1.0.5</code></li>
<li class="L3"><code> var upload = multer(); // for parsing multipart/form-data</code></li>
<li class="L4"><code> app.use(bodyParser.json()); // for parsing application/json</code></li>
<li class="L5"><code> app.use(bodyParser.urlencoded({extended:true})); // for parsing application/x-www-form-urlencoded</code></li>
<li class="L6"><code></code></li>
<li class="L7"><code> app.post('/profile', upload.array(), function(req, res, next) {</code></li>
<li class="L8"><code> console.log(req.body);</code></li>
<li class="L9"><code> res.json(req.body);</code></li>
<li class="L0"><code> });</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="reqcookies" data-anchor-id="b73l">req.cookies</h4>
当使用<code>cookie-parser</code>中间件的时候，这个属性是一个对象，其包含了请求发送过来的<code>cookies</code>。如果请求没有带<code>cookies</code>，那么其值为<code>{}</code>。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> // Cookie: name=tj</code></li>
<li class="L1"><code> req.cookies.name</code></li>
<li class="L2"><code> // => "tj"</code></li>

</ol>
获取更多信息，问题，或者关注，可以查阅cookie-parser。
<div class="md-section-divider"> </div>
<h4 id="reqfresh" data-anchor-id="6erz">req.fresh</h4>
指示这个请求是否是新鲜的。其和<code>req.stale</code>是相反的。  当<code>cache-control</code>请求头没有<code>no-cache</code>指示和下面中的任一一个条件为<code>true</code>，那么其就为<code>true</code>：
<ul>
<li data-anchor-id="7dwr"><code>if-modified-since</code>请求头被指定，和<code>last-modified</code>请求头等于或者早于<code>modified</code>响应头。</li>
<li data-anchor-id="ftrm"><code>if-none-match</code>请求头是<code>*</code>。</li>
<li data-anchor-id="nyqv"><code>if-none-match</code>请求头在被解析进它的指令之后，和<code>etag</code>响应头的值不相等</li>

</ul>
<blockquote class="white-blockquote" data-anchor-id="kguc">
ps:If-None-Match作用: If-None-Match和ETag一起工作，工作原理是在HTTP Response中添加ETag信息。当用户再次请求该资源时，将在HTTP Request 中加入If-None-Match信息(ETag的值)。如果服务器验证资源的ETag没有改变（该资源没有更新），将返回一个304状态告诉客户端使用本地缓存文件。否则将返回200状态和新的资源和Etag. 使用这样的机制将提高网站的性能

</blockquote>
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> req.fresh</code></li>
<li class="L1"><code> // => true</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="reqhostname" data-anchor-id="1fpw">req.hostname</h4>
包含了源自<code>Host</code>HTTP头部的<code>hostname</code>。  当<code>trust proxy</code>设置项被设置为启用值，<code>X-Forwarded-Host</code>头部被使用来代替<code>Host</code>。这个头部可以被客户端或者代理设置。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>// Host: "example.com"</code></li>
<li class="L1"><code>req.hostname</code></li>
<li class="L2"><code>// => "example.com"</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="reqips" data-anchor-id="u04c">req.ips</h4>
当<code>trust proxy</code>设置项被设置为启用值，这个属性包含了一组在<code>X-Forwarded-For</code>请求头中指定的IP地址。不然，其就包含一个空的数组。这个头部可以被客户端或者代理设置。  例如，如果<code>X-Forwarded-For</code>是<code>client</code>，<code>proxy1</code>，<code>proxy2</code>，<code>req.ips</code>就是<code>["clinet", "proxy1", "proxy2"]</code>，这里<code>proxy2</code>就是最远的下游。
<div class="md-section-divider"> </div>
<h4 id="reqoriginalurl" data-anchor-id="zjcv">req.originalUrl</h4>
<blockquote class="white-blockquote" data-anchor-id="k1j8">
<code>req.url</code>不是一个原生的<code>Express</code>属性，它继承自Node's http module。

</blockquote>
这个属性很像<code>req.url</code>；然而，其保留了原版的请求链接，允许你自由地重定向<code>req.url</code>到内部路由。比如，<code>app.use()</code>的<code>mounting</code>特点可以重定向<code>req.url</code>跳转到挂载点。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>// GET /search?q=something</code></li>
<li class="L1"><code>req.originalUrl</code></li>
<li class="L2"><code>// => "/search?q=something"</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="reqparams" data-anchor-id="k92i">req.params</h4>
一个对象，其包含了一系列的属性，这些属性和在路由中命名的参数名是一一对应的。例如，如果你有<code>/user/:name</code>路由，<code>name</code>属性可作为<code>req.params.name</code>。这个对象默认值为<code>{}</code>。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>// GET /user/tj</code></li>
<li class="L1"><code>req.params.name</code></li>
<li class="L2"><code>// => "tj"</code></li>

</ol>
当你使用正则表达式来定义路由规则，捕获组的组合一般使用<code>req.params</code>，这里的<code>n</code>是第几个捕获租。这个规则被施加在无名通配符匹配，比如<code>/file/*</code>的路由：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>// GET /file/javascripts/jquery.js</code></li>
<li class="L1"><code>req.params[0]</code></li>
<li class="L2"><code>// => "javascripts/jquery.js"</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="reqpath" data-anchor-id="wkvj">req.path</h4>
包含请求URL的部分路径。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>// example.com/users?sort=desc</code></li>
<li class="L1"><code>req.path</code></li>
<li class="L2"><code>// => "/users"</code></li>

</ol>
<blockquote class="white-blockquote" data-anchor-id="ak4s">
当在一个中间件中被调用，挂载点不包含在<code>req.path</code>中。你可以查阅app.use()获得跟多的信息。

</blockquote>
<div class="md-section-divider"> </div>
<h4 id="reqprotocol" data-anchor-id="fhjt">req.protocol</h4>
请求的协议，一般为<code>http</code>，当启用TLS加密，则为<code>https</code>。  当<code>trust proxy</code>设置一个启用的参数，如果存在<code>X-Forwarded-Proto</code>头部的话，其将被信赖和使用。这个头部可以被客户端或者代理设置。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>req.ptotocol</code></li>
<li class="L1"><code>// => "http"</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="reqquery" data-anchor-id="tgyu">req.query</h4>
一个对象，为每一个路由中的<code>query string</code>参数都分配一个属性。如果没有<code>query string</code>，它就是一个空对象，<code>{}</code>。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>// GET /search?q=tobi+ferret</code></li>
<li class="L1"><code>req.query.q</code></li>
<li class="L2"><code>// => "tobi ferret"</code></li>
<li class="L3"><code></code></li>
<li class="L4"><code>// GET /shoes?order=desc&shoe=blue&shoe=converse</code></li>
<li class="L5"><code>req.query.order</code></li>
<li class="L6"><code>// => "desc"</code></li>
<li class="L7"><code></code></li>
<li class="L8"><code>req.query.shoe.color</code></li>
<li class="L9"><code>// => "blue"</code></li>
<li class="L0"><code></code></li>
<li class="L1"><code>req.query.shoe.type</code></li>
<li class="L2"><code>// => "converse"</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="reqroute" data-anchor-id="5uef">req.route</h4>
当前匹配的路由，其为一串字符。比如：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.get('/user/:id?', function userIdHandler(req, res) {</code></li>
<li class="L1"><code> console.log(req.route);</code></li>
<li class="L2"><code> res.send('GET')</code></li>
<li class="L3"><code>})</code></li>

</ol>
前面片段的输出为:
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>{ path:"/user/:id?"</code></li>
<li class="L1"><code> stack:</code></li>
<li class="L2"><code> [</code></li>
<li class="L3"><code> { handle:[Function:userIdHandler],</code></li>
<li class="L4"><code> name:"userIdHandler",</code></li>
<li class="L5"><code> params:undefined,</code></li>
<li class="L6"><code> path:undefined,</code></li>
<li class="L7"><code> keys:[],</code></li>
<li class="L8"><code> regexp:/^\/?$/i,</code></li>
<li class="L9"><code> method:'get'</code></li>
<li class="L0"><code> }</code></li>
<li class="L1"><code> ]</code></li>
<li class="L2"><code> methods:{get:true}</code></li>
<li class="L3"><code>}</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="reqsecure" data-anchor-id="pxp8">req.secure</h4>
一个布尔值，如果建立的是TLS的连接，那么就为<code>true</code>。等价与：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> 'https' == req.protocol;</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="reqsignedcookies" data-anchor-id="tihn">req.signedCookies</h4>
当使用<code>cookie-parser</code>中间件的时候，这个属性包含的是请求发过来的签名<code>cookies</code>，这个属性取得的是不含签名，可以直接使用的值。签名的<code>cookies</code>保存在不同的对象中来体现开发者的意图；不然，一个恶意攻击可以被施加在<code>req.cookie</code>值上(它是很容易被欺骗的)。记住，签名一个<code>cookie</code>不是把它藏起来或者加密；而是简单的防止篡改(因为签名使用的加密是私人的)。如果没有发送签名的<code>cookie</code>，那么这个属性默认为<code>{}</code>。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>// Cookie： user=tobi.CP7AWaXDfAKIRfH49dQzKJx7sKzzSoPq7/AcBBRVwlI3</code></li>
<li class="L1"><code>req.signedCookies.user</code></li>
<li class="L2"><code>// => "tobi"</code></li>

</ol>
为了获取更多的信息，问题或者关注，可以参阅cookie-parser。
<div class="md-section-divider"> </div>
<h4 id="reqstale" data-anchor-id="0qix">req.stale</h4>
指示这个请求是否是<code>stale</code>(陈旧的)，它与<code>req.fresh</code>是相反的。更多信息，可以查看req.fresh。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>req.stale</code></li>
<li class="L1"><code>// => true</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="reqsubdomains" data-anchor-id="rjf1">req.subdomains</h4>
请求中域名的子域名数组。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>// Host: "tobi.ferrets.example.com"</code></li>
<li class="L1"><code>req.subdomains</code></li>
<li class="L2"><code>// => ["ferrets", "tobi"]</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="reqxhr" data-anchor-id="p1qx">req.xhr</h4>
一个布尔值，如果<code>X-Requested-With</code>的值为<code>XMLHttpRequest</code>，那么其为<code>true</code>，其指示这个请求是被一个客服端库发送，比如<code>jQuery</code>。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>req.xhr</code></li>
<li class="L1"><code>// => true</code></li>

</ol>
<div class="md-section-divider"> </div>
<h3 id="methods-2" data-anchor-id="ymti">Methods</h3>
<div class="md-section-divider"> </div>
<h4 id="reqacceptstypes" data-anchor-id="jmqf">req.accepts(types)</h4>
检查这个指定的内容类型是否被接受，基于请求的<code>Accept</code> HTTP头部。这个方法返回最佳匹配，如果没有一个匹配，那么其返回<code>undefined</code>(在这个case下，服务器端应该返回406和"Not Acceptable")。  <code>type</code>值可以是一个单的<code>MIME type</code>字符串(比如<code>application/json</code>)，一个扩展名比如<code>json</code>，一个逗号分隔的列表，或者一个数组。对于一个列表或者数组，这个方法返回最佳项(如果有的话)。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>// Accept: text/html</code></li>
<li class="L1"><code>req.accepts('html');</code></li>
<li class="L2"><code>// => "html"</code></li>
<li class="L3"><code></code></li>
<li class="L4"><code>// Accept: text/*, application/json</code></li>
<li class="L5"><code>req.accepts('html');</code></li>
<li class="L6"><code>// => "html"</code></li>
<li class="L7"><code></code></li>
<li class="L8"><code>req.accepts('text/html');</code></li>
<li class="L9"><code>// => "text/html"</code></li>
<li class="L0"><code></code></li>
<li class="L1"><code>req.accepts(['json', 'text']);</code></li>
<li class="L2"><code>// => "json"</code></li>
<li class="L3"><code></code></li>
<li class="L4"><code>req.accepts('application/json');</code></li>
<li class="L5"><code>// => "application/json"</code></li>
<li class="L6"><code></code></li>
<li class="L7"><code>// Accept: text/*, application/json</code></li>
<li class="L8"><code>req.accepts('image/png');</code></li>
<li class="L9"><code>req.accepts('png');</code></li>
<li class="L0"><code>// => undefined</code></li>
<li class="L1"><code></code></li>
<li class="L2"><code>// Accept: text/*;q=.5, application/json</code></li>
<li class="L3"><code>req.accepts(['html', 'json']);</code></li>
<li class="L4"><code>// => "json"</code></li>

</ol>
获取更多信息，或者如果你有问题或关注，可以参阅accepts。
<div class="md-section-divider"> </div>
<h4 id="reqacceptscharsetscharset" data-anchor-id="zzxx">req.acceptsCharsets(charset[, ...])</h4>
返回指定的字符集集合中第一个的配置的字符集，基于请求的<code>Accept-Charset</code>HTTP头。如果指定的字符集没有匹配的，那么就返回false。  获取更多信息，或者如果你有问题或关注，可以参阅accepts。
<div class="md-section-divider"> </div>
<h4 id="reqacceptsencodingsencoding" data-anchor-id="xipd">req.acceptsEncodings(encoding[, ...])</h4>
返回指定的编码集合中第一个的配置的编码，基于请求的<code>Accept-Encoding</code>HTTP头。如果指定的编码集没有匹配的，那么就返回false。  获取更多信息，或者如果你有问题或关注，可以参阅accepts。
<div class="md-section-divider"> </div>
<h4 id="reqacceptslanguageslang" data-anchor-id="dqvl">req.acceptsLanguages(lang [, ...])</h4>
返回指定的语言集合中第一个的配置的语言，基于请求的<code>Accept-Language</code>HTTP头。如果指定的语言集没有匹配的，那么就返回false。  获取更多信息，或者如果你有问题或关注，可以参阅accepts。
<div class="md-section-divider"> </div>
<h4 id="reqgetfield" data-anchor-id="2ggo">req.get(field)</h4>
返回指定的请求HTTP头部的域内容(不区分大小写)。<code>Referrer</code>和<code>Referer</code>的域内容可互换。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>req.get('Content-type');</code></li>
<li class="L1"><code>// => "text/plain"</code></li>
<li class="L2"><code></code></li>
<li class="L3"><code>req.get('content-type');</code></li>
<li class="L4"><code>// => "text/plain"</code></li>
<li class="L5"><code></code></li>
<li class="L6"><code>req.get('Something')</code></li>
<li class="L7"><code>// => undefined</code></li>

</ol>
其是<code>req.header(field)</code>的别名。
<div class="md-section-divider"> </div>
<h4 id="reqistype" data-anchor-id="arlv">req.is(type)</h4>
如果进来的请求的<code>Content-type</code>头部域匹配参数<code>type</code>给定的<code>MIME type</code>，那么其返回<code>true</code>。否则返回<code>false</code>。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>// With Content-Type: text/html; charset=utf-8</code></li>
<li class="L1"><code>req.is('html');</code></li>
<li class="L2"><code>req.is('text/html');</code></li>
<li class="L3"><code>req.is('text/*');</code></li>
<li class="L4"><code>// => true</code></li>
<li class="L5"><code></code></li>
<li class="L6"><code>// When Content-Type is application/json</code></li>
<li class="L7"><code>req.is('json');</code></li>
<li class="L8"><code>req.is('application/json');</code></li>
<li class="L9"><code>req.is('application/*');</code></li>
<li class="L0"><code>// => true</code></li>
<li class="L1"><code></code></li>
<li class="L2"><code>req.is('html');</code></li>
<li class="L3"><code>// => false</code></li>

</ol>
获取更多信息，或者如果你有问题或关注，可以参阅type-is。
<div class="md-section-divider"> </div>
<h4 id="reqparamnaem-defaultvalue" data-anchor-id="9x0e">req.param(naem, [, defaultValue])</h4>
<blockquote class="white-blockquote" data-anchor-id="l37r">
过时的。可以在适合的情况下，使用<code>req.params</code>，<code>req.body</code>或者<code>req.query</code>。

</blockquote>
返回当前参数<code>name</code>的值。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>// ?name=tobi</code></li>
<li class="L1"><code>req.param('name')</code></li>
<li class="L2"><code>// => "tobi"</code></li>
<li class="L3"><code></code></li>
<li class="L4"><code>// POST name=tobi</code></li>
<li class="L5"><code>req.param('name')</code></li>
<li class="L6"><code>// => "tobi"</code></li>
<li class="L7"><code>// /user/tobi for /user/:name</code></li>
<li class="L8"><code>req.param('name')</code></li>
<li class="L9"><code>// => "tobi"</code></li>

</ol>
按下面给出的顺序查找：
<ul>
<li data-anchor-id="ejxr">req.params</li>
<li data-anchor-id="o3fc">req.body</li>
<li data-anchor-id="gh0v">req.query</li>

</ul>
可选的，你可以指定一个<code>defaultValue</code>来设置一个默认值，如果这个参数在任何一个请求的对象中都不能找到。
<blockquote class="white-blockquote" data-anchor-id="gx8j">
直接通过<code>req.params</code>，<code>req.body</code>，<code>req.query</code>取得应该更加的清晰-除非你确定每一个对象的输入。  <code>Body-parser</code>中间件必须加载，如果你使用<code>req.param()</code>。详细请看req.body。

</blockquote>
<div class="md-section-divider"> </div>
<h2 id="response" data-anchor-id="07tl">Response</h2>
<code>res</code>对象代表了当一个HTTP请求到来时，<code>Express</code>程序返回的HTTP响应。在本文档中，按照惯例，这个对象总是简称为<code>res</code>(http请求简称为<code>req</code>)，但是它们实际的名字由这个回调方法在那里使用时的参数决定。  例如：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.get('/user/:id', function(req, res) {</code></li>
<li class="L1"><code> res.send('user' + req.params.id);</code></li>
<li class="L2"><code>});</code></li>

</ol>
这样写也是一样的：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.get('/user/:id', function(request, response) {</code></li>
<li class="L1"><code> response.send('user' + request.params.id);</code></li>
<li class="L2"><code>});</code></li>

</ol>
<div class="md-section-divider"> </div>
<h3 id="properties-2" data-anchor-id="c4gw">Properties</h3>
<div class="md-section-divider"> </div>
<h4 id="resapp" data-anchor-id="f1uv">res.app</h4>
这个属性持有<code>express</code>程序实例的一个引用，其可以在中间件中使用。  <code>res.app</code>和请求对象中的<code>req.app</code>属性是相同的。
<div class="md-section-divider"> </div>
<h4 id="resheaderssent" data-anchor-id="8lkv">res.headersSent</h4>
布尔类型的属性，指示这个响应是否已经发送HTTP头部。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.get('/', function(req, res) {</code></li>
<li class="L1"><code> console.log(res.headersSent); // false</code></li>
<li class="L2"><code> res.send('OK'); // send之后就发送了头部</code></li>
<li class="L3"><code> console.log(res.headersSent); // true</code></li>
<li class="L4"><code>});</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="reslocals" data-anchor-id="ridq">res.locals</h4>
一个对象，其包含了本次请求的响应中的变量和因此它的变量只提供给本次请求响应的周期内视图渲染里使用(如果有视图的话)。  其他方面，其和<code>app.locals</code>是一样的。  这个参数在导出请求级别的信息是很有效的，这些信息比如请求路径，已认证的用户，用户设置等等。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.use(function(req, res, next) {</code></li>
<li class="L1"><code> res.locals.user = req.user;</code></li>
<li class="L2"><code> res.locals.authenticated = !req.user.anonymous;</code></li>
<li class="L3"><code> next();</code></li>
<li class="L4"><code>});</code></li>

</ol>
<div class="md-section-divider"> </div>
<h3 id="methods-3" data-anchor-id="g3vl">Methods</h3>
<div class="md-section-divider"> </div>
<h4 id="resappendfield-value" data-anchor-id="dhme">res.append(field [, value])</h4>
<blockquote class="white-blockquote" data-anchor-id="rqbn">
res.append()方法在<code>Expresxs</code>4.11.0以上版本才支持。

</blockquote>
在指定的<code>field</code>的HTTP头部追加特殊的值<code>value</code>。如果这个头部没有被设置，那么将用<code>value</code>新建这个头部。<code>value</code>可以是一个字符串或者数组。  注意：在<code>res.append()</code>之后调用<code>app.set()</code>函数将重置前面设置的值。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.append('Lind', ['<http://localhost>', '<http://localhost:3000>']);</code></li>
<li class="L1"><code>res.append('Set-Cookie', 'foo=bar;Path=/;HttpOnly');</code></li>
<li class="L2"><code>res.append('Warning', '199 Miscellaneous warning');</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="resattachmentfilename" data-anchor-id="j0d8">res.attachment()</h4>
设置HTTP响应的<code>Content-Disposition</code>头内容为"attachment"。如果提供了<code>filename</code>，那么将通过<code>res.type()</code>获得扩展名来设置<code>Content-Type</code>，并且设置<code>Content-Disposition</code>内容为"filename="parameter。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.attachment();</code></li>
<li class="L1"><code>// Content-Disposition: attachment</code></li>
<li class="L2"><code></code></li>
<li class="L3"><code>res.attachment('path/to/logo.png');</code></li>
<li class="L4"><code>// Content-Disposition: attachment; filename="logo.png"</code></li>
<li class="L5"><code>// Content-Type: image/png</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="rescookiename-value-options" data-anchor-id="gjjw">res.cookie(name, value [,options])</h4>
设置<code>name</code>和<code>value</code>的<code>cookie</code>，<code>value</code>参数可以是一串字符或者是转化为json字符串的对象。  options是一个对象，其可以有下列的属性。
<table class="table table-striped-white table-bordered" data-anchor-id="vwln">
<thead>
<tr><th>属性</th><th>类型</th><th>描述</th></tr>

</thead>
<tbody>
<tr>
<td>domain</td>
<td>String</td>
<td>设置cookie的域名。默认是你本app的域名。</td>

</tr>
<tr>
<td>expires</td>
<td>Date</td>
<td>cookie的过期时间，GMT格式。如果没有指定或者设置为0，则产生新的cookie。</td>

</tr>
<tr>
<td>httpOnly</td>
<td>Boolean</td>
<td>这个cookie只能被web服务器获取的标示。</td>

</tr>
<tr>
<td>maxAge</td>
<td>String</td>
<td>是设置过去时间的方便选项，其为过期时间到当前时间的毫秒值。</td>

</tr>
<tr>
<td>path</td>
<td>String</td>
<td>cookie的路径。默认值是<code>/</code>。</td>

</tr>
<tr>
<td>secure</td>
<td>Boolean</td>
<td>标示这个cookie只用被<code>HTTPS</code>协议使用。</td>

</tr>
<tr>
<td>signed</td>
<td>Boolean</td>
<td>指示这个cookie应该是签名的。</td>

</tr>

</tbody>

</table>
<blockquote class="white-blockquote" data-anchor-id="csxb">
res.cookie()所作的都是基于提供的<code>options</code>参数来设置<code>Set-Cookie</code>头部。没有指定任何的<code>options</code>，那么默认值在<code>RFC6265</code>中指定。

</blockquote>
使用实例：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.cookie('name', 'tobi', {'domain':'.example.com', 'path':'/admin', 'secure':true});</code></li>
<li class="L1"><code>res.cookie('remenberme', '1', {'expires':new Date(Date.now() + 90000), 'httpOnly':true});</code></li>

</ol>
<code>maxAge</code>是一个方便设置过期时间的方便的选项，其以当前时间开始的毫秒数来计算。下面的示例和上面的第二条功效一样。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.cookie('rememberme', '1', {'maxAge':90000}, "httpOnly":true);</code></li>

</ol>
你可以设置传递一个对象作为<code>value</code>的参数。然后其将被序列化为Json字符串，被<code>bodyParser()</code>中间件解析。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.cookie('cart', {'items':[1, 2, 3]});</code></li>
<li class="L1"><code>res.cookie('cart', {'items':[1, 2, 3]}, {'maxAge':90000});</code></li>

</ol>
当我们使用<code>cookie-parser</code>中间件的时候，这个方法也支持签名的cookie。简单地，在设置<code>options</code>时包含<code>signed</code>选项为<code>true</code>。然后<code>res.cookie()</code>将使用传递给<code>cookieParser(secret)</code>的密钥来签名这个值。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.cookie('name', 'tobi', {'signed':true});</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="resclearcookiename-options" data-anchor-id="nd1z">res.clearCookie(name [,options])</h4>
根据指定的<code>name</code>清除对应的cookie。更多关于<code>options</code>对象可以查阅<code>res.cookie()</code>。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.cookie('name', 'tobi', {'path':'/admin'});</code></li>
<li class="L1"><code>res.clearCookie('name', {'path':'admin'});</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="resdownloadpath-filename-fn" data-anchor-id="x3mo">res.download(path, [,filename], [,fn])</h4>
传输<code>path</code>指定文件作为一个附件。通常，浏览器提示用户下载。默认情况下，<code>Content-Disposition</code>头部"filename="的参数为<code>path</code>(通常会出现在浏览器的对话框中)。通过指定<code>filename</code>参数来覆盖默认值。  当一个错误发生时或者传输完成，这个方法将调用<code>fn</code>指定的回调方法。这个方法使用<code>res.sendFile()</code>来传输文件。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.download('/report-12345.pdf');</code></li>
<li class="L1"><code></code></li>
<li class="L2"><code>res.download('/report-12345.pdf', 'report.pdf');</code></li>
<li class="L3"><code></code></li>
<li class="L4"><code>res.download('report-12345.pdf', 'report.pdf', function(err) {</code></li>
<li class="L5"><code>// Handle error, but keep in mind the response may be partially-sent</code></li>
<li class="L6"><code>// so check res.headersSent</code></li>
<li class="L7"><code>if (err) {</code></li>
<li class="L8"><code>} else {</code></li>
<li class="L9"><code>// decrement a download credit, etc.</code></li>
<li class="L0"><code>}</code></li>
<li class="L1"><code>});</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="resenddata-encoding" data-anchor-id="t7st">res.end( [, encoding])</h4>
结束本响应的过程。这个方法实际上来自<code>Node</code>核心模块，具体的是response.end() method of http.ServerResponse。  用来快速结束请求，没有任何的数据。如果你需要发送数据，可以使用res.send()和res.json()这类的方法。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.end();</code></li>
<li class="L1"><code>res.status(404).end();</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="resformatobject" data-anchor-id="mmbg">res.format(object)</h4>
进行内容协商，根据请求的对象中<code>Accept</code>HTTP头部指定的接受内容。它使用req.accepts()来选择一个句柄来为请求服务，这些句柄按质量值进行排序。如果这个头部没有指定，那么第一个方法默认被调用。当不匹配时，服务器将返回<code>406</code>"Not Acceptable"，或者调用<code>default</code>回调。  <code>Content-Type</code>请求头被设置，当一个回调方法被选择。然而你可以改变他，在这个方法中使用这些方法，比如<code>res.set()</code>或者<code>res.type()</code>。  下面的例子，将回复<code>{"message":"hey"}</code>，当请求的对象中<code>Accept</code>头部设置成"application/json"或者"*/json"(不过如果是<code>*/*</code>，然后这个回复就是"hey")。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.format({</code></li>
<li class="L1"><code> 'text/plain':function() {</code></li>
<li class="L2"><code> res.send('hey');</code></li>
<li class="L3"><code> },</code></li>
<li class="L4"><code> 'text/html':function() {</code></li>
<li class="L5"><code> res.send('hey');</code></li>
<li class="L6"><code> },</code></li>
<li class="L7"><code> 'application/json':function() {</code></li>
<li class="L8"><code> res.send({message:'hey'});</code></li>
<li class="L9"><code> },</code></li>
<li class="L0"><code> 'default':function() {</code></li>
<li class="L1"><code> res.status(406).send('Not Acceptable');</code></li>
<li class="L2"><code> }</code></li>
<li class="L3"><code>})</code></li>

</ol>
除了规范化的MIME类型之外，你也可以使用拓展名来映射这些类型来避免冗长的实现：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.format({</code></li>
<li class="L1"><code> text:function() {</code></li>
<li class="L2"><code> res.send('hey');</code></li>
<li class="L3"><code> },</code></li>
<li class="L4"><code> html:function() {</code></li>
<li class="L5"><code> res.send('hey');</code></li>
<li class="L6"><code> },</code></li>
<li class="L7"><code> json:function() {</code></li>
<li class="L8"><code> res.send({message:'hey'});</code></li>
<li class="L9"><code> }</code></li>
<li class="L0"><code>})</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="resgetfield" data-anchor-id="fgj3">res.get(field)</h4>
返回<code>field</code>指定的HTTP响应的头部。匹配是区分大小写。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.get('Content-Type');</code></li>
<li class="L1"><code>// => "text/plain"</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="resjsonbody" data-anchor-id="bdwc">res.json()</h4>
发送一个json的响应。这个方法和将一个对象或者一个数组作为参数传递给<code>res.send()</code>方法的效果相同。不过，你可以使用这个方法来转换其他的值到json，例如<code>null</code>，<code>undefined</code>。(虽然这些都是技术上无效的JSON)。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.json(null);</code></li>
<li class="L1"><code>res.json({user:'tobi'});</code></li>
<li class="L2"><code>res.status(500).json({error:'message'});</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="resjsonpbody" data-anchor-id="w616">res.jsonp()</h4>
发送一个json的响应，并且支持JSONP。这个方法和<code>res.json()</code>效果相同，除了其在选项中支持JSONP回调。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.jsonp(null)</code></li>
<li class="L1"><code>// => null</code></li>
<li class="L2"><code></code></li>
<li class="L3"><code>res.jsonp({user:'tobi'})</code></li>
<li class="L4"><code>// => {"user" : "tobi"}</code></li>
<li class="L5"><code></code></li>
<li class="L6"><code>res.status(500).jsonp({error:'message'})</code></li>
<li class="L7"><code> // => {"error" : "message"}</code></li>

</ol>
默认情况下，jsonp的回调方法简单写作<code>callback</code>。可以通过jsonp callback name设置来重写它。  下面是一些例子使用JSONP响应，使用相同的代码:
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>// ?callback=foo</code></li>
<li class="L1"><code>res.jsonp({user:'tobo'})</code></li>
<li class="L2"><code>// => foo({"user":"tobi"})</code></li>
<li class="L3"><code></code></li>
<li class="L4"><code>app.set('jsonp callback name', 'cb')</code></li>
<li class="L5"><code></code></li>
<li class="L6"><code>// ?cb=foo</code></li>
<li class="L7"><code>res.status(500).jsonp({error:'message'})</code></li>
<li class="L8"><code>// => foo({"error":"message"})</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="reslinkslinks" data-anchor-id="uf75">res.links(links)</h4>
连接这些<code>links</code>，<code>links</code>是以传入参数的属性形式提供，连接之后的内容用来填充响应的Link HTTP头部。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.links({</code></li>
<li class="L1"><code> next:'http://api.example.com/users?page=2',</code></li>
<li class="L2"><code> last:'http://api.example.com/user?page=5'</code></li>
<li class="L3"><code>});</code></li>

</ol>
效果：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>Link:<http://api.example.com/users?page=2>;rel="next",</code></li>
<li class="L1"><code><http://api.example.com/users?page=5>;rel="last"</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="reslocationpath" data-anchor-id="jdvh">res.location(path)</h4>
设置响应的<code>Location</code>HTTP头部为指定的<code>path</code>参数。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> res.location('/foo/bar');</code></li>
<li class="L1"><code> res.location('http://example.com');</code></li>
<li class="L2"><code> res.location('back');</code></li>

</ol>
当<code>path</code>参数为<code>back</code>时，其具有特殊的意义，其指定URL为请求对象的<code>Referer</code>头部指定的URL。如果请求中没有指定，那么其即为"/"。
<blockquote class="white-blockquote" data-anchor-id="d1to">
Express传递指定的URL字符串作为回复给浏览器响应中的<code>Location</code>头部的值，不检测和操作，除了<code>back</code>这个参数。浏览器会将用户重定向到<code>location</code>设置的url或者<code>Referer</code>的url（<code>back</code>参数的情况）

</blockquote>
<div class="md-section-divider"> </div>
<h4 id="resredirectstatus-path" data-anchor-id="uwsl">res.redirect( path)</h4>
重定向来源于指定<code>path</code>的URL，以及指定的HTTP status code<code>status</code>。如果你没有指定<code>status</code>，status code默认为"302 Found"。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.redirect('/foo/bar');</code></li>
<li class="L1"><code>res.redirect('http://example.com');</code></li>
<li class="L2"><code>res.redirect(301, 'http://example.com');</code></li>
<li class="L3"><code>res.redirect('../login');</code></li>

</ol>
重定向也可以是完整的URL，来重定向到不同的站点。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.redirect('http://google.com');</code></li>

</ol>
重定向也可以相对于主机的根路径。比如，如果程序的路径为<code>http://example.com/admin/post/new</code>，那么下面将重定向到<code>http://example.com/admim</code>:
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.redirect('/admin');</code></li>

</ol>
重定向也可以相对于当前的URL。比如，来之于<code>http://example.com/blog/admin/</code>(注意结尾的<code>/</code>)，下面将重定向到<code>http://example.com/blog/admin/post/new</code>。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.redirect('post/new');</code></li>

</ol>
如果来至于<code>http://example.com/blog/admin</code>（没有尾部<code>/</code>），重定向<code>post/new</code>，将重定向到<code>http://example.com/blog/post/new</code>。如果你觉得上面很混乱，可以把路径段认为目录(有'/')或者文件，这样是可以的。相对路径的重定向也是可以的。如果你当前的路径为<code>http://example.com/admin/post/new</code>，下面的操作将重定向到<code>http://example.com/admin/post</code>：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.redirect('..');</code></li>

</ol>
<code>back</code>将重定向请求到referer，当没有<code>referer</code>的时候，默认为<code>/</code>。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.redirect('back');</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="resrenderview-locals-callback" data-anchor-id="n5jy">res.render(view [, locals] [, callback])</h4>
渲染一个视图，然后将渲染得到的HTML文档发送给客户端。可选的参数为:
<ul>
<li data-anchor-id="zt92"><code>locals</code>，定义了视图本地参数属性的一个对象。</li>
<li data-anchor-id="j21p"><code>callback</code>，一个回调方法。如果提供了这个参数，<code>render</code>方法将返回错误和渲染之后的模板，并且不自动发送响应。当有错误发生时，可以在这个回调内部，调用<code>next(err)</code>方法。</li>

</ul>
<blockquote class="white-blockquote" data-anchor-id="ppmv">
本地变量缓存使能视图缓存。在开发环境中缓存视图，需要手动设置为true；视图缓存在生产环境中默认开启。

</blockquote>
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code></code></li>
<li class="L1"><code>// send the rendered view to the client</code></li>
<li class="L2"><code>res.render('index');</code></li>
<li class="L3"><code></code></li>
<li class="L4"><code>// if a callback is specified, the render HTML string has to be sent explicitly</code></li>
<li class="L5"><code></code></li>
<li class="L6"><code>res.render('index', function(err, html) {</code></li>
<li class="L7"><code> res.send(html);</code></li>
<li class="L8"><code>});</code></li>
<li class="L9"><code></code></li>
<li class="L0"><code>// pass a local variable tothe view</code></li>
<li class="L1"><code>res.render('user', {name:'Tobi'}, function(err, html) {</code></li>
<li class="L2"><code> // ...</code></li>
<li class="L3"><code>});</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="ressendbody" data-anchor-id="kuva">res.send()</h4>
发送HTTP响应。  <code>body</code>参数可以是一个<code>Buffer</code>对象，一个字符串，一个对象，或者一个数组。比如：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.send(new Buffer('whoop'));</code></li>
<li class="L1"><code>res.send({some:'json'});</code></li>
<li class="L2"><code>res.send('some html');</code></li>
<li class="L3"><code>res.status(404).send('Sorry, we cannot find that!');</code></li>
<li class="L4"><code>res.status(500).send({ error: 'something blew up' });</code></li>

</ol>
对于一般的非流请求，这个方法可以执行许多有用的的任务：比如，它自动给<code>Content-Length</code>HTTP响应头赋值(除非先前定义)，也支持自动的HEAD和HTTP缓存更新。  当参数是一个<code>Buffer</code>对象，这个方法设置<code>Content-Type</code>响应头为<code>application/octet-stream</code>，除非事先提供，如下所示:
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.set('Content-Type', 'text/html');</code></li>
<li class="L1"><code>res.send(new Buffer('some html'));</code></li>

</ol>
当参数是一个字符串，这个方法设置<code>Content-Type</code>响应头为<code>text/html</code>：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.send('some html');</code></li>

</ol>
当参数是一个对象或者数组，Express使用JSON格式来表示：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.send({user:'tobi'});</code></li>
<li class="L1"><code>res.send([1, 2, 3]);</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="ressendfilepath-options-fn" data-anchor-id="9ll7">res.sendFile(path [, options] [, fn])</h4>
<blockquote class="white-blockquote" data-anchor-id="6b6n">
<code>res.sendFile()</code>从<code>Express v4.8.0</code>开始支持。

</blockquote>
传输<code>path</code>指定的文件。根据文件的扩展名设置<code>Content-Type</code>HTTP头部。除非在<code>options</code>中有关于<code>root</code>的设置，<code>path</code>一定是关于文件的绝对路径。  下面的表提供了<code>options</code>参数的细节:
<table class="table table-striped-white table-bordered" data-anchor-id="6jpv">
<thead>
<tr><th>属性</th><th>描述</th><th>默认值</th><th>可用版本</th></tr>

</thead>
<tbody>
<tr>
<td>maxAge</td>
<td>设置<code>Cache-Control</code>的<code>max-age</code>属性，格式为毫秒数，或者是ms format的一串字符串</td>
<td>0</td>
<td> </td>

</tr>
<tr>
<td>root</td>
<td>相对文件名的根目录</td>
<td> </td>
<td> </td>

</tr>
<tr>
<td>lastModified</td>
<td>设置<code>Last-Modified</code>头部为此文件在系统中的最后一次修改时间。设置<code>false</code>来禁用它</td>
<td>Enable</td>
<td>4.9.0+</td>

</tr>
<tr>
<td>headers</td>
<td>一个对象，包含了文件相关的HTTP头部。</td>
<td> </td>
<td> </td>

</tr>
<tr>
<td>dotfiles</td>
<td>是否支持点开头文件名的选项。可选的值"allow","deny","ignore"</td>
<td>"ignore"</td>
<td> </td>

</tr>

</tbody>

</table>
当传输完成或者发生了什么错误，这个方法调用<code>fn</code>回调方法。如果这个回调参数指定了和一个错误发生，回调方法必须明确地通过结束请求-响应循环或者传递控制到下个路由来处理响应过程。  下面是使用了所有参数的使用<code>res.sendFile()</code>的例子：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.get('/file/:name', function(req, res, next) {</code></li>
<li class="L1"><code></code></li>
<li class="L2"><code> var options = {</code></li>
<li class="L3"><code> root:__dirname + '/public',</code></li>
<li class="L4"><code> dotfile:'deny',</code></li>
<li class="L5"><code> headers:{</code></li>
<li class="L6"><code> 'x-timestamp':Date.now(),</code></li>
<li class="L7"><code> 'x-sent':true</code></li>
<li class="L8"><code> }</code></li>
<li class="L9"><code> };</code></li>
<li class="L0"><code></code></li>
<li class="L1"><code> var fileName = req.params.name;</code></li>
<li class="L2"><code> res.sendFile(fileName, options, function(err) {</code></li>
<li class="L3"><code> if (err) {</code></li>
<li class="L4"><code> console.log(err);</code></li>
<li class="L5"><code> res.status(err.status).end();</code></li>
<li class="L6"><code> }</code></li>
<li class="L7"><code> else {</code></li>
<li class="L8"><code> console.log('sent', fileName);</code></li>
<li class="L9"><code> }</code></li>
<li class="L0"><code> });</code></li>
<li class="L1"><code></code></li>
<li class="L2"><code></code></li>
<li class="L3"><code></code></li>
<li class="L4"><code>});</code></li>

</ol>
<code>res.sendFile</code>提供了文件服务的细粒度支持，如下例子说明：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.get('/user/:uid/photos/:file', function(req, res) {</code></li>
<li class="L1"><code> var uid = req.params.uid</code></li>
<li class="L2"><code> , file = req.params.file;</code></li>
<li class="L3"><code></code></li>
<li class="L4"><code></code></li>
<li class="L5"><code> req.user.mayViewFilesFrom(uid, function(yes) {</code></li>
<li class="L6"><code> if (yes) {</code></li>
<li class="L7"><code> res.sendFile('/upload/' + uid + '/' + file);</code></li>
<li class="L8"><code> }</code></li>
<li class="L9"><code> else {</code></li>
<li class="L0"><code> res.status(403).send('Sorry! you cant see that.');</code></li>
<li class="L1"><code> }</code></li>
<li class="L2"><code> });</code></li>
<li class="L3"><code></code></li>
<li class="L4"><code>})</code></li>

</ol>
获取更多信息，或者你有问题或者关注，可以查阅send。
<div class="md-section-divider"> </div>
<h4 id="ressendstatusstatuscode" data-anchor-id="i3o7">res.sendStatus(statusCode)</h4>
设置响应对象的<code>HTTP status code</code>为<code>statusCode</code>并且发送<code>statusCode</code>的相应的字符串形式作为响应的Body。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> res.sendStatus(200); // equivalent to res.status(200).send('OK');</code></li>
<li class="L1"><code> res.sendStatus(403); // equivalent to res.status(403).send('Forbidden');</code></li>
<li class="L2"><code> res.sendStatus(404); // equivalent to res.status(404).send('Not Found');</code></li>
<li class="L3"><code> res.sendStatus(500); // equivalent to res.status(500).send('Internal Server Error')</code></li>

</ol>
如果一个不支持的状态被指定，这个HTTP status依然被设置为<code>statusCode</code>并且用这个code的字符串作为Body。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.sendStatus(2000); // equivalent to res.status(2000).send('2000');</code></li>

</ol>
More about HTTP Status Codes
<div class="md-section-divider"> </div>
<h4 id="ressetfield-value" data-anchor-id="mztp">res.set(field [, value])</h4>
设置响应对象的HTTP头部<code>field</code>为<code>value</code>。为了一次设置多个值，那么可以传递一个对象为参数。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.set('Content-Type', 'text/plain');</code></li>
<li class="L1"><code></code></li>
<li class="L2"><code>res.set({</code></li>
<li class="L3"><code> 'Content-Type':'text/plain',</code></li>
<li class="L4"><code> 'Content-Length':'123',</code></li>
<li class="L5"><code> 'ETag':'123456'</code></li>
<li class="L6"><code>})</code></li>

</ol>
其和<code>res.header(field [,value])</code>效果一致。
<div class="md-section-divider"> </div>
<h4 id="resstatuscode" data-anchor-id="n9ct">res.status(code)</h4>
使用这个方法来设置响应对象的HTTP status。其是Node中response.statusCode的一个连贯性的别名。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.status(403).end();</code></li>
<li class="L1"><code>res.status(400).send('Bad Request');</code></li>
<li class="L2"><code>res.status(404).sendFile('/absolute/path/to/404.png');</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="restypetype" data-anchor-id="efwr">res.type(type)</h4>
程序将设置<code>Content-Type</code>HTTP头部的MIME type，如果这个设置的<code>type</code>能够被mime.lookup解析成正确的<code>Content-Type</code>。如果<code>type</code>中包含了<code>/</code>字符，那么程序会直接设置<code>Content-Type</code>为<code>type</code>。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.type('.html'); // => 'text/html'</code></li>
<li class="L1"><code>res.type('html'); // => 'text/html'</code></li>
<li class="L2"><code>res.type('json'); // => 'application/json'</code></li>
<li class="L3"><code>res.type('application/json'); // => 'application/json'</code></li>
<li class="L4"><code>res.type('png'); // => image/png:</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="resvaryfield" data-anchor-id="mra4">res.vary(field)</h4>
在没有Vary应答头部时增加Vary应答头部。
<blockquote class="white-blockquote" data-anchor-id="lwvn">
ps：vary的意义在于告诉代理服务器/缓存/CDN，如何判断请求是否一样，vary中的组合就是服务器/缓存/CDN判断的依据，比如Vary中有User-Agent，那么即使相同的请求，如果用户使用IE打开了一个页面，再用Firefox打开这个页面的时候，CDN/代理会认为是不同的页面，如果Vary中没有User-Agent，那么CDN/代理会认为是相同的页面，直接给用户返回缓存的页面，而不会再去web服务器请求相应的页面。通俗的说就相当于<code>field</code>作为了一个缓存的key来判断是否命中缓存

</blockquote>
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>res.vary('User-Agent').render('docs');</code></li>

</ol>
<div class="md-section-divider"> </div>
<h2 id="router" data-anchor-id="6or1">Router</h2>
一个<code>router</code>对象是一个单独的实例关于中间件和路由。你可以认为其是一个"mini-application"（迷你程序），其具有操作中间件和路由方法的能力。每个<code>Express</code>程序有一个内建的app路由。  路由自身表现为一个中间件，所以你可以使用它作为<code>app.use()</code>方法的一个参数或者作为另一个路由的<code>use()</code>的参数。  顶层的<code>express</code>对象有一个<code>Router()</code>方法，你可以使用<code>Router()</code>来创建一个新的<code>router</code>对象。
<div class="md-section-divider"> </div>
<h4 id="routeroptions" data-anchor-id="p64b">Router()</h4>
如下，可以创建一个路由：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>var router = express.Router([options]);</code></li>

</ol>
<code>options</code>参数可以指定路由的行为，其有下列选择：
<table class="table table-striped-white table-bordered" data-anchor-id="xdw6">
<thead>
<tr><th>属性</th><th>描述</th><th>默认值</th><th>可用性</th></tr>

</thead>
<tbody>
<tr>
<td>caseSensitive</td>
<td>是否区分大小写</td>
<td>默认不启用。对待<code>/Foo</code>和<code>/foo</code>一样。</td>
<td> </td>

</tr>
<tr>
<td>mergeParams</td>
<td>保存父路由的<code>res.params</code>。如果父路由参数和子路由参数冲突，子路由参数优先。</td>
<td>false</td>
<td>4.5.0+</td>

</tr>
<tr>
<td>strict</td>
<td>使能严格路由。</td>
<td>默认不启用，<code>/foo</code>和<code>/foo/</code>被路由一样对待处理</td>
<td> </td>

</tr>

</tbody>

</table>
你可以将<code>router</code>当作一个程序，可以在其上添加中间件和HTTP路由方法(例如<code>get</code>，<code>put</code>，<code>post</code>等等)。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>// invoked for any requests passed to this router</code></li>
<li class="L1"><code>router.use(function(req, res, next) {</code></li>
<li class="L2"><code>// .. some logic here .. like any other middleware</code></li>
<li class="L3"><code>next();</code></li>
<li class="L4"><code>});</code></li>
<li class="L5"><code></code></li>
<li class="L6"><code>// will handle any request that ends in /events</code></li>
<li class="L7"><code>// depends on where the router is "use()'d"</code></li>
<li class="L8"><code>router.get('/events', function(req, res, next) {</code></li>
<li class="L9"><code>// ..</code></li>
<li class="L0"><code>});</code></li>

</ol>
你可以在一个特别的根URL上挂载一个路由，这样你就以将你的各个路由放到不同的文件中或者甚至是mini的程序。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>// only requests to /calendar/* will be sent to our "router"</code></li>
<li class="L1"><code>app.use('/calendar', router);</code></li>

</ol>
<div class="md-section-divider"> </div>
<h3 id="methods-4" data-anchor-id="lpyr">Methods</h3>
<div class="md-section-divider"> </div>
<h4 id="routerallpath-callback-callback" data-anchor-id="d5qd">router.all(path, callback)</h4>
这个方法和<code>router.METHOD()</code>方法一样，除了这个方法会匹配所有的HTTP动作。  这个方法对想映射全局的逻辑处理到特殊的路径前缀或者任意匹配是十分有用的。比如，如果你放置下面所示的这个路由在其他路由的前面，那么其将要求从这个点开始的所有的路由进行验证操作和自动加载用户信息。记住，这些全局的逻辑操作，不需要结束请求响应周期：<code>loaduser</code>可以执行一个任务，然后调用<code>next()</code>来将执行流程移交到随后的路由。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>router.all('*', requireAuthentication, loadUser);</code></li>

</ol>
相等的形式:
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>router.all('*', requireAuthentication)</code></li>
<li class="L1"><code>router.all('*', loadUser);</code></li>

</ol>
这是一个白名单全局功能的例子。这个例子很像前面的，不过其仅仅作用于以<code>/api</code>开头的路径:
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>router.all('/api/*', requireAuthentication);</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="routermethodpath-callback-callback" data-anchor-id="frj0">router.METHOD(path, callback)</h4>
<code>router.METHOD()</code>方法提供了路由方法在<code>Express</code>中，这里的<code>METHOD</code>是HTTP方法中的一个，比如<code>GET</code>，<code>PUT</code>，<code>POST</code>等等，但<code>router</code>中的METHOD是小写的。所以，实际的方法是<code>router.get()</code>，<code>router.put()</code>，<code>router.post()</code>等等。  你可以提供多个回调函数，它们的行为和中间件一样，除了这些回调可以通过调用<code>next('router')</code>来绕过剩余的路由回调。你可以使用这个机制来为一个路由设置一些前提条件，如果请求没有满足当前路由的处理条件，那么传递控制到随后的路由。  下面的片段可能说明了最简单的路由定义。Experss转换path字符串为正则表达式，用于内部匹配传入的请求。在匹配的时候，是不考虑<code>Query strings</code>，例如，"GET /"将匹配下面的路由，"GET /?name=tobi"也是一样的。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>router.get('/', function(req, res) {</code></li>
<li class="L1"><code> res.send('Hello World');</code></li>
<li class="L2"><code>});</code></li>

</ol>
如果你对匹配的path有特殊的限制，你可以使用正则表达式，例如，下面的可以匹配"GET /commits/71dbb9c"和"GET /commits/71bb92..4c084f9"。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>router.get(/^\/commits\/(\w+)(?:\.\.(\w+))?$/, function(req, res) {</code></li>
<li class="L1"><code> var from = req.params[0];</code></li>
<li class="L2"><code> var to = req.params[1];</code></li>
<li class="L3"><code> res.send('commit range ' + from + '..' + to);</code></li>
<li class="L4"><code>});</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="routerparamname-callback" data-anchor-id="15ad">router.param(name, callback)</h4>
给路由参数添加回调触发器，这里的<code>name</code>是参数名，<code>function</code>是回调方法。回调方法的参数按序是请求对象，响应对象，下个中间件，参数值和参数名。虽然<code>name</code>在技术上是可选的，但是自Express V4.11.0之后版本不推荐使用(见下面)。
<blockquote class="white-blockquote" data-anchor-id="ujei">
不像<code>app.param()</code>，<code>router.param()</code>不接受一个数组作为路由参数。

</blockquote>
例如，当<code>:user</code>出现在路由路径中，你可以映射用户加载的逻辑处理来自动提供<code>req.user</code>给这个路由，或者对输入的参数进行验证。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> router.param('user', function(req, res, next, id) {</code></li>
<li class="L1"><code> User.find(id, function(error, user) {</code></li>
<li class="L2"><code> if (err) {</code></li>
<li class="L3"><code> next(err);</code></li>
<li class="L4"><code> }</code></li>
<li class="L5"><code> else if (user){</code></li>
<li class="L6"><code> req.user = user;</code></li>
<li class="L7"><code> } else {</code></li>
<li class="L8"><code> next(new Error('failed to load user'));</code></li>
<li class="L9"><code> }</code></li>
<li class="L0"><code> });</code></li>
<li class="L1"><code> });</code></li>

</ol>
对于<code>Param</code>的回调定义的路由来说，他们是局部的。它们不会被挂载的app或者路由继承。所以，定义在<code>router</code>上的<code>param</code>回调只有是在<code>router</code>上的路由具有这个路由参数时才起作用。  在定义<code>param</code>的路由上，<code>param</code>回调都是第一个被调用的，它们在一个请求-响应循环中都会被调用一次并且只有一次，即使多个路由都匹配，如下面的例子：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>router.param('id', function(req, res, next, id) {</code></li>
<li class="L1"><code> console.log('CALLED ONLY ONCE');</code></li>
<li class="L2"><code> next();</code></li>
<li class="L3"><code>});</code></li>
<li class="L4"><code></code></li>
<li class="L5"><code>router.get('/user/:id', function(req, res, next) {</code></li>
<li class="L6"><code> console.log('although this matches');</code></li>
<li class="L7"><code> next();</code></li>
<li class="L8"><code>});</code></li>
<li class="L9"><code></code></li>
<li class="L0"><code>router.get('/user/:id', function(req, res) {</code></li>
<li class="L1"><code> console.log('and this mathces too');</code></li>
<li class="L2"><code> res.end();</code></li>
<li class="L3"><code>});</code></li>

</ol>
当<code>GET /user/42</code>，得到下面的结果:
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code class="language-log"> CALLED ONLY ONCE</code></li>
<li class="L1"><code class="language-log"> although this matches</code></li>
<li class="L2"><code class="language-log"> and this matches too</code></li>

</ol>
`
<blockquote class="white-blockquote" data-anchor-id="c4hh">
下面章节描述的<code>router.param(callback)</code>在v4.11.0之后被弃用。

</blockquote>
通过只传递一个回调参数给<code>router.param(name, callback)</code>方法，<code>router.param(naem, callback)</code>方法的行为将被完全改变。这个回调参数是关于<code>router.param(name, callback)</code>该具有怎样的行为的一个自定义方法，这个方法必须接受两个参数并且返回一个中间件。  这个回调的第一个参数就是需要捕获的url的参数名，第二个参数可以是任一的JavaScript对象，其可能在实现返回一个中间件时被使用。  这个回调方法返回的中间件决定了当URL中包含这个参数时所采取的行为。  在下面的例子中，<code>router.param(name, callback)</code>参数签名被修改成了<code>router.param(name, accessId)</code>。替换接受一个参数名和回调，<code>router.param()</code>现在接受一个参数名和一个数字。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> var express = require('express');</code></li>
<li class="L1"><code> var app = express();</code></li>
<li class="L2"><code> var router = express.Router();</code></li>
<li class="L3"><code></code></li>
<li class="L4"><code> router.param(function(param, option){</code></li>
<li class="L5"><code> return function(req, res, next, val) {</code></li>
<li class="L6"><code> if (val == option) {</code></li>
<li class="L7"><code> next();</code></li>
<li class="L8"><code> }</code></li>
<li class="L9"><code> else {</code></li>
<li class="L0"><code> res.sendStatus(403);</code></li>
<li class="L1"><code> }</code></li>
<li class="L2"><code> }</code></li>
<li class="L3"><code> });</code></li>
<li class="L4"><code></code></li>
<li class="L5"><code> router.param('id', 1337);</code></li>
<li class="L6"><code></code></li>
<li class="L7"><code> router.get('/user/:id', function(req, res) {</code></li>
<li class="L8"><code> res.send('Ok');</code></li>
<li class="L9"><code> });</code></li>
<li class="L0"><code></code></li>
<li class="L1"><code> app.use(router);</code></li>
<li class="L2"><code></code></li>
<li class="L3"><code> app.listen(3000, function() {</code></li>
<li class="L4"><code> console.log('Ready');</code></li>
<li class="L5"><code> });</code></li>

</ol>
在这个例子中，<code>router.param(name. callback)</code>参数签名保持和原来一样，但是替换成了一个中间件，定义了一个自定义的数据类型检测方法来检测<code>user id</code>的类型正确性。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code> router.param(function(param, validator) {</code></li>
<li class="L1"><code> return function(req, res, next, val) {</code></li>
<li class="L2"><code> if (validator(val)) {</code></li>
<li class="L3"><code> next();</code></li>
<li class="L4"><code> }</code></li>
<li class="L5"><code> else {</code></li>
<li class="L6"><code> res.sendStatus(403);</code></li>
<li class="L7"><code> }</code></li>
<li class="L8"><code> }</code></li>
<li class="L9"><code> });</code></li>
<li class="L0"><code></code></li>
<li class="L1"><code> router.param('id', function(candidate) {</code></li>
<li class="L2"><code> return !isNaN(parseFloat(candidate)) && isFinite(candidate);</code></li>
<li class="L3"><code> });</code></li>

</ol>
<div class="md-section-divider"> </div>
<h4 id="routerroutepath" data-anchor-id="s1is">router.route(path)</h4>
返回一个单例模式的路由的实例，之后你可以在其上施加各种HTTP动作的中间件。使用<code>router.route()</code>来避免重复路由名字(例如错字错误)--说的意思应该是使用<code>router.route()</code>这个单例方法来避免同一个路径多个路由实例。
构建在上面的<code>router.param()</code>例子之上，下面的代码展示了怎么使用<code>router.route()</code>来指定各种HTTP方法的处理句柄。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>var router = express.Router();</code></li>
<li class="L1"><code></code></li>
<li class="L2"><code>router.param('user_id', function(req, res, next, id) {</code></li>
<li class="L3"><code> // sample user, would actually fetch from DB, etc...</code></li>
<li class="L4"><code> req.user = {</code></li>
<li class="L5"><code> id:id,</code></li>
<li class="L6"><code> name:"TJ"</code></li>
<li class="L7"><code> };</code></li>
<li class="L8"><code> next();</code></li>
<li class="L9"><code>});</code></li>
<li class="L0"><code></code></li>
<li class="L1"><code>router.route('/users/:user_id')</code></li>
<li class="L2"><code> .all(function(req, res, next) {</code></li>
<li class="L3"><code> // runs for all HTTP verbs first</code></li>
<li class="L4"><code> // think of it as route specific middleware!</code></li>
<li class="L5"><code> next();</code></li>
<li class="L6"><code> })</code></li>
<li class="L7"><code> .get(function(req, res, next) {</code></li>
<li class="L8"><code> res.json(req.user);</code></li>
<li class="L9"><code> })</code></li>
<li class="L0"><code> .put(function(req, res, next) {</code></li>
<li class="L1"><code> // just an example of maybe updating the user</code></li>
<li class="L2"><code> req.user.name = req.params.name;</code></li>
<li class="L3"><code> // save user ... etc</code></li>
<li class="L4"><code> res.json(req.user);</code></li>
<li class="L5"><code> })</code></li>
<li class="L6"><code> .post(function(req, res, next) {</code></li>
<li class="L7"><code> next(new Error('not implemented'));</code></li>
<li class="L8"><code> })</code></li>
<li class="L9"><code> .delete(function(req, res, next) {</code></li>
<li class="L0"><code> next(new Error('not implemented'));</code></li>
<li class="L1"><code> })</code></li>

</ol>
这种方法重复使用单个<code>/usrs/:user_id</code>路径来添加了各种的HTTP方法。
<div class="md-section-divider"> </div>
<h4 id="routerusepath-function-function" data-anchor-id="f8a6">router.use(, function)</h4>
给可选的<code>path</code>参数指定的路径挂载给定的中间件方法，未指定<code>path</code>参数，默认值为<code>/</code>。  这个方法类似于<code>app.use()</code>。一个简单的例子和用例在下面描述。查阅app.use()获得更多的信息。  中间件就像一个水暖管道，请求在你定义的第一个中间件处开始，顺着中间件堆栈一路往下，如果路径匹配则处理这个请求。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>var express = require('express');</code></li>
<li class="L1"><code>var app = express();</code></li>
<li class="L2"><code>var router = express.Router();</code></li>
<li class="L3"><code></code></li>
<li class="L4"><code></code></li>
<li class="L5"><code>// simple logger for this router`s requests</code></li>
<li class="L6"><code>// all requests to this router will first hit this middleware</code></li>
<li class="L7"><code></code></li>
<li class="L8"><code>router.use(function(req, res, next) {</code></li>
<li class="L9"><code> console.log('%s %s %s', req.method, req.url, req.path);</code></li>
<li class="L0"><code> next();</code></li>
<li class="L1"><code>})</code></li>
<li class="L2"><code></code></li>
<li class="L3"><code>// this will only be invoked if the path starts with /bar form the mount ponit</code></li>
<li class="L4"><code>router.use('/bar', function(req, res, next) {</code></li>
<li class="L5"><code> // ... maybe some additional /bar logging ...</code></li>
<li class="L6"><code> next();</code></li>
<li class="L7"><code>})</code></li>
<li class="L8"><code></code></li>
<li class="L9"><code>// always be invoked</code></li>
<li class="L0"><code>router.use(function(req, res, next) {</code></li>
<li class="L1"><code> res.send('hello world')；</code></li>
<li class="L2"><code>})</code></li>
<li class="L3"><code></code></li>
<li class="L4"><code>app.use('/foo', router);</code></li>
<li class="L5"><code></code></li>
<li class="L6"><code>app.listen(3000);</code></li>

</ol>
对于中间件<code>function</code>，挂载的路径是被剥离的和不可见的。关于这个特性主要的影响是对于不同的路径，挂载相同的中间件可能对代码不做改动，尽管其前缀已经改变。  你使用<code>router.use()</code>定义中间件的顺序很重要。中间们是按序被调用的，所以顺序决定了中间件的优先级。例如，通常日志是你将使用的第一个中间件，以便每一个请求都被记录。
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>var logger = require('morgan');</code></li>
<li class="L1"><code></code></li>
<li class="L2"><code>router.use(logger());</code></li>
<li class="L3"><code>router.use(express.static(__dirname + '/public'));</code></li>
<li class="L4"><code>router.use(function(req, res) {</code></li>
<li class="L5"><code> res.send('Hello');</code></li>
<li class="L6"><code>});</code></li>

</ol>
现在为了支持你不希望记录静态文件请求，但为了继续记录那些定义在<code>logger()</code>之后的路由和中间件。你可以简单的将<code>static()</code>移动到前面来解决：
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>router.use(express.static(__dirname + '/public'));</code></li>
<li class="L1"><code>router.use(logger());</code></li>
<li class="L2"><code>router.use(function(req, res){</code></li>
<li class="L3"><code>res.send('Hello');</code></li>
<li class="L4"><code>});</code></li>

</ol>
另外一个确凿的例子是从不同的路径托管静态文件，你可以将<code>./public</code>放到前面来获得更高的优先级:
<div class="md-section-divider"> </div>
<ol class="linenums">
<li class="L0"><code>app.use(express.static(__dirname + '/public'));</code></li>
<li class="L1"><code>app.use(express.static(__dirname + '/files'));</code></li>
<li class="L2"><code>app.use(express.static(__dirname + '/uploads'));</code></li>

</ol>
<code>router.use()</code>方法也支持命名参数，以便你的挂载点对于其他的路由而言，可以使用命名参数来进行预加载，这样做是很有益的。

</div>
<div class="remark-icons">
<div class="remark-icon unselectable" data-anchor-id="68ot">1</div>
<div class="remark-icon unselectable remark-icon-empty" data-anchor-id="xmkk">+</div>

</div>

</div>
<div class="in-page-preview-buttons in-page-preview-buttons-full-reader"> </div>
<div id="reader-full-toolbar" class="reader-full-toolbar-shown"> </div> 
来源：https://www.cnblogs.com/qinlongqiang/p/11465104.html

頁: [1]

琼殿技术论坛's Archiver

node.js express 中文参考手册