Express

1. Express 框架简介

它是一个基于 Node 平台的 web 应用开发框架，它提供了一系列的强大特性，帮助我们创建各种 Web 应用

下载：npm install express

---

1.1 Express 特性

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

---

1.2 Express 创建服务器

该框架创建服务器很简单，调用 express 模块返回的函数即可

const express = require('express'); // 引入 Express 框架
const app = express(); // 创建网站服务器
app.get('/', (req, res) => {
    res.send('<h2>Hello!</h2>'); // 识别为html
});
app.listen(80); // 监听端口

响应给客户端内容的 send 方法功能比 end 方法要强大：

1. 内部会检测响应内容的类型

2. 会帮自动设置响应的内容类型及编码

3. 会自动设置 http 状态码

---

2. 中间件

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

---

2.1 什么是中间件

中间件主要由两部分构成：

1. 中间件方法：由 Express 提供，负责拦截请求
2. 请求处理函数：由开发人员编写，负责处理请求

语法：app.get('请求路径', '处理函数')

解释：接收并处理 get 请求（post 方法同）

// 接收并处理post请求
app.post('/request', (req, res, next) => {
	req.name = "张三";
	next();
})

---

2.2 中间件的控制

可以针对同一个请求设置多个中间件，对同一个请求进行多次处理

默认情况下：请求从上到下依次匹配中间件，一旦匹配成功，终止匹配

但可以调用 next 方法将请求的控制权交给下一个中间件，直到遇到结束请求的中间件

app.get('/request', (req, res, next) => {
    req.name = 'wzq';
    next(); // 继续由下一个中间件处理
});
app.get('/request', (req, res, next) => {
    res.send(req.name); // wzq
});

---

2.3 use 中间件用法

不区分 get 和 post 请求方式，只要有请求都接收

• 接收所有的请求：需处于所有路由最前面

app.use((req, res, next) => {
    console.log('请求了use中间件');
    next()
});

• 接收指定路径请求：在第一个参数内传入请求路径

app.use('/request', (req, res, next) => {
    console.log('请求了use / request 中间件')
    next()
});

---

2.3 中间件应用

1. 路由保护，客户端在访问需要登录的页面时，可以先使用中间件判断用户登录状态，用户如果未登录，则拦截请求，直接响应，禁止用户进入需要登录的页面

   View code

app.use('/admin', (req, res, next) => {
    let isLogin = 0; // 模拟用户如果没有登录
    // let isLogin = 1;
    if (isLogin) { // 如果用户登录
        next()
    } else {
        res.send('您还未登录，不能访问')
    }
});
app.get('/admin', (req, res) => {
    res.send('您已经登录 可以访问当前页面')
})

2. 网站维护公告，在所有路由的最上面定义接收所有请求的中间件，直接为客户端做出响应，网站正在维护中

3. 自定义 404 页面反馈

   View code

app.use((req, res) => {
    res.status(404) // 设置状态码
        .send('当前访问的页面是不存在的');
})

---

2.4 错误处理中间件

在程序执行的过程中，不可避免的会出现一些无法预料的错误，如：文件读取失败，数据库连接失败

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

app.get("/", (req, res, next) => {
    fs.readFile('./01.js', 'utf8', (err, result) => {
        if (err) {
            next(err); // 传递错误信息
        }
    });
});

错误处理中间件是一个集中处理错误的地方

app.use((err, req, res, next) => {
    res.status(500) // 更改状态码
       .send(err.message); // 响应错误消息
})

---

2.5 捕获错误

在 node.js 中，异步 API 的错误信息都是通过回调函数获取的，支持Promise 对象的异步 API 发生错误可以通过 catch 方法捕获

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

app.get("/", async (req, res, next) => {
    try { // 尝试运行这段代码
        await readFile('./01.js');
    } catch (err) { // 如果上面代码有报错就再执行这段
        next(err) // 传递错误信息
    }
});

---

3. Express 请求处理

---

3.1 构建模块化路由

模块化路由的基础，创建二级路由

const express = require('express'); // 引入 Express 框架
const app = express(); // 创建网站服务器
const home = express.Router(); // 创建路由对象

app.use('/home', home); // 为路由对象匹配请求

home.get('/index', (req, res) => { // 创建二级路由
    res.send('首页')
})

app.listen(80); // 监听端口
console.log('网站服务器启动成功');

// 访问 http://localhost/home/index

将不同的类别的路由模块化分离为单独的文件

View code

• app.js

const express = require('express'); // 引入 Express 框架
const app = express(); // 创建网站服务器

const home = require('./route/home'); // 导入路由

// 添加二级路由
app.use('/home', home);

app.listen(80); // 监听端口
console.log('网站服务器启动成功');

• home.js

const express = require('express');

const home = express.Router(); // 创建路由对象

home.get('/index', (req, res) => { // 二级路由
    res.send('欢迎来到首页')
});

module.exports = home; // 导出路由

---

3.2 GET 参数的获取

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

// 例如: http://localhost:3000/?name=wzq&age=30
app.get('/', (req, res) => {
    res.send(req.query); // {"name": "wzq", "age": "30"}
});

---

3.3 POST 参数的获取

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

// 引入body-parser模块
const bodyParser = require('body-parser');
// 配置body-parser模块
app.use(bodyParser.urlencoded({ extended: false }));
// 接收请求
app.post('/add', (req, res) => {
    res.send(req.body) // 接收 post 请求参数
}) 

---

3.4 Express 路由参数

在路由地址上接收的参数，可设置多个形参接收多个路由参数

app.get('/index/:id/:name', (req, res) => { 
    res.send(req.params); // {id: 123, name:wzq} 
});
// http://localhost/index/123/wzq

注意：如果路由与形参位数不匹配是接收不到的

---

3.5 静态资源的处理

通过 Express 内置的 express.static 可以方便地托管静态文件

例：img、Css、Js 文件等..

const path = require('path'); // 路径拼接
app.use(express.static(path.join(__dirname, 'public')))

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

如：http://localhost/css/index.css

注意：可在 use 内第一个参数设定根路由

---

4. 模板引擎

为了使 art-template 模板引擎能够更好的和Express框架配合，模板引擎官方在原 art-template 模板引擎的基础上封装了 express-art-template

---

4.1 基本使用

下载：npm install art-template express-art-template

注意：下载多个第三方插件以空格隔开

// 告诉 express 框架使用什么模板引擎渲染什么后缀的模板文件
app.engine('art', require('express-art-template'));
// 告诉 express 框架模板存放的位置是什么
app.set('views', path.join(__dirname, 'views'));
// 指定模板引擎默认后缀
app.set('view engine', 'art');
app.get('/', (req, res) => {
    res.render('index'); // 渲染模板
    // 1. 拼接模板路径
    // 2. 拼接模板后缀
    // 3. 哪一个模板和哪一个数据进行拼接
    // 4. 将拼接结果响应给了客户端
}); 

---

4.2 app.locals 对象

将变量设置到这个对象下面，这个数据在所有的模板中都可以获取到

app.locals.data = [{
    name: 'zhangsan',
    age: 20
}, {
    name: '李四',
    age: 30
}]

---