前言:第三方模块 router

功能:实现路由
使用步骤:

  1. 获取路由对象
  2. 调用路由对象提供的方法创建路由
  3. 启用路由,使路由生效
1
2
3
4
5
6
7
8
9
const server = http.createServer();
const getRouter = require('router')
const router = getRouter();
router.get('/add', (req, res) => {
res.end('Hello World!')
})
server.on('request', (req, res) => {
router(req, res)
})

##1.Express框架

1.1 Express框架是什么

Express是一个基于Node平台web应用开发框架,它提供了一系列的强大特性,帮助你创建各种Web应用。我们可以使用 npm install express 命令进行下载。

1.2 Express框架特性

  • 提供了方便简洁的路由定义方式
  • 对获取HTTP请求参数进行了简化处理
  • 对模板引擎支持程度高,方便渲染动态HTML页面
  • 提供了中间件机制有效控制HTTP请求
  • 拥有大量第三方中间件对功能进行扩展

1.3 原生Node.js与Express框架对比之路由

原生Node.js与Express对比之路由之路由

###1.4 原生Node.js与Express框架对比之获取请求参数

原始Node.js与Express框架对比之请求参数

###1.5 Express初体验

1
2
3
4
5
6
7
8
9
10
11
// 引入Express框架
const express = require('express');
// 使用框架创建web服务器
const app = express();
// 当客户端以get方式访问/路由时
app.get('/', (req, res) => {
// 对客户端做出响应 send方法会根据内容的类型自动设置请求头
res.send('Hello Express'); // <h2>Hello Express</h2> {say: 'hello'}
});
// 程序监听3000端口
app.listen(3000);

2. 中间件

2.1 什么是中间件

中间件就是一堆方法,可以接收客户端发来的请求、可以对请求做出响应,也可以将请求继续交给下一个中间件继续处理。
什么是中间件

中间件主要由两部分构成,中间件方法以及请求处理函数。
中间件方法由Express提供,负责拦截请求,请求处理函数由开发人员提供,负责处理请求。

1
2
app.get('请求路径', '处理函数')   // 接收并处理get请求
app.post('请求路径', '处理函数') // 接收并处理post请求

&nbsp;&nbsp;&nbsp;&nbsp;可以针对同一个请求设置多个中间件,对同一个请求进行多次处理。
&nbsp;&nbsp;&nbsp;&nbsp;默认情况下,请求从上到下依次匹配中间件,一旦匹配成功,终止匹配。
&nbsp;&nbsp;&nbsp;&nbsp;可以调用next方法将请求的控制权交给下一个中间件,直到遇到结束请求的中间件。

1
2
3
4
5
6
7
app.get('/request', (req, res, next) => {
req.name = "张三";
next();
});
app.get('/request', (req, res) => {
res.send(req.name);
});

2.2 app.use中间件用法

&nbsp;&nbsp;&nbsp;&nbsp;app.use 匹配所有的请求方式,可以直接传入请求处理函数,代表接收所有的请求。

1
2
3
4
app.use((req, res, next) => {
console.log(req.url);
next();
});

&nbsp;&nbsp;&nbsp;&nbsp;app.use 第一个参数也可以传入请求地址,代表不论什么请求方式,只要是这个请求地址就接收这个请求。

1
2
3
4
5
app.use('/admin', (req, res, next) => {
console.log(req.url);
next();
});

###2.3 中间件应用

  1. 路由保护,客户端在访问需要登录的页面时,可以先使用中间件判断用户登录状态,用户如果未登录,则拦截请求,直接响应,禁止用户进入需要登录的页面。
  2. 网站维护公告,在所有路由的最上面定义接收所有请求的中间件,直接为客户端做出响应,网站正在维护中。
  3. 自定义404页面

###2.4 错误处理中间件
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;在程序执行的过程中,不可避免的会出现一些无法预料的错误,比如文件读取失败,数据库连接失败。
错误处理中间件是一个集中处理错误的地方。

1
2
3
app.use((err, req, res, next) => {
res.status(500).send('服务器发生未知错误');
})

&nbsp;&nbsp;&nbsp;&nbsp;当程序出现错误时,调用next()方法,并且将错误信息通过参数的形式传递给next()方法,即可触发错误处理中间件。

1
2
3
4
5
6
7
 app.get("/", (req, res, next) => {
fs.readFile("/file-does-not-exist", (err, data) => {
if (err) {
next(err);
}
});
});

###2.5 捕获错误
在node.js中,异步API的错误信息都是通过回调函数获取的,支持Promise对象的异步API发生错误可以通过catch方法捕获。
异步函数执行如果发生错误要如何捕获错误呢?

try catch 可以捕获异步函数以及其他同步代码在执行过程中发生的错误,但是不能其他类型的API发生的错误。

1
2
3
4
5
6
7
app.get("/", async (req, res, next) => {
try {
await User.find({name: '张三'})
}catch(ex) {
next(ex);
}
});

##2. Express请求处理
###2.1 构建模块化路由

1
2
3
4
5
6
7
8
9
10
const express = require('express') 
// 创建路由对象
const home = express.Router();
// 将路由和请求路径进行匹配
app.use('/home', home);
// 在home路由下继续创建路由
home.get('/index', () => {
// /home/index
res.send('欢迎来到博客展示页面');
});
1
2
3
4
5
6
// home.js
const home = express.Router();
home.get('/index', () => {
res.send('欢迎来到博客展示页面');
});
module.exports = home;
1
2
3
4
5
6
7

// admin.js
const admin = express.Router();
admin.get('/index', () => {
res.send('欢迎来到博客管理页面');
});
module.exports = admin;
1
2
3
4
5
// app.js
const home = require('./route/home.js');
const admin = require('./route/admin.js');
app.use('/home', home);
app.use('/admin', admin);

###2.3 GET参数的获取

Express框架中使用req.query即可获取GET参数,框架内部会将GET参数转换为对象并返回。

1
2
3
4
5
// 接收地址栏中问号后面的参数
// 例如: http://localhost:3000/?name=zhangsan&age=30
app.get('/', (req, res) => {
console.log(req.query); // {"name": "zhangsan", "age": "30"}
});

2.4 POST参数的获取

Express中接收post请求参数需要借助第三方包 body-parser。

1
2
3
4
5
6
7
8
9
10
// 引入body-parser模块
const bodyParser = require('body-parser');
// 配置body-parser模块
app.use(bodyParser.urlencoded({ extended: false }));
// 接收请求
app.post('/add', (req, res) => {
// 接收请求参数
console.log(req.body);
})

###2.5 Express路由参数

1
2
3
app.get('/find/:id', (req, res) => { 
console.log(req.params); // {id: 123}
});
1
localhost:3000/find/123

###2.6 静态资源的处理

通过Express内置的express.static可以方便地托管静态文件,例如img、CSS、JavaScript 文件等。

1
app.use(express.static('public'));

现在,public 目录下面的文件就可以访问了。