目录
express框架
express介绍
express使用
express路由
express 响应设置
中间件
路由模块化
EJS 模板引擎
express-generator
hello,大家好!上一篇文章我们介绍了Node.js的模块化以及包管理工具等知识,这篇文章主要给大家分享Node.js中的express框架!
express框架
express介绍
在上几篇文章中我们介绍了如何使用http模块去搭建http请求,而在实际的开发中却很少直接使用它去搭建服务。一般都会借助express框架去进行开发。express 是一个基于 Node.js 平台的极简、灵活的 WEB 应用开发框架,官方网址:https://www.expressjs.com.cn/ express 相当于是一个封装好的工具包,封装了很多功能,便于我们开发 WEB 应用(HTTP 服务)。
express使用
express 本身是一个 npm 包,所以我们可以通过 npm 来进行安装。先对文件进行初始化:npm i,然后再使用npm i express来进行安装express。它的基本使用如下,通过node(nodemon) index.js执行文件之后,我们在浏览器通过访问:http://127.0.0.1:9000/home来进行访问结果。
//导入express
const express=require('express');
//创建应用对象
const app=express();
//创建get请求
app.get('/home',(req,res)=>{
res.end('hello express');
});
//监听端口
app.listen(9000,()=>{
console.log('服务启动!')
})
express路由
有学习过vue的小伙伴对路由应该不陌生,express中的路由也是同样的道理,通过访问不同的路径来得到不同的模块,在此之前我们是通过判断语句来实现访问不同路径返回对应内容的。而路由能够更加简便地来实现相应的功能。
一个路由包括请求的方法,请求的路径以及回调函数三个部分组成。回调函数接收请求的对象以及相应的对象两个参数。使用all可以适用于所有的请求方式,而路径使用 * 一般用于处理请求路径匹配不到的错误。
//导入express
const express=require('express');
//创建应用对象
const app=express();
//创建get请求
app.get('/home',(req,res)=>{
res.end('hello express');
});
//创建post请求
app.post('/login',(req,res)=>{
res.end('login success');
});
//首页路由
app.get('/',(req,res)=>{
res.end('home');
})
//匹配所有请求方法
app.all('/search',(req,res)=>{
res.end('all req');
})
//定义404路由
app.all('*',(req,res)=>{
res.end('<h1>404 Not Found</h1>')
})
//监听端口
app.listen(9000,()=>{
console.log('服务启动!')
})
我们仍然可以使用express来获取到请求报文中的数据。express 框架封装了一些 API 来方便获取请求报文中的数据,并且兼容原生 HTTP 模块的获取方式。它除了具有原生的method、url、httpVersion以及headers等操作以外,它还可以直接使用req.path来得到请求的路径,以及req.query来得到查询的数据,并且是以对象形式输出。调用get()方法还可以直接传入自己想要的特定响应头进行输出。
//导入express
const express=require('express');
//创建应用对象
const app=express();
//创建get请求
app.get('/request',(req,res)=>{
//原生操作
console.log(req.method);//GET
console.log(req.url);///request?name=N-A
console.log(req.httpVersion);//1.1
console.log(req.headers);
//express操作
console.log(req.path);///request
console.log(req.query);//{ name: 'N-A' }
//获取ip
console.log(req.ip);//::ffff:127.0.0.1
//获取特定的请求头
console.log(req.get('host'));//127.0.0.1:9000
res.end('hello express');
});
//监听端口
app.listen(9000,()=>{
console.log('服务启动!')
})
路由参数的获取对我们很重要,我们需要通过用于输入的不同的路由参数来匹配出不同的数据,但如果我们一个一个去添加路由规则的话是不现实的。这时候我们可以使用路由参数,在传参的位置我们使用一个占位符,:字符串。字符串的位置在发请求时随意写什么都可以进行匹配到。同时我们可以使用req.params.id来获取我们的路由参数,通过判断获取到的路由参数来返回不同的结果。
//导入express
const express=require('express');
//创建应用对象
const app=express();
//创建路由
app.get('/:id.html',(req,res)=>{
console.log(req.params.id);
res.end('goods detail');
})
//监听端口
app.listen(9000,()=>{
console.log('服务启动!')
})
可能有点难理解,我们来做一个小练习体验一下吧!现在有个需求,通过用于在浏览器输入不同的请求路径,在json文件中会匹配到对应的数据进行展示。先将两个水果的数据放在一个json文件中,然后当用于输入http:127.0.0.1:9000/friut/1.html时在页面上显示id为1的水果的描述以及图片,http:127.0.0.1:9000/friut/2.html时显示id为2的水果。
//json文件
{
"friut":[
{
"id":1,
"name": "沃盼(WOPAN)四川眉山脐橙新鲜水果橙子2kg 4斤装",
"dicPrice": "¥19.9",
"oriPrice": "¥50",
"src":"https://ts1.cn.mm.bing.net/th/id/R-C.efa51c1248bc80a2bd2bc9a1c2449fad?rik=f%2f53DOukVylGvg&riu=http%3a%2f%2fn.sinaimg.cn%2fsinakd20210207s%2f296%2fw1030h866%2f20210207%2f09f4-kirmaiu8306791.jpg&ehk=eTr6szTDThqmZdwt5x3V45f%2b%2bRNJFsDuBjDBLFY99fY%3d&risl=&pid=ImgRaw&r=0"
},
{
"id":2,
"name": "智利原装进口车厘子礼盒装JJ级 约2kg 果径约28-30mm 原箱礼盒装 新鲜水果",
"dicPrice": "¥219",
"oriPrice": "¥299",
"src":"https://img.zcool.cn/community/0165435d9c740da801211d530e7b5e.jpg@1280w_1l_2o_100sh.jpg"
}
]
}
//index.js
//导入express
const express = require('express');
//导入json文件
const { friut } = require('./data.json');
//创建应用对象
const app = express();
//创建路由
app.get('/friut/:id.html', (req, res) => {
//获取路由参数
let { id } = req.params;
//在数组中寻找对应的id的数据
let result = friut.find(item => {
if (item.id === Number(id)) {
return true;
}
});
//判断
if(!result){
res.statusCode=404;
res.end(`<h1>404 Not Found</h1>`)
}
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>
<h2>${result.name}</h2>
<img src="${result.src}"/>
</body>
</html>
`);
})
//监听端口
app.listen(9000, () => {
console.log('服务启动!')
})
要点就是通过获取到路由的参数来进行相应数据的寻找以及匹配。
express 响应设置
express可以对相应的数据进行相应的设置,框架封装了一些 API 来方便给客户端响应数据,并且兼容原生 HTTP 模块的获取方式。主要有res.status( )用于设置状态码,res.set()用于设置响应头,res.send()用于设置响应体,使用该方法设置响应体会自动将响应体中的内容转为utf-8的格式,直接写入中文不会出现乱码,因此无需再进行响应头的设置。同时几个方法还可以进行连贯操作。
const express=require('express');
const app=express();
app.get('/response',(req,res)=>{
//原生响应设置
res.statusCode=404;
res.statusMessage='Not Find';
res.setHeader('name','N-A');
res.write('hello');
res.end('response');
//express响应
res.status(200);
res.set('name','N-A');
res.send('你好呀')
res.status(200).set('name','N-A').send('你好呀');
});
app.listen(9000,()=>{
console.log('服务已经启动!');
})
同时express还可以进行其他的响应设置,比如跳转响应、下载响应、JSON响应、响应文件的内容等。具体的实现效果自行实践。
const express=require('express');
const app=express();
app.get('/response',(req,res)=>{
//跳转响应
res.redirect('https://baidu.com');
//下载响应
res.download(__dirname+'./data.json');
//JSON响应
res.json({
name:'N-A',
study:'Node.js'
})
//响应文件内容
res.sendFile(__dirname+'/index.html')
});
app.listen(9000,()=>{
console.log('服务已经启动!');
})
中间件
中间件(Middleware)本质是一个回调函数中间件函数可以像路由回调一样访问 请求对象(request) , 响应对象(response)。它的作用就是使用函数封装公共操作,对代码进行简化。它包括:全局中间件以及路由中间件。全局中间件每一个请求到达服务端之后都会执行全局中间件函数,而路由中间件只对某一些路由进行功能的封装。
全局中间件的实例如下,全局中间件函数三个参数,req,res以及next。next用于接续执行。使用中间件需要调用app.use()。
const express=require('express');
const app=express();
const fs=require('fs');
const path=require('path');
//声明中间件函数
function recordMiddleware(req,res,next){
let {url,ip}=req;
//将信息保存在文件中
fs.appendFileSync(path.resolve(__dirname,'./access.log'),`${url} ${ip}\r\n`);
next();
}
//使用中间件函数
app.use(recordMiddleware);
app.get('/home',(req,res)=>{
res.send('首页')
});
app.get('/detail',(req,res)=>{
res.send('详情页')
});
app.listen(9000,()=>{
console.log('服务已经启动!');
})
路由中间件的实例如下,无需关注具体实现的功能,主要认识路由中间件如何使用,后续要实现什么功能,函数里面替换成对应的操作即可。它的使用方式与全局中间件不一样。它需要到对应的路由中进行添加。
const express=require('express');
const app=express();
const fs=require('fs');
const path=require('path');
//声明中间件函数
function checkCodeMiddleware(req,res,next){
if(req.query.code==='521'){
next();
}else{
res.send('错误');
}
}
app.get('/home',checkCodeMiddleware,(req,res)=>{
res.send('首页')
});
app.get('/detail',checkCodeMiddleware,(req,res)=>{
res.send('详情页')
});
app.all("*",(req,res)=>{
res.send('<h1>404</h1>')
})
app.listen(9000,()=>{
console.log('服务已经启动!');
})
静态资源来前几篇文章我们已经有介绍到了,对于静态资源的处理也是比较麻烦,需要获取对应文件的后缀名来判断该文件属于哪一种资源,再做相应的处理。而静态资源中间件可以大大地提高我们处理静态资源的效率。使用方式如下:
//引入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为默认打开的资源,如果静态资源与路由规则同时匹配,谁先匹配谁就响应。路由响应动态资源,静态资源中间件响应静态资源。
最后我们再介绍一个中间件:body-parser。express可以使用这个中间件来进行处理请求体。首先需要使用:npm i body-parser 进行安装。然后需要导入body-parser包,再获取中间件函数,最后是使用 request.body 来获取请求体数据。
我们以一个实例来展示吧,假设我们通过get请求来向本地的/login路径发请求,显示表单网页,通过post请求访问/login来获取表单中的用户名以及密码。
//index.html
<!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>
<form action="/login" method="post">
用户名:<input type="text" name="username"><br/>
密码 :<input type="password" name="password"><br/>
<button>登录</button>
</form>
</body>
</html>
//导入express
const express=require('express');
//导入body-parser包
const bodyParser = require('body-parser');
//创建应用对象
const app=express();
//处理 JSON 格式的请求体
//let jsonParser = bodyParser.json();
//处理 querystring 格式的请求体
let urlParser = bodyParser.urlencoded({extended:false});
//创建路由规则
app.get('/login',(req,res)=>{
res.sendFile(__dirname+'/index.html');
});
//post规则
app.post('/login',urlParser,(req,res)=>{
console.log(req.body);
res.send(req.body)
})
//监听端口
app.listen(9000,()=>{
console.log('服务启动!')
})
路由模块化
当什么需要对多个路由进行设置时,都在主文件中进行设置就会非常乱,维护起来也不是很好,因此express引入了Router,它可以实现路由的模块化,更好地进行管理路由。express 中的 Router 是一个完整的中间件和路由系统,可以看做是一个小型的 app 对象。
//创建单独的管理文件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(9000,()=>{
console.log('服务已经启动');
})
EJS 模板引擎
EJS 是一个高效的 Javascript 的模板引擎,模板引擎是分离 用户界面和业务数据 的一种技术。简单地将就是它能够实现我们的html文件以及js文件分离。上面那个路由跳转不同水果的案例我们就把html中的文件写到了js里面。因此使用EJS模板引擎可以让两者进分开。
首先我们需要使用:npm i ejs --save来进行安装。它是将变量名使用<%= 变量名 %>的形式包裹起来的。那具体怎么样体现它的分离效率呢?
<!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>
<h2><%= name %>今天学习<%= study %></h2>
</body>
</html>
//导入EJS
const ejs=require('ejs');
const fs=require('fs');
//字符串
let name='N-A';
let study='Node.js'
//声明变量
let str=fs.readFileSync('./index.html').toString();
//使用ejs渲染
let result=ejs.render(str,{name,study});
console.log(result);
这样就可以完全将两者进行拆分,后续想要修改或者增加都是可以实现的。
下面再来演示EJS模块列表的渲染以及条件的渲染。都是使用<% %>将内容或者操作包裹在里面,然后变量仍然使用<%= %>来进行包裹。
//进行列表的渲染
<!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>
<ul>
<% study.forEach(item=>{ %>
<li><%= item %></li>
<% })%>
</ul>
</body>
</html>
//导入EJS
const ejs=require('ejs');
const fs=require('fs');
const study=['Node.js','Vue.js','ES6','Webpack']
//声明变量
let str=fs.readFileSync('./index.html').toString();
//使用ejs渲染
let result=ejs.render(str,{study});
console.log(result);
//输出
<!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>
<ul>
<li>Node.js</li>
<li>Vue.js</li>
<li>ES6</li>
<li>Webpack</li>
</ul>
</body>
</html>
下面展示条件渲染:
<!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>
<% if(isLogin) { %>
<span>欢迎回来</span>
<% }else{ %>
<span>请登录</span>
<% } %>
</body>
</html>
//导入EJS
const ejs=require('ejs');
const fs=require('fs');
let isLogin=true;
//声明变量
let str=fs.readFileSync('./index.html').toString();
//使用ejs渲染
let result=ejs.render(str,{isLogin});
console.log(result);
//当isLogin为true是会输出欢迎回来,当为false时会显示请登录
那express如何使用EJS模板引擎呢?首先需要设置模板引擎,其次要设置模板文件的存放位置,然后通过render()方法来做响应,该方法接受两个参数:模板的文件名以及数据。最后再去设置的相应位置下去创建模板文件,后缀应该是.ejs。
//index.js
//导入express
const express=require('express');
const app=express();
const path=require('path');
//设置模板引擎
app.set('view engine','ejs');
//设置模板文件的存放位置
app.set('views',path.resolve(__dirname,'./views'));
app.get('/home',(req,res)=>{
//render响应
let name='N-A';
res.render('home',{name});
res.end('hello express');
})
//监听端口
app.listen(9000,()=>{
console.log('服务启动!')
})
<!-- home.ejs -->
<!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><%= name %></h1>
</body>
</html>
express-generator
在我们练习的过程中express框架的代码都是我们一点一点写的,但是在实际的开发中会非常地低效,而express官方提供了一个工具express-generator,可以帮助我们快速搭建应用的骨架。
首先我们使用npm install -g express-generator命令来进行安装。然后可以通过express -h来查看它的相关命令。我们选择ejs模板引擎来进行创建。输入expres -e 文件名。创建之后先对文件进行初始化,npm init 以及npm i。之后运行npm start 打开3000端口,看到如下图片则表示成功!
创建之后的文件内容可以自己研究研究,这里就不做过多的解释!
好了,本文就好这里结束啦!感谢阅读~~