本文主要内容有六点:
1. 路由;
2. Route methods;
3. Route paths
4. Route handlers
5. 返回各种格式数据给client
附录
我认为做一个后台,主要需要做到3点,
- 路由:接收到请求,将其转给正确的处理函数处理,并将结果返回给client端;
- 数据源:自己访问数据库还是调用第三方api请求数据
- 错误处理:保证能够捕获并正确处理各种错误,保障后台的稳定性可靠性。
相关文章:
Express框架初探
Express框架进阶-1---路由
- 路由
路由是由Express的实例 app,调用方法实现。app.mehods(path, handler1, handler2...,next)
request需符合该路由支持的请求方法(request method, 与http的method类似)和路径(path),方才匹配到了该路由。匹配到路由后则调用路由指定的handler(或者称为callback)
1-1. 调用和http请求方式相对应的方法
如app.post('/user', function(req, res){res.send('give you post response.')})
;
1-2. 处理所有的http请求方法
使用方法all(), 如app.all('/user2', function(req, res){res.send('give you response no matter what method')})
1-3. 指定路由中间件处理
使用方法use(),代码如下,当用户访问127.0.0.1:3000/user3时 看到返回router middleware give you response。
var express = require('express');
var app = new express();
var user3Router = express.Router();
// 注意此router路径是基于use他的函数中指定的path的,在此例中就是基于'/user3'
user3Router.get('/', function(req, res, next) {
// 此function是一个handler(或者叫callback),
// next的作用是将当前流程交给下一个handler处理,next(handlerFunction(params)) ??????????
res.send('router middleware give you response');
});
app.use('/user3', user3Router);
app.listen(3000);
- Route methods
路由的方法由支持所有http的方法,与之同名(小写),由express实例调用。
all, (此方法可以响应指定路径下的所有http方法的请求)
get, post, put, delete, options, head, trace, connect, patch[1]
checkout, copy, lock, unlock, merge, mkactivity, mkcol, move, m-search, notify, purge, report, search, subscribe, unsubscribe[2]
- Route paths
路由路径除了上文使用的最简单的字符串(完全匹配),还可以使用字符串匹配和正则表达式。 [3]
3-1 路径匹配
字符串
app.get('/usersInfo', function(req, res){
res.send('匹配路径/usersInfo');
});
字符串匹配模式
app.get('/users?Info', function(req, res){
res.send('匹配路径/usersInfo或/userInfo');
});
app.get('/usersInfo/([\\$])detail', function(req, res){
res.send('匹配路径/usersInfo/$detail');
});
正则匹配
app.get(/users?Info$/, function(req, res){
res.send('匹配路径/usersInfo或/userInfo');
});
3-2 路由参数
用户请求/users/2333/books/666 时, 参数填充进对象 req.params
app.get('/users/:userId/books/:bookId', function (req, res) {
res.send(req.params)
})
tips: 参数名只能是字母数字下划线组成,参数名可以用括号中的正则表达式进行匹配,不过目前的Express4中路径参数括号中的正则,有部分与js的正则表达式不一致 比如*,我个人认为还是慎用。
In Express 4.x, the *
character in regular expressions is not interpreted in the usual way. As a workaround, use {0,}
instead of *
. This will likely be fixed in Express 5.
- Route handlers
handler可以是一个函数、多个函数、函数数组、多个函数+函数数组 四种
4-1. 一个函数的handler
app.get('/users/:userId/books/:bookId', function (req, res) {
res.send(req.params)
})
4-2. 多个函数的handler
app.get('/users/:userId/books/:bookId', function (req, res, next) {
// res.send(req.params)
if(/^\d+$/.test(req.params.bookId)) {
res.send('valid bookId:'+req.params.bookId);
} else {
next();
}
}, function(req, res, next) {
res.send('invalid bookId:'+req.params.bookId);
})
4-3. 函数数组的handler
var cabFunc1 = function(req, res, next) {...};
var cabFunc2 = function(req, res, next) {...};
var cabFunc3 = function(req, res, next) {...};
app.get('/users/:userId/books/:bookId', [cabFunc1, cabFunc2, cabFunc3])
4-4. 多个函数+函数数组的handler
var cabFunc1 = function(req, res, next) {...};
var cabFunc2 = function(req, res, next) {...};
var cabFunc3 = function(req, res, next) {...};
app.get('/users/:userId/books/:bookId', [cabFunc1, cabFunc2, cabFunc3],function(req, res, next) {
...
}, function(req, res) {
...
})
5 返回数据给client
5-1. 返回json字符串
res.json(responseObj); // 此处使用的是JSON.stringify()
5-2. 返回html
若使用的是模板
res.render('relativeFilePath');
若直接返回文件
res.sendFile(__dirname+'relativeFilePath');
5-3. 可以返回Buffer对象、对象、数组、字符串
res.send(bufferOrStringOrObjOrArray );
tips:对象和数组会以json字符串的形式返回
附录:
目前用到的函数:
var express = require('express');
var app = new express();
var router = express.Router();
router.get('/', function(){
res.sendFile(__dirname+'/package.json');
});
app.use(express.static(__dirname+'/public'));
app.get('/', function(req, res, next) {
res.send('xxx');
});
app.use('/route1', router);
- 对同一路径不同请求方法的处理可以使用app.route(),路径只需写一次,避免了冗余和写多次可能造成 拼写错误。
app.route(path)
.get(function(req, res){
...
})
.post(function(req, res){
...
})
- respons返回给client端信息可调用的方法
res.send()
res.sendFile()
res.sendStatus()[4]
res.render()
res.json()
res.jsonp()
res.redirect()
res.end()
res.download()
另外response的方法还有append、attachement、cookie、clearCookie、format、get、links、location、set、status、type、vary。我们平时常用到的,设置response的头部信息,需用到res.set(field, value)
res.set('Content-Type', 'text/plain');
res.set({
'Content-Type':'text/plain',
'Etag': '123456'
});
res.setHeader('test-header1', 'Hvalue');
// 设置cookie, express提供了api
res.cookie('name', 'value', {expires: new Date(Date.now()+3600000), httpOnly: true, path:'/'})
response的属性
res.app
res.headersSent
res.locals
相关文章:
Express框架初探
Express框架进阶-1---路由
参考文章: