一、express 介绍
express 是一个基于 Node.js 平台的极简、灵活的 WEB 应用开发框架,官方网址:https://www.expressjs.com.cn/
简单来说,express 是一个封装好的工具包,封装了很多功能,便于我们开发 WEB 应用(HTTP 服务)
二、express 使用
2.1 express 下载
express 本身是一个 npm 包,所以可以通过 npm 安装
npm init
npm i express
2.2 express 初体验
可以按照这个步骤进行操作:
- 创建 JS 文件,键入如下代码
//1. 导入 express
const express = require('express');
//2. 创建应用对象
const app = express();
//3. 创建路由规则
app.get('/home', (req, res) => {
res.end('hello express server');
});
//4. 监听端口 启动服务
app.listen(3000, () =>{
console.log('服务已经启动, 端口监听为 3000...');
});
- 命令行下执行该脚本
node <文件名>
# 或者
nodemon <文件名>
- 然后在浏览器就可以访问
http://127.0.0.1:3000/home
三、express 路由
3.1 什么是路由
官方定义: 路由确定了应用程序如何响应客户端对特定端点的请求
3.2 路由的使用
一个路由的组成有 请求方法
, 路径
和 回调函数
组成
express 中提供了一系列方法,可以很方便的使用路由,使用格式如下:
app.<method>(path,callback)
代码示例:
// 1、导入express
const express = require('express')
// 2、创建应用对象
const app = express();
// 3、创建路由
app.get('/home', (req, res) => {
res.end('Welcome home')
})
app.get('/', (req, res) => {
res.end('Welcome')
})
// post
app.post('/login', (req, res) => {
res.end('Welcome login')
})
// 匹配所有方法
app.all('/test', (req, res) => {
res.end('Welcome test')
})
// 404 响应 托底
app.all('*', (req, res) => {
res.end('404 Not Found')
})
// 4、监听端口,启动服务
app.listen(9000, () => {
console.log('服务已启动,端口9000正在监听中...');
})
3.3 获取请求参数
express 框架封装了一些 API 来方便获取请求报文中的数据,并且兼容原生 HTTP 模块的获取方式
// 1、导入express
const express = require('express')
// 2、创建应用对象
const app = express();
// 3、创建路由
app.get('/request', (req, res) => {
// 1. 获取报文的方式与原生 HTTP 获取方式是兼容的
console.log(req.method);
console.log(req.url);
console.log(req.httpVersion);
console.log(req.headers);
// 2. express 独有的获取报文的方式
console.log(req.path);
console.log(req.query);
console.log(req.ip); // 获取ip
console.log(req.get('host')); // 获取请求头
res.end('Welcome')
})
// 4、监听端口,启动服务
app.listen(9000, () => {
console.log('服务已启动,端口9000正在监听中...');
})
3.4 获取路由参数
路由参数指的是 URL 路径中的参数(数据)
app.get('/:id.html', (req, res) => {
res.send('商品详情, 商品 id 为' + req.params.id);
});
练习
主文件
const express = require('express');
const { singers } = require('./singers.json')
const app = express();
app.get('/singer/:id.html', (req, res) => {
let { id } = req.params
let result = singers.find(item => {
return item.id === Number(id)
})
if (!result) {
res.statusCode = 404
res.end('<h1>404 Not Found</h1>')
return
}
res.end(
`
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Document</title>
</head>
<body>
<h1>${result.singer_name}</h1>
<img src="${result.singer_pic}" />
</body>
</html>
`
)
})
app.listen(9000, () => {
console.log('服务已启动,端口9000正在监听中...');
})
singers.json
{
"singers": [
{
"singer_name": "周杰伦",
"singer_pic": "http://y.gtimg.cn/music/photo_new/T001R150x150M0000025NhlN2yWrP4.webp",
"other_name": "Jay Chou",
"singer_id": 4558,
"id": 1
},
{
"singer_name": "林俊杰",
"singer_pic": "http://y.gtimg.cn/music/photo_new/T001R150x150M000001BLpXF2DyJe2.webp",
"other_name": "JJ Lin",
"singer_id": 4286,
"id": 2
},
{
"singer_name": "G.E.M. 邓紫棋",
"singer_pic": "http://y.gtimg.cn/music/photo_new/T001R150x150M000001fNHEf1SFEFN.webp",
"other_name": "Gloria Tang",
"singer_id": 13948,
"id": 3
},
{
"singer_name": "薛之谦",
"singer_pic": "http://y.gtimg.cn/music/photo_new/T001R150x150M000002J4UUk29y8BY.webp",
"other_name": "",
"singer_id": 5062,
"id": 4
},
{
"singer_name": "陈奕迅",
"singer_pic": "http://y.gtimg.cn/music/photo_new/T001R150x150M000003Nz2So3XXYek.webp",
"other_name": "Eason Chan",
"singer_id": 143,
"id": 5
}
}
四、express 响应设置
express 框架封装了一些 API 来方便给客户端响应数据,并且兼容原生 HTTP 模块的获取方式
//获取请求的路由规则
app.get("/response", (req, res) => {
//1. express 中设置响应的方式兼容 HTTP 模块的方式
res.statusCode = 404;
res.statusMessage = 'xxx';
res.setHeader('abc','xyz');
res.write('响应体');
res.end('xxx');
//2. express 的响应方法
res.status(500); //设置响应状态码
res.set('xxx','yyy');//设置响应头
res.send('中文响应不乱码');//设置响应体
//连贯操作
res.status(404).set('xxx','yyy').send('你好朋友')
//3. 其他响应
res.redirect('http://atguigu.com')//重定向
res.download('./package.json');//下载响应
res.json();//响应 JSON
res.sendFile(__dirname + '/home.html') //响应文件内容
});
五、express 中间件
5.1 什么是中间件
中间件(Middleware)本质是一个回调函数
中间件函数
可以像路由回调一样访问 请求对象(request)
, 响应对象(response)
5.2 中间件的作用
中间件的作用
就是 使用函数封装公共操作,简化代码
5.3 中间件的类型
- 全局中间件
- 路由中间件
5.3.1 定义全局中间件
每一个请求
到达服务端之后 都会执行全局中间件函数
声明中间件函数
let recordMiddleware = function(request,response,next){
//实现功能代码
//.....
//执行next函数(当如果希望执行完中间件函数之后,仍然继续执行路由中的回调函数,必须调用next)
next();
}
应用中间件
app.use(recordMiddleware);
声明时可以直接将匿名函数传递给 use
app.use(function (request, response, next) {
console.log('定义第一个中间件');
next();
})
练习
// 1、导入express
const express = require('express')
const fs = require('fs');
const path = require('path');
// 2、创建应用对象
const app = express();
// 声明中间件函数
function recordMiddleware(req, res, next) {
// 获取url和ip
let { url, ip } = req
// 将信息保存到access.log中
fs.appendFileSync(path.resolve(__dirname, './access.log'), `${url} ${ip}\r\n`)
next()
}
app.use(recordMiddleware)
// 3、创建路由
app.get('/home', (req, res) => {
res.send('前台首页')
})
app.get('/admin', (req, res) => {
res.send('后台首页')
})
app.all('*', (req, res) => {
res.send('404 Not Found')
})
// 4、监听端口,启动服务
app.listen(9000, () => {
console.log('服务已启动,端口9000正在监听中...');
})
5.3.2 多个全局中间件
express 允许使用 app.use() 定义多个全局中间件
app.use(function (request, response, next) {
console.log('定义第一个中间件');
next();
})
app.use(function (request, response, next) {
console.log('定义第二个中间件');
next();
})
5.3.3 定义路由中间件
如果 只需要对某一些路由进行功能封装
,则就需要路由中间件
调用格式如下:
app.get('/路径',`中间件函数`,(request,response)=>{
// ...
});
app.get('/路径',`中间件函数1`,`中间件函数2`,(request,response)=>{
// ...
});
练习
// 1、导入express
const express = require('express')
const fs = require('fs');
const path = require('path');
// 2、创建应用对象
const app = express();
// 3、创建路由
app.get('/home', (req, res) => {
res.send('前台首页')
})
let checkCodeMiddleware = (req, res, next) => {
if (req.query.code === '521') {
next()
} else {
res.send('参数错误')
}
}
app.get('/admin', checkCodeMiddleware, (req, res) => {
res.send('后台首页')
})
app.get('/setting', checkCodeMiddleware, (req, res) => {
res.send('设置页面')
})
app.all('*', (req, res) => {
res.send('404 Not Found')
})
// 4、监听端口,启动服务
app.listen(9000, () => {
console.log('服务已启动,端口9000正在监听中...');
})
5.4 静态资源中间件
express 内置处理静态资源的中间件
//引入express框架
const express = require('express');
//创建服务对象
const app = express();
//静态资源中间件的设置,将当前文件夹下的public目录作为网站的根目录
app.use(express.static('./public')); //当然这个目录中都是一些静态资源
//如果访问的内容经常变化,还是需要设置路由
//但是,在这里有一个问题,如果public目录下有index.html文件,单独也有index.html的路由,
//则谁书写在前,优先执行谁
app.get('/index.html',(request,response)=>{
respsonse.send('首页');
});
//监听端口
app.listen(3000,()=>{
console.log('3000 端口启动....');
});
注意事项:
- index.html 文件为默认打开的资源
- 如果静态资源与路由规则同时匹配,谁先匹配谁就响应
- 路由响应动态资源,静态资源中间件响应静态资源
5.5 获取请求体数据 body-parser
express 可以使用 body-parser
包处理请求体
第一步:安装
npm i body-parser
第二步:导入 body-parser 包
const bodyParser = require('body-parser');
第三步:获取中间件函数
//处理 querystring 格式的请求体
let urlParser = bodyParser.urlencoded({extended:false}));
//处理 JSON 格式的请求体
let jsonParser = bodyParser.json();
第四步:设置路由中间件,然后使用 request.body
来获取请求体数据
app.post('/login', urlParser, (request,response)=>{
//获取请求体数据
//console.log(request.body);
//用户名
console.log(request.body.username);
//密码
console.log(request.body.userpass);
response.send('获取请求体数据');
});
获取到的请求体数据:
[Object: null prototype] { username: 'admin', userpass: '123456' }
六、Router
6.1 什么是 Router
express 中的 Router 是一个完整的中间件和路由系统,可以看做是一个小型的 app 对象。
6.2 Router 作用
对路由进行模块化,更好的管理路由
6.3 Router 使用
创建独立的 JS 文件(homeRouter.js)
//1. 导入 express
const express = require('express');
//2. 创建路由器对象
const router = express.Router();
//3. 在 router 对象身上添加路由
router.get('/', (req, res) => {
res.send('首页');
})
router.get('/cart', (req, res) => {
res.send('购物车');
});
//4. 暴露
module.exports = router;
主文件
const express = require('express');
const app = express();
//5.引入子路由文件
const homeRouter = require('./routes/homeRouter');
//6.设置和使用中间件
app.use(homeRouter);
app.listen(3000,()=>{
console.log('3000 端口启动....');
})
七、EJS 模板引擎
7.1 什么是模板引擎
模板引擎是分离 用户界面和业务数据
的一种技术
7.2 什么是 EJS
EJS 是一个高效的 Javascript 的模板引擎
官网: https://ejs.co/
中文站:https://ejs.bootcss.com/
7.3 EJS 初体验
下载安装EJS
npm i ejs --save
7.4 EJS 常用语法
7.4.1 输出转义的数据到模板上
<%= code %>
//1.引入ejs
const ejs = require('ejs');
//2.定义数据
let person = ['张三','李四','王二麻子'];
//3.ejs解析模板返回结构
//<%= %> 是ejs解析内容的标记,作用是输出当前表达式的执行结构
let html = ejs.render(‘<%= person.join(",") %>’, {person:person});
//4.输出结果
console.log(html);
7.4.2 执行JS代码
<% code %>
- 列表渲染
主文件
const ejs = require('ejs');
//西游记
const xiyou = ['唐僧','孙悟空','猪八戒','沙僧'];
// EJS 实现
const fs = require('fs');
let html = fs.readFileSync('./西游.html').toString();
let result = ejs.render(html, {xiyou:xiyou});
console.log(result);
西游.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>西游四人组</title>
</head>
<body>
<h2>西游四人组</h2>
<ul>
<% xiyou.forEach(item => { %>
<li><%= item %></li>
<% }) %>
</ul>
</body>
</html>
- 条件渲染
主文件
/**
* 通过 isLogin 决定最终的输出内容
* true 输出『<span>欢迎回来</span>』
* false 输出『<button>登录</button> <button>注册</button>』
*/
// 导入 ejs
const ejs = require('ejs');
const fs = require('fs');
//变量
let isLogin = true;
//原生 JS
// if(isLogin){
// console.log('<span>欢迎回来</span>')
// }else{
// console.log('<button>登录</button> <button>注册</button>');
// }
//EJS 实现
//读取 HTML 内容
let html = fs.readFileSync('./home.html').toString();
let result = ejs.render(html, {isLogin: isLogin});
console.log(result);
home.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Document</title>
</head>
<body>
<header>
<% if(isLogin){ %>
<span>欢迎回来</span>
<% }else{ %>
<button>登录</button> <button>注册</button>
<% } %>
</header>
</body>
</html>
- 输出非转义的数据到模板上
<%- code %>