在使用express管理url时,我们希望能有一种更方便的管理方式,可以更加简化路由的管理,express router 就是完成这项功能的,。
路由器
使用router
目的是中间件和路由的分离的实例。您可以将其视为“迷你应用程序”,只能执行中间件和路由功能。每个Express应用程序都有一个内置的应用程序路由器。
路由器的行为类似于中间件本身,因此您可以将其用作 app.use()的参数或作为另一个路由器的use()方法的参数。
顶级express
对象具有一个用于创建新对象的Router()方法router
。
一旦你创建了一个路由器的对象,你可以添加中间件和HTTP方法路由(如get
,put
,post
,等),以它就像一个应用程序。例如:
var express = require('express');
var app = express();
var router = express.Router();
// invoked for any requests passed to this router
router.use(function(req, res, next) {
// .. some logic here .. like any other middleware
next();
});
// will handle any request that ends in /events
// depends on where the router is "use()'d"
router.get('/events', function(req, res, next) {
// ..
});
然后,您可以使用路由器来处理特定的根URL,从而将路由分成文件甚至是迷你应用程序。
// only requests to /calendar/* will be sent to our "router"
app.use('/calendar', router);
方法
router.all(path,[callback,…] callback)
此方法与router.METHOD()
方法类似,只是它匹配所有HTTP方法(动词)。
此方法对于映射特定路径前缀或任意匹配的“全局”逻辑非常有用。例如,如果将以下路由放在所有其他路由定义的顶部,则需要从该点开始的所有路由都需要身份验证,并自动加载用户。请记住,这些回调不必充当终点; loadUser
可以执行任务,然后调用next()
以继续匹配后续路由。
router.all('*', requireAuthentication, loadUser);
或等效的:
router.all('*', requireAuthentication)
router.all('*', loadUser);
另一个例子是白名单的“全局”功能。这里的示例与之前非常相似,但它仅限制前缀为“/ api”的路径:
router.all('/api/*', requireAuthentication);
router.METHOD(path,[callback,…] callback)
这些router.METHOD()
方法在Express中提供路由功能,其中METHOD是HTTP方法之一,例如GET,PUT,POST等,小写。因此,实际的方法是router.get()
,router.post()
, router.put()
,等等。
除了之前未为路径调用的方法之外,还会router.get()
自动为HTTP HEAD
方法调用该函数。GET``router.head()``router.get()
您可以提供多个回调,并且所有回调都是平等对待的,并且行为就像中间件一样,除了这些回调可能会调用next('route')
以绕过剩余的路由回调。您可以使用此机制在路由上执行前置条件,然后在没有理由继续匹配的路由时将控制权传递给后续路由。
以下代码段说明了可能的最简单的路由定义。Express将路径字符串转换为正则表达式,在内部用于匹配传入的请求。执行这些匹配时不考虑查询字符串,例如“GET /”将匹配以下路由,“GET /?name = tobi”也是如此。
router.get('/', function(req, res){
res.send('hello world');
});
您还可以使用正则表达式 - 如果您具有非常特定的约束,则有用,例如,以下内容将匹配“GET / commits / 71dbb9c”以及“GET /commits/71dbb9c…4c084f9”。
router.get(/^\/commits\/(\w+)(?:\.\.(\w+))?$/, function(req, res){
var from = req.params[0];
var to = req.params[1] || 'HEAD';
res.send('commit range ' + from + '..' +