Express框架进阶-1---路由

作者: 维仔_411d | 来源:发表于2018-11-24 16:34 被阅读0次

Express框架进阶-1---路由
express 基础以及mongo基础
在nodeJS中使用MongoDB
nodeJS搭建web服务器
Express中间件
express框架
express框架关于路由
Express框架的路由
Express-node项目流
3-express框架处理路由/路由参数/静态资源/ejs渲染/

本文主要内容有六点：

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---路由

参考文章：