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');
});