Express框架

Express简介

Express框架特性
- 提供了方便简洁的路由定义方式
- 对获取HTTP请求参数进行了简化处理
- 对模板引擎支持程度高，方便渲染动态HTML页面
- 提供了中间件机制有效控制HTTP请求
- 拥有大量第三方中间件对功能进行扩展
Express框架初体验
- 项目文件夹下下载 npm install express
- 引入express框架 const express = require('express');
- 创建网络服务器 const app = express();
- 监听端口 app.listen(3000);
- 路由定义 send()方法功能
  - send方法内部会检测响应内容的类型 Request Method
  - send方法会自动设置http状态码 Status Code
  - send方法会帮我们自动设置响应的内容类型及编码 Content-Type
- 当访问不存在的路由时，页面提示 Cannot GET /lists

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

app.get('/', (req, res) => {
    res.send('Hello Express');
});
app.get('/list', (req, res) => {
    res.send({
        name: 'sunny',
        age: 20
    });
})
//监听端口
app.listen(3000);
console.log('网站服务器启动成功');

中间件

中间件概念
- 中间件就是一堆方法，可以接收客户端发来的请求、可以对请求做出响应，也可以将请求继续交给下一个中间件继续处理。
- 中间件主要由两部分构成，中间件方法以及请求处理函数。
- 中间件方法由Express提供，负责拦截请求，请求处理函数由开发人员提供，负责处理请求。
  - app.get('请求路径', '处理函数') 接收并处理get请求
  - app.post('请求路径', '处理函数') 接收并处理post请求
设置多个中间件 next参数
- 可以针对同一个请求设置多个中间件，对同一个请求进行多次处理。
- 默认情况下，请求从上到下依次匹配中间件，一旦匹配成功，终止匹配。
- 可以调用next方法将请求的控制权交给下一个中间件，直到遇到结束请求的中间件。

app.get('/request', (req, res, next) => {
    req.name = 'sunny';
    next();
});
app.get('/request', (req, res) => {
    res.send(req.name);
})

app.use 中间件用法
- app.use 匹配所有的请求方式，可以直接传入请求处理函数，代表接收所有的请求。
- app.use 第一个参数也可以传入请求地址，代表不论什么请求方式，只要是这个请求地址就接收这个请求。

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

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

// 网站公告
// app.use((req, res, next) => {
//     res.send('当前网络正在维护！');
// });
app.use('/admin', (req, res, next) => {
    let IsLogin = false;
    IsLogin? next(): res.send('请您登陆后再访问');
});
app.get('/admin', (req, res) => {
    res.send('您已经登录，可以访问页面');
})
// 为客户端响应404状态码以及提示信息
app.use((req, res, next) => {
    res.status(404).send('当前访问页面不存在！');
});

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

app.get('/index', (req, res, next) => {
    // throw new Error('程序发生了未知错误');
    fs.readFile('/demo.txt', 'utf8', (err, result) => {
        if(err != null){
            next(err);
        }else{
            res.send(result);
        }
    });
});
// 错误处理中间件
app.use((err, req, res, next) => {
    res.status(500).send(err.message);
});

捕获错误
- 在node.js中，异步API的错误信息都是通过回调函数获取的
- 支持Promise对象的异步API发生错误可以通过catch方法捕获
- try catch 可以捕获异步函数以及其他同步代码在执行过程中发生的错误，但是不能其他类型的API发生的错误

app.get('/index', async (req, res, next) => {
    try {
        await readFile('./aaa.js');
    } catch (ex) {
        next(ex);
    }
});
// 错误处理中间件
app.use((err, req, res, next) => {
    res.status(500).send(err.message);
});

Express框架请求处理

构建模块化路由
- 创建app.js
- 创建模块路由home.js
- 创建模块路由admin.js

// 引入express框架
const express = require('express');
// 创建网络服务器
const app = express();
// home路由模块
const home = require('./route/home.js');
app.use('/home', home);
// admin路由模块
const admin = require('./route/admin.js');
app.use('/admin', admin);
// 错误处理中间件
app.use((err, req, res, next) => {
    res.status(500).send(err.message);
});
//监听端口
app.listen(3000); 
console.log('网站服务器启动成功');

// 引入express框架
const express = require('express');
// 创建一级路由
const home = express.Router();
// 创建二级路由
home.get('/index', (req, res) => {
    res.send('欢迎来到博客展示页面');
});
module.exports = home;

// 引入express框架
const express = require('express');
// 创建一级路由
const admin = express.Router();
// 创建二级路由
admin.get('/login', (req, res) => {
    res.send('欢迎来到博客登录页面');
});
module.exports = admin;

GET参数的获取
- Express框架中使用req.query即可获取GET参数，框架内部会将GET参数转换为对象并返回。
- 地址栏回车 http://localhost:3000/index?name=sunny&age=90
- 输出 {"name":"sunny","age":"90"}

app.get('/index', (req, res) => {
    res.send(req.query);
});

POST参数的获取
- 下载第三方包：npm install body-parser
- Express中接收post请求参数需要借助第三方包 body-parser
- 若extended: false，则会调用系统模块querystring对参数格式进行处理

// 引入express框架
const express = require('express');
// 引入body-parser模块
const bodyParser = require('body-parser');
// 创建网络服务器
const app = express();
// 拦截所有请求
// 配置body-parser模块
// extended: false 方法内部使用querystring模块处理请求参数的格式
// extended: true 方法内部使用第三方模块qs处理请求参数的格式
app.use(bodyParser.urlencoded({ extended: false }));
// 接收请求
app.post('/add', (req, res) => {
    // 接收请求参数
    res.send(req.body);
}) 
//监听端口
app.listen(3000); 
console.log('网站服务器启动成功');

<form action="http://localhost:3000/add" method='post'>
    <input type="text" name='username'>
    <input type="password" name='password' >
    <input type="submit">
</form>

Express路由参数
- 地址栏http://localhost:3000/index/025/sunny/19
- 输出{"id":"025","name":"sunny","age":"19"}
- 如果不传递参数，那么将匹配不到路由

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

静态资源访问
- 用app.use()拦截所有请求
- 通过Express内置的express.static可以方便地托管静态文件
- 例如img、CSS、JavaScript文件等

// 引入express框架
const express = require('express');
const path = require('path');
// 创建网络服务器
const app = express();
// 静态资源访问
app.use(express.static(path.join(__dirname, 'public')));
//监听端口
app.listen(3000); 
console.log('网站服务器启动成功');

express-art-template模板引擎

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

const express = require('express');
const path = require('path');
const app = express();
// 当渲染后缀为art的模板时 使用express-art-template
app.engine('art', require('express-art-template'));
// 设置模板存放目录
app.set('views', path.join(__dirname, 'views'));
// 渲染模板时不写后缀 默认拼接art后缀
app.set('view engine', 'art');
app.get('/index', (req, res) => {
   // 渲染模板
   // 拼接模板路径
   // 拼接模板后缀
   // 模板与数据匹配拼接
   // 将拼接结果响应给了客户端
   res.render('index', {
       msg: 'message'
   });
}); 
app.get('/list', (req, res) => {
    res.render('list', {
        name: 'sunny',
        age: 18
    });
});
//监听端口
app.listen(3000); 
console.log('网站服务器启动成功');

app.locals 对象公共代码
- 将变量设置到app.locals对象下面，这个数据在所有的模板中都可以获取到

const express = require('express');
const path = require('path');
const app = express();
app.engine('art', require('express-art-template'));
app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'art');
app.locals.user = [{
    name: 'Tom',
    age: 18
},{
    name: 'Jerry',
    age: 20
}]
app.get('/index', (req, res) => {
   res.render('index', {
       msg: '首页'
   });
}); 
app.get('/list', (req, res) => {
    res.render('list', {
        msg: '列表页'
    });
});
app.listen(3000); 
console.log('网站服务器启动成功');

<!-- index.art -->
<p>{{msg}}</p>
<ul>
    {{each user}}
    <li>
        <p>{{$value.name}}</p>
        <p>{{$value.age}}</p>
    </li>
    {{/each}}
</ul>

<!-- list.art -->
<p>{{msg}}</p>
<ul>
    {{each user}}
    <li>
        <p>{{$value.name}}</p>
        <p>{{$value.age}}</p>
    </li>
    {{/each}}
</ul>