Node.js入门指南（四）

本文介绍: 这篇文章主要给大家分享Node.js中的express 框架！欢迎交流学习！

express框架

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(node mon) index.js 执行文件之后，我们在浏览器通过访问：http://127.0.0.1:9000/home来进行访问结果。

//导入express
const express=require('express');
//创建应用对象
const app=express();
//创建get请求
app.get('/home',(req,res)=&gt;{
    res.end('hello express');
});
//监听端口
app.listen(9000,()=&gt;{
    console.log('服务启动！')
})

express路由

有学习过vue的小伙伴对路由应该不陌生，express中的路由也是同样的道理，通过访问不同的路径来得到不同的模块，在此之前我们是通过判断语句来实现访问不同路径返回对应内容的。而路由能够更加简便地来实现相应的功能。

一个路由包括请求的方法，请求的路径以及回调函数三个部分组成。回调函数接收请求的对象以及相应的对象两个参数。使用 all可以适用于所有的请求方式，而路径使用 * 一般用于处理请求路径匹配不到的错误。

//导入express
const express=require('express');
//创建应用对象
const app=express();
//创建get请求
app.get('/home',(req,res)=&gt;{
    res.end('hello express');
});
//创建post请求
app.post('/login',(req,res)=&gt;{
    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&amp;riu=http%3a%2f%2fn.sinaimg.cn%2fsinakd20210207s%2f296%2fw1030h866%2f20210207%2f09f4-kirmaiu8306791.jpg&amp;ehk=eTr6szTDThqmZdwt5x3V45f%2b%2bRNJFsDuBjDBLFY99fY%3d&amp;risl=&amp;pid=ImgRaw&amp;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}rn`);
    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端口，看到如下图片则表示成功！