express框架的学习与基本使用
1. 认识express框架
Express是一个基于Node平台的web应用开发框架，它提供了一系列的强大特性：
- 提供了方便简洁的路由定义方式
- 对获取HTTP请求参数进行了简化处理
- 对模板引擎支持程度高，方便渲染动态HTML页面
- 提供了中间件机制有效控制HTTP请求
- 拥有大量第三方中间件对功能进行扩展
以下为express框架的基本使用：
// 引入express框架
const express = require('express');
// 创建网站服务器
const server = express();
server.get('/', (req, res) => {
// send()方法能自动检测响应内容，自动设置http状态码，自动设置响应内容类型以及编码
res.send('hello,express!');
});
server.get('/index', (req, res) => {
res.send({ name: 'lxz', age: 22 });
});
server.listen(3000);
console.log('服务器启动成功');
2. express中间件
中间件就是一堆方法，可以接收客户端发来的请求、可以对请求做出响应，也可以将请求继续交给下一个中间件继续处理。中间件主要由两部分构成，中间件方法以及请求处理函数；中间件方法由Express提供，负责拦截请求，请求处理函数由开发人员提供，负责处理请求。
server.get() 以及 server.post()也是中间件
可以针对同一个请求设置多个中间件，对同一个请求进行多次处理。默认情况下，请求从上到下依次匹配中间件，一旦匹配成功，终止匹配。可以调用next方法将请求的控制权交给下一个中间件，直到遇到结束请求的中间件。
// 引入express框架
const express = require('express');
// 创建网站服务器
const server = express();
server.get('/index', (req, res, next) => {
req.name = '这是test file';
next();
});
server.get('/index', (req, res) => {
res.send(req.name);
});
server.listen(3000);
console.log('服务器启动成功');
server.use() 匹配所有的请求方式，可以直接传入请求处理函数，代表接收所有的请求。其中第一个参数也可以传入请求地址，代表不论什么请求方式，只要是这个请求地址就接收这个请求。
// 引入express框架
const express = require('express');
// 创建网站服务器
const server = express();
// 接收所有的请求不论请求方式以及地址
server.use((req, res, next) => {
console.log('从use经过');
next();
});
// 当地址为/index时，请求的方式可为post / get
server.use('/index', (req, res, next) => {
console.log('当地址为/index时');
next();
});
server.use('/list', (req, res) => {
res.send('This is list')
})
server.get('/index', (req, res, next) => {
req.name = '这是test file';
next();
});
server.get('/index', (req, res) => {
res.send(req.name);
});
server.listen(3000);
console.log('服务器启动成功');
中间件的应用场景有以下情况：
- 路由保护
- 自定义404页面
- 网站维护公告
const express = require('express');
const server = express();
// 用于网站维护
/* server.use((req, res, next) => {
res.send('网站正在维护中');
}) */
// 路由保护
server.get('/admin', (req, res, next) => {
let flag = true;
if (flag) {
next();
} else {
res.send('你没有登陆')
}
})
server.get('/admin', (req, res) => {
res.send('这是登陆成功以后的页面');
})
// 用于编辑404页面
server.use((req, res, next) => {
res.status(404).send('404
你访问的页面不存在');
})
server.listen(3000);
console.log('服务器已经成功启动');
在程序执行的过程中，不可避免的会出现一些无法预料的错误，比如文件读取失败，数据库连接失败。错误处理中间件是一个集中处理错误的地方。当程序出现错误时，调用next()方法，并且将错误信息通过参数的形式传递给next()方法，即可触发错误处理中间件。
// 错误处理中间件示例代码（同步API）
const express = require('express');
const fs = require('fs');
const server = express();
server.get('/index', (req, res, next) => {
// 通过throw抛出错误
// throw new Error('程序发生了未知错误');
fs.readFile('./1.txt', 'utf-8', (err, result) => {
if (err != null) {
// 将错误传递给下一个中间件
next(err);
} else {
res.send(result);
}
})
})
// 错误护理中间件
server.use((err, req, res, next) => {
// err.message 是错误的详情
res.status(500).send(err.message);
})
server.listen(3000);
console.log('服务器已经成功启动');
在node.js中，异步API的错误信息都是通过回调函数获取的，支持Promise对象的异步API发生错误可以通过catch方法捕获。try catch 可以捕获异步函数以及其他同步代码在执行过程中发生的错误，但是不能其他类型的API发生的错误。
// 捕获异步函数的错误
const express = require('express');
const fs = require('fs');
const promisify = require('util').promisify;
const readFile = promisify(fs.readFile); // 将fs.readFile处理成支持异步函数的方法
// 创建网站服务器
const server = express();
// try catch 能捕获异步函数以及同步函数的错误，但是无法捕获其他API的错误（promise)
server.get('/index', async(req, res, next) => {
try {
await readFile('./1.js')
} catch (err) {
next(err)
}
})
// 错误护理中间件(只能处理同步性的错误)
server.use((err, req, res, next) => {
// err.message 是错误的详情
res.status(500).send(err.message);
})
server.listen(3000);
console.log('服务器已经成功启动');
3. express的请求处理以及引擎模板
在express中为实现路由提供了模块化路由的构建：
/****************main.js**************/
const express = require('express');
// 创建服务器对象
const server = express();
// 引入二级路由
const home = require('./home.js');
const admin = require('./admin.js');
server.use('/home', home);
server.use('/admin', admin);
server.listen(3000);
console.log("服务器启动成功");
/****************admin.js**************/
const express = require('express');
const admin = express.Router();
admin.get('/index', (req, res) => {
res.send('欢迎来到admin页面');
})
module.exports = admin;
/****************admin.js**************/
const express = require('express');
const home = express.Router();
home.get('/index', (req, res) => {
res.send('欢迎来到home页面');
})
module.exports = home;
express框架中更是为了get参数以及post参数的获取提供了快捷的方法：
/********************get参数的获取***************/
// 引入express框架
const express = require('express');
// 创建网站服务器
const server = express();
// 在express框架中 req对象下拥有着qurey 可直接获取get方式传递的参数
server.get('/index', (req, res) => {
res.send(req.query);
})
// express路由参数 通过req.params获取
server.get('/other/:name/:age', (req, res) => {
res.send(req.params);
})
server.listen(3000);
console.log('服务器启动成功');
/********************post参数的获取***************/
// 引入express框架
const express = require('express');
// 引入body-parser模块
const bodyParser = require('body-parser');
// 创建网站服务器
const server = express();
// 拦截所有的请求
// 当extended: false 时方法内部使用querystring模块处理请求参数的格式
// 当extended: true 时方法内部使用第三方模块qs处理请求参数的格式
// 通过处理后req对象中拥有着body 获取通过post传递的参数
server.use(bodyParser.urlencoded({ extended: false }));
server.post('/index', (req, res) => {
res.send(req.body);
})
server.listen(3000);
console.log('服务器启动成功');
而对于静态资源的获取，express也提供了相应的方法:
// 实现静态资源的获取
server.use('/static',express.static(path.join(__dirname, 'public')))
// 获取了静态资源的获取，就能够自由的访问静态资源
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 server = express();
// 第一个参数时要渲染的后缀，第二个参数是选择什么搜索引擎进行渲染
server.engine('art', require('express-art-template'));
// 第一个参数是存放模板的目录名，第二个参数是存放模板的地址
server.set('views', path.join(__dirname, 'views'));
// 第一个参数配置默认模板配置项view engine,第二个参数为默认后缀
server.set('view engine', 'art');
server.get('/index', (req, res) => {
// render()方法能够自动拼接模板路径/拼接模板后缀/模板与数据之间的连接/并且自动响应给客户端
res.render('index', {
msg: '这是index'
})
})
server.get('/list', (req, res) => {
res.render('list', {
msg: '这是list'
})
})
server.listen(3000);
console.log("服务器启动成功");
有必要补充的是，在实际开发工程中经常有一些公共的数据需要提供给模板使用，为了避免代码冗余，.locals()方法因此诞生，存储于此方法下的代码可以在任何的模板下使用：
// server.locals中的数据可在所有的模板中使用
server.locals.users = [{
name: "abc",
age: "18"
}, {
name: "aaa",
age: "11"
}]