nodejs - Express
1. Express框架简介及初体验
1.1 Express框架是什么
Express是一个基于Node平台的web应用开发框架，它提供了一系列的强大特性，帮助你创建各种web应用。
我们可以使用
npm install express命令进行下载。
1.2 Express框架特性
- 提供了方便简洁的路由定义方式
- 对获取HTTP请求参数进行了简化处理
- 对模板引擎支持程度高，方便渲染动态HTML页面
- 提供了中间件机制有效控制HTTP请求
- 拥有大量第三方中间件对功能进行扩展
1.3 原生Node.js与Express框架对比之路由
app.on('request', (req, res) => {
//获取客户端的请求路径
let {pathname} = url.parse(req.url);
//对请求路径进行判断不同的路径地址响应不同的内容
if (pathname == '/' | | pathname == ' index') {
res.end('欢迎来到首页');
} else if (pathname == '/list') {
res.end('欢迎来到列表页页');
} else if (pathname == ' /about') {
res.end('欢迎来到关于我们页面')
} else {
res.end('抱歉您访问的页面出游了');
}
});
//当客户端以get方式访问/时
app.get('/', (req, res) => {
//对客户端做出响应
res.send('Hello Express');
});
//当客户端以post方式访问/add路由时
app.post('/add', (req, res) => {
res.send('使用post方式请求了/add路由');
});
1.4 原生Node.js与Express框架对比之获取请求参数
app.on('request'，(req, res) => {
//获取GET参数
let {query} = url.parse(req.url, true);
//获取POST参数
let postData = ' ';
req.on('data',(chunk) => {
postData += chunk;
});
req.on('end', () => {
console.log(querystring.parse(postData)
}));
});
app.get('/',(req, res) => {
//获取GET参数
console.1og(req.query);
});
app.post('/',(req, res) => {
//获取POST参数
console.log(req.body);
})
1.5 入门案例
//引入express框架
const express = require('express');
//创建网站服务器
const app = express();
app.get('/', (req,res) =>{
// send()方法
// 1.send方法内部会检测响应内容的类型
// 2.send方法会自动设置http状态码
// 3.send方法会帮我们自动设置响应的内容类型及编码
res.send('Hello Express!');
})
app.get('/list',(req,res) =>{
//send方法可以传入json对象
res.send({name:'张三',age:'18'});
})
//监听端口
app.listen(80);
console.log('网站服务器启动成功！');
2. 中间件
2.1 什么是中间件
中间件就是一堆方法，可以接收客户端发来的请求、可以对请求做出响应,也可以将请求继续交给下一个中间件继续处理。
中间件主要由两部分构成，中间件方法以及请求处理函数。
中间件方法由Express提供，负责拦截请求，请求处理函数由开发人员提供，负责处理请求。
app.get('请求路径','处理函数') //接收并处理get请求
app.post('请求路径',' 处理函数') //接收并处理post请求
可以针对同一一个请求设置多个中间件，对同一个请求进行多次处理。
默认情况下，请求从上到下依次匹配中间件，一旦匹配成功，终止匹配。
可以调用next方法将请求的控制权交给下一个中间件，直到遇到结束请求的中间件。
app.get('/request', (req, res, next) => {
req.name = "张三";
next();
});
app.get('/request', (req, res) => {
res.send(req.name);
});
2.2 app.use中间件用法
app.use匹配所有的请求方式，可以直接传入请求处理函数，代表接收所有的请求。
app.use((req, res, next) => {
console.log(req.ur1);
next();
});
app.use第一个参数也可以传入请求地址,代表不论什么请求方式，只要是这个请求地址就接收这个请求。
app.use(' /admin', (req, res, next) => {
console.log(req.url);
next();
});
2.3 中间件应用
- 路由保护，客户端在访问需要登录的页面时，可以先使用中间件判断用户登录状态，用户如果未登录，则拦截请求,直接响应，禁止用户进入需要登录的页面。
- 网站维护公告，在所有路由的最上面定义接收所有请求的中间件，直接为客户端做出响应，网站正在维护中。
- 自定义404页面
//自定义404，放到所有请求方法最后
app.use((req,res,next) => {
//status 为客户端响应状态码
res.status(404).send('当前页面不存在');
});
2.4 错误处理中间件
在程序执行的过程中，可避免的会出现一些无法预料的错误， 比如文件读取失败，数据库连接失败。
错误处理中间件是一个集中处理错误的地方。
app.get('/', (req, res) => {
throw Error('程序发生未知错误');
})
//错误处理中间件
app.use((err,req,res,next) => {
res.status(500).send(err.message);
});
当程序出现错误时，调用next()方法，并且将错误信息通过参数的形式传递给next()方法，即可触发错误处理中间件。
app.get('/', (req, res,next) => {
//throw Error('程序发生未知错误');
fs.readFile('./demo.txt',(err,data) => {
if(err){
next(err);
}
})
})
2.5 捕获错误
在node.js中，异步API的错误信息都是通过回调函数获取的，支持Promise对象的异步API发生错误可以通过catch方法捕获。
异步函数执行如果发生错误要如何捕获错误呢?
try catch可以捕获异步函数以及其他同步代码在执行过程中发生的错误，但是不能其他类型的API发生的错误。
app.get("/", async (req, res, next) => {
try {
await User.find({
name: '张三'
})
} catch (ex) {
next(ex);
}
});
3. Express请求处理
3.1 构建模块化路由
const express = require('express');
//创建网站服务器
const app = express();
//创建路由对象
const home = express.Router();
//为路由对象匹配请求路径
app.use('/home',home);
//创建二级路由
home.get('/index', (req,res)=>{
// /home/index
res.send('欢迎来到博客首页');
});
//监听端口
app.listen(80);
console.log('网站服务器启动成功！');
多模块构建：
const express = require('express');
//创建网站服务器
const app = express();
const home = require('./route/home');
const admin = require('./route/admin');
//为路由对象匹配请求路径
app.use('/home', home);
app.use('/admin',admin);
//创建二级路由
home.get('/index', (req,res)=>{
// /home/index
res.send('欢迎来到博客首页');
});
//监听端口
app.listen(80);
console.log('网站服务器启动成功！');
const express = require('express');
//admin.js
const admin = express.Router();
admin.get('/index',(req,res) =>{
res.send('欢迎来到博客管理界面');
});
module.exports = admin;
const express = require('express');
//home.js
const home = express.Router();
home.get('/index',(req,res) =>{
res.send('欢迎来到博客首页界面');
});
module.exports =home;
3.3 GET参数的获取
Express框架中使用req.query即可获取GET参数，框架内部会将GET参数转换为对象并返回。
//接受地址栏中问号后面的参数
//例如：http//localhost/index?name=zhangsan&age=18
app.get('/index', (req,res)=>{
// /home/index
res.send(req.query);
});
3.4 POST参数的获取
Express中接收post请求参数需要借助第三方包body-parser.
//拦截所有请求
//extended:false 方法内部使用querystring模块处理请求参数的格式
//extended：true 方法内部使用第三方模块qs处理请求参数的格式
app.use(bodyParser.urlencoded({extended:false}));
app.post('/add',(req,res) =>{
//接受post请求参数
res.send(req.body);
});
说明：app.use方法里面调用返回的函数相当于：
app.use(fn ({a:1}))
function fn(obj){
return function(req,res,next){
if(obj.a == 1){
console.log(req.url);
}else{
console.log(req.method);
}
next();
}
}
这样做的好处是：调用fn函数同时，可以传递一些额外的参数进行判断，改变请求处理的行为
3.5 Express路由参数
app.get('/find/:id', (req, res) => {
res.send(req.params);//{id:123}
})
http://localhost/find/123
说明：如果传递多个参数，可以在后面继续添加，如：/find/:id/:name/:age
3.6 静态资源的处理
通过Express内置的express.static可以方便地托管静态文件，例如img、CSS、JavaScript 文件等。
app.use(express.static('public'));
//app.use(express.static(path.join(__dirname, 'public')));
//也可以为静态资源添加一个虚拟路径
//app.use('/static', express.static(path.join(__dirname, 'public')));
//访问路径如：http://localhost/static/images/kitten.jpg
现在，public目录下面的文件就可以访问了。
http://localhost/images/kitten.jpg
http://localhost/css/style.css
http://localhost/js/app.js
http://localhost/images/bg.png
http://localhost/hello.html
4. express-art-template模板引擎
模板引擎
- 为了使art-template模板引擎能够更好的和Express框架配合，模板引擎官方在原art-template模板引擎的基础上封装了express-art-template。
- 使用
npm install art-template express-art-template命令进行安装。
//当渲染后缀为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('/', (req, res) => {
//渲染模板,第二个可选参数为json对象，为渲染的数据
res. render('index');
});
app.locals 对象
将变量设置到app.locals对象下面，这个数据在所有的模板中都可以获取到。
app.locals.users = [{
name: '张三',
age: 20
}, {
name: '李四',
age: 20
}]
5. cookie与session
cookie：浏览器在电脑硬盘中开辟的一块空间，主要供服务器端存储数据。
-
cookie中的数据是以域名的形式进行区分的。
-
cookie中的数据是有过期时间的，超过时间数据会被浏览器自动删除。
-
cookie中的数据会随着请求被自动发送到服务器端。
session：实际上就是一个对象，存储在服务器端的内存中，在session对象中也可以存储多条数据，每一条数据都有一个sessionid做为唯一标识。
在node.js中需要借助express-session实现session功能。
const session = require('express-session');
app.use(session({ secret: 'secret key' }));
admin.post('/login', (req, res) =>{
//将用户名存储在请求对象中
req.session.username = user.username;
}
admin.post('/user', (req, res) =>{
//获取用户名
console.log(req.session.username);
}
session中的secret储存一个密钥，这个密钥可以自定义，用于服务端存储cookie时进行加密，服务器接受cookie时进行解密，储存在客户端的cookie是加密后的，不知道密码无法解密，提高数据安全性
