Express.js路由详解

版权声明：本文为博主chszs的原创文章，未经博主允许不得转载。 https://blog.csdn.net/chszs/article/details/51055229

Express.js路由详解

作者：chszs，未经博主允许不得转载。经许可的转载需注明作者和博客主页：http://blog.csdn.net/chszs

Express路由模块

Express的路由模块是由一个URI（或者叫路径）和一个特定的HTTP方法（比如GET、POST等）组成的，表示应用该如何响应客户端对指定URI的访问。
每一个路由都可以有一个或多个处理函数，当匹配到路由时，将执行相应的函数。
路由的定义由如下结构组成：

app.METHOD(PATH, HANDLER)

其中，app表示一个express实例；METHOD是HTTP的请求方法；PATH是服务器端的路径,即URI；HANDLER表示当路由匹配时需要执行的函数。比如：

app.get('/', function (req, res) {
  res.send('Hello World!');
});

// 网站首页接受 POST 请求
app.post('/', function (req, res) {
  res.send('Got a POST request');
});

// /user 节点接受 PUT 请求
app.put('/user', function (req, res) {
  res.send('Got a PUT request at /user');
});

// /user 节点接受 DELETE 请求
app.delete('/user', function (req, res) {
  res.send('Got a DELETE request at /user');
});

curl测试

测试以上代码，用curl工具。

测试GET请求
$ curl -G http://localhost:3000/
或者用
curl -X GET http://localhost:3000/
测试POST请求
$ curl -d "" http://localhost:3000/
或者用
$ curl -X POST http://localhost:3000/
测试PUT请求
C:\>curl -X PUT http://localhost:3000/
测试DELETE请求
C:\>curl -X DELETE http://localhost:3000/

请求方法

Express定义了与HTTP请求对应的路由方法，包括：get, post, put, head, delete, options, trace, copy, lock, mkcol, move, purge, propfind, proppatch, unlock, report, mkactivity, checkout, merge, m-search, notify, subscribe, unsubscribe, patch, search和connect。

app.all()

app.all()是一个特殊的路由方法，没有任何HTTP方法与其对应，它的作用是对于一个路径上的所有请求加载中间件。
在下面的例子中，只要是来自“/secret”的请求，不管使用GET、POST、PUT、DELETE或其他任何http模块支持的HTTP请求，句柄都会得到执行。

app.all('/secret', function (req, res, next) {
  console.log('Accessing the secret section ...');
  next(); // pass control to the next handler
});

Express的路由路径和请求方法一起定义了请求的端点，它可以是字符串、字符串模式或者正则表达式。

Express Route Tester工具

Express使用了path-to-regexp来匹配路由路径。另外，Express Route Tester是测试基本Express路径的好工具，但它不支持模式匹配。

Express Route Tester工具见 http://forbeslindesay.github.io/express-route-tester/

path-to-regexp工具

path-to-regexp是Express风格的路径正则工具，见 https://www.npmjs.com/package/path-to-regexp
Express内部依赖了此工具，故无需单独安装。

path-to-regexp的用法

var pathToRegexp = require('path-to-regexp')
// pathToRegexp(path, keys, options)
// pathToRegexp.parse(path)
// pathToRegexp.compile(path)

其中，

• path指express格式中的一个字符串、或一个字符串数组、或一个正则表达式
• keys指对URL中的关键词进行填充的数组
• options有三个值：
  
  • sensitive 如果为true表示URL是大小写敏感的，默认为false
  • strict 如果为false表示URL最后的斜线“/”是可省略的，默认为false
  • end 如果为false表示路径会从头匹配，默认为false

path-to-regexp中的参数

1）命名参数
命名此参数使用“:”加上参数名的方式来定义，比如“:foo”

2）后缀参数

• 可选的后缀参数
  使用符号“?”再紧跟参数，说明整个参数是可选的，前面还可以结合“/”或“.”一起使用，比如：

‘’

var re = pathToRegexp('/:foo/:bar?', keys)
// keys = [{ name: 'foo', ... }, { name: 'bar', delimiter: '/', optional: true, repeat: false }] 

• 零到多个
  使用“*”号

‘’

var re = pathToRegexp('/:foo*', keys)
// keys = [{ name: 'foo', delimiter: '/', optional: true, repeat: true }] 

• 1到多个
  使用“+”号

‘’

var re = pathToRegexp('/:foo+', keys)
// keys = [{ name: 'foo', delimiter: '/', optional: false, repeat: true }] 

• 自定义匹配参数
  还可以用正则表达式自定义匹配参数。

‘’

var re = pathToRegexp('/:foo(\\d+)', keys)
// keys = [{ name: 'foo', ... }] 

• 未命名的参数
  URL中出现未命名的参数也是可以的，比如：

‘’

var re = pathToRegexp('/:foo/(.*)', keys)
// keys = [{ name: 'foo', ... }, { name: '0', ... }] 

• 星号
  用星号“*”来匹配子路径的一切，比如：

‘’

var re = pathToRegexp('/foo/*', keys)
// keys = [{ name: '0', ... }] 

路径匹配例子：

// 匹配 /random.txt 路径的请求
app.get('/random.txt', function (req, res) {
  res.send('random.txt');
});

// 匹配 qcd 和 qbcd
app.get('/qb?cd', function(req, res) {
  res.send('qb?cd');
});

// 匹配 qbcd、qbbcd、qbbbcd等
app.get('/qb+cd', function(req, res) {
  res.send('qb+cd');
});

// 匹配 qbcd、qbxcd、qbRABDOMcd、qb123cd等
app.get('/qb*cd', function(req, res) {
  res.send('qb*cd');
});

// 匹配 /qbe 和 /qbcde
app.get('/qb(cd)?e', function(req, res) {
 res.send('qb(cd)?e');
});

// 匹配任何路径中含有 q 的路径：
app.get(/q/, function(req, res) {
  res.send('/q/');
});

// 匹配 butterfly、dragonfly，不匹配 butterflyman、dragonfly man等
app.get(/.*fly$/, function(req, res) {
  res.send('/.*fly$/');
});

Express的链式路由

可使用app.route()创建路由路径的链式路由句柄。由于路径在一个地方指定，这样做有助于创建模块化的路由，而且减少了代码冗余和拼写错误。

app.route('/car')
  .get(function(req, res) {
    res.send('Get a random car');
  })
  .post(function(req, res) {
    res.send('Add a car');
  })
  .put(function(req, res) {
    res.send('Update the car');
  });