综合百科

express怎么使用

时间：2024-04-21 09:15:36

express

简介

Express 是基于 Node.js 平台，快速、开放、极简的 Web 开发框架。搭建web服务器

Express 的本质：就是一个 npm 上的第三方包，提供了快速创建 Web 服务器的便捷方法。

使用Express开发框架可以非常方便、快速的创建Web网站的服务器或API接口的服务器

官方网址：https://www.expressjs.com.cn/

简单使用

下载安装：

npminit-ynpmiexpress-S

使用步骤：

  1. 导入包

  2. 创建服务器

  3. 处理请求

  4. 监听端口

constexpress=require('express')constapp=express()app.get(路由,回调)//get是请求方法app.listen(端口号)

路由方法

请求方法还支持：

get - 查询请求 - 条件在地址栏

post - 新增请求 - 数据在请求主体

put - 修改请求 - 条件在地址栏 - 数据在请求主体

delete - 删除请求 - 条件在地址栏

各个动词方法用来处理对应的请求。不过有一个方法除外：

app.all()//可以用来处理任意请求方式

虽然all方法可以处理任意请求，但是尽量少用，甚至尽量不要使用。

使用postman进行调试

路由路径

完全匹配

//匹配根路径的请求app.get('/',function(req,res){res.send('root');});//匹配/about路径的请求app.get('/about',function(req,res){res.send('about');});//匹配/random.text路径的请求app.get('/random.text',function(req,res){res.send('random.text');});

不完全匹配

//匹配acd和abcdapp.get('/ab?cd',function(req,res){res.send('ab?cd');});//匹配abcd、abbcd、abbbcd等app.get('/ab+cd',function(req,res){res.send('ab+cd');});//匹配abcd、abxcd、abRABDOMcd、ab123cd等app.get('/ab*cd',function(req,res){res.send('ab*cd');});//匹配/abe和/abcdeapp.get('/ab(cd)?e',function(req,res){res.send('ab(cd)?e');});

字符 ?、+、* 和 () 是正则表达式的子集，- 和 . 在基于字符串的路径中按照字面值解释。

正则匹配：

//匹配任何路径中含有a的路径：app.get(/a/,function(req,res){res.send('/a/');});//匹配butterfly、dragonfly，不匹配butterflyman、dragonflyman等app.get(/.*fly$/,function(req,res){res.send('/.*fly$/');});

路由多次处理

使用一个回调函数处理路由：

app.get('/example/a',function(req,res){res.send('HellofromA!');});

多次处理：

app.get('/example/b',function(req,res,next){console.log('这处理完之后会交给下一个函数处理');next();},function(req,res){res.send('HellofromB!');});

使用回调函数数组处理路由：

varcb0=function(req,res,next){console.log('CB0')next()}varcb1=function(req,res,next){console.log('CB1')next()}varcb2=function(req,res){res.send('HellofromC!')}app.get('/example/c',[cb0,cb1,cb2])

混合使用函数和函数数组处理路由：

varcb0=function(req,res,next){console.log('CB0')next()}varcb1=function(req,res,next){console.log('CB1')next()}app.get('/example/d',[cb0,cb1],function(req,res,next){console.log('responsewillbesentbythenextfunction...')next()},function(req,res){res.send('HellofromD!')})

响应方法

res.download()//提示下载文件。res.end()//终结响应处理流程。res.json()//发送一个JSON格式的响应。res.jsonp()//发送一个支持JSONP的JSON格式的响应。res.redirect()//重定向请求。res.render()//渲染视图模板。res.send()//发送各种类型的响应。res.sendFile()//以八位字节流的形式发送文件。res.sendStatus()//设置响应状态代码，并将其以字符串形式作为响应体的一部分发送。

download示例：

//响应下载-res.download(被下载的源文件,下载后的文件名称,回调函数)res.download("./test.html",'b.html',err=>{if(err){console.log("下载失败");}else{console.log("下载成功");}})

json示例：

//给客户端响应json数据//res.json(json格式的数据)letobj={name:"张三",age:12,wife:"翠花",children:['阿大','阿二','小明']}res.json(obj)

jsonp示例：

//给客户端发起的jsonp请求做响应，响应的是json数据//res.jsonp(json格式的数据)letobj={name:"张三",age:12,wife:"翠花",children:['阿大','阿二','小明']}res.jsonp(obj)

redirect示例：

//res.redirect()用来跳转路由的-/a这个路由，其实/b这个路由就正好可以处理他，就可以在/a这个路由处理中，将这次请求交给/b这个路由去处理res.redirect('/index')app.get('/index',(req,res)=>{letdata=fs.readFileSync('./test.html')res.end(data)})

send示例：

//res.send()-用于给客户端响应字符串的-字符串中如果是标签，可解析成html-自动设置数据类型和编码lethtml=`<h3>这是一个h3标签</h3>`//res.end不会自动设置数据类型，也不会设置编码//res.end(html)res.send(html)

sendFile示例：

//res.sendFile()用于给客户端响应一个文件res.sendFile(__dirname+'/test.html')

sendStatus示例：

//sendStatus是自动设置响应状态码，并将对应的响应状态描述响应给客户端res.sendStatus(404)//响应notfoundres.sendStatus(200)//响应ok

请求对象的属性

req.url//请求的路径-如果有?传参，这个路径中也会带有参数req.method//请求方法req.path//请求路径-如果有?传参，这个路径中不包含参数req.protocol//协议req.params//获取get请求的参数-针对动态路由传参-restful风格的参数-最终获取到的是对象，对象的键，就是路径指定的名称req.query//获取get请求的参数-针对传统形式传参-使用?参数-最终获取到的是对象

静态资源托管

express提供了一个非常好用的方法，叫做 express.static()，通过此方法，可以非常方便地创建一个静态web资源服务器：

app.use(express.static('public'))//app.use()表示使用（中间件）//现在可以访问public目录下所有的文件//如public/aa.jpg文件，则可以通过:http://xxxx/images/aa.jpg

express还支持给静态资源文件创建一个虚拟的文件前缀（实际上文件系统中并不存在），可以使用 express.static 函数指定一个虚拟的静态目录，就像下面这样：

前缀的使用意义：

  • 可以迷惑别人，一定程度上阻止别人猜测我们服务器的目录结构

  • 可以帮助我们更好的组织和管理静态资源

app.use('/static',express.static('public'))

前缀前面的“/”必须要加，否则就错。【404】

现在你可以使用 /static 作为前缀来加载 public 文件夹下的文件了：

http://localhost:3000/static/images/kitten.jpghttp://localhost:3000/static/css/style.csshttp://localhost:3000/static/js/app.jshttp://localhost:3000/static/images/bg.pnghttp://localhost:3000/static/hello.html

使用app.use()方法一般写在具体的路由监听之前。

每个应用可有多个静态目录。

app.use(express.static('public'))app.use(express.static('uploads'))app.use(express.static('files'))

路由

介绍

路由在生活中如拨打服务电话时，按数字几能处理什么样的处理，它就是类似于按键与服务之间的映射关系。在Express中，路由指的就是客户端发起的请求（地址）与服务器端处理方法（函数）之间的映射关系。

express中的路由分3部份组成，分别是请求类型（方法）、请求uri（地址）和对应的处理函数。

当一个客户端请求到达服务端之后，先经过路由规则匹配，只有匹配成功之后，才会调用对应的处理函数。在匹配时，会按照路由的顺序进行匹配，如果请求类型和请求的 URL 同时匹配成功，则 Express 会将这次请求，转交给对应的函数进行处理。

app.<get/post/put/delete/use>(uri,(req,res)=>{})//use方法并不是请求类型方法，但是它放的位置与请求方法一致

路由模块化

含义：将原本可能写在一个文件中的路由规则，拆分成若干个路由文件（js文件，一个js文件就是一个模块）。

顾名思义，将路由进行模块化，以模块（js文件）为单位进行管理，物以类聚。

核心思想：能拆就拆（拆到不能拆为止，解耦，高内聚，低耦合）。

在开发项目时，如果将所有的路由规则都挂载到入口文件中，程序编写和维护都变得更加困难。所以express为了路由的模块化管理功能，通过express.Router()方法创建路由模块化处理程序，可以将不同业务需求分开到不同的模块中，从而便于代码的维护和项目扩展。

步骤：

  1. 指定那个路径开头的请求，用app.use(路径开头,处理模块)

    app.use('/admin',adminRouter)///admin开头的请求路径，交给adminRouter模块处理app.use('/front',frontRouter)///front开头的请求路径，交给frontRouter模块处理

  2. 这个模块未定义，定义这个模块

    let{adminRouter}=require('./admin/admin')let{frontRouter}=require('./front/front')

  3. 导入的文件还未定义，创建文件

    constexpress=require('express')constadminRouter=express.Router()//创建路由对象//通过路由对象处理剩余的请求adminRouter.get('/goods',(req,res)=>{res.send('这是admin模块的goods页面')})//导出模块module.exports={adminRouter}

此时，我们又两种方案去处理请求：

  • app.get/post/use …

  • express.Router().get/post …

  • app.route(路径).get/post()

同一个请求路径使用不同的请求方法多次请求的简写：

app.route('/book').get(function(req,res){res.send('Getarandombook');}).post(function(req,res){res.send('Addabook');}).put(function(req,res){res.send('Updatethebook');});

中间件

中间件（middleware）可以理解为业务流程的中间处理环节，可以理解成中间过滤器。

中间件的分类

中间件可以分类可分如下几类：

  • 内置中间件，也就是express本身自带无需npm安装

    • express.static()

  • 第三方中间件

    非 Express 官方内置的，而是由第三方开发出来的中间件，叫做第三方中间件。在项目中可以通过npm进行安装第三方中间件并配置，从而提高项目的开发效率。例如body-parser （解析post数据的）此中间件可以很方便帮助我们获取到post提交过来的数据。

  • 自定义中间件，开发者自己编写的（中间件的本质其实就是一个function）

如果从使用层面去考虑，中间件可以划分为：

  • 应用级别中间件（通过app.get/post/use等方法绑定到app实例的中间件）

    • app.请求方法(地址,[中间件…,]回调函数)

    • app.请求方法(地址,中间件1,中间2,中间3…,]回调函数)

    • app.use(中间件)

    • 全局使用中间件（所有路由都生效）

    • 局部使用中间件（当前路由生效）

  • 路由级别中间件（绑定到express.Router()上的中间件）

    • router.use(中间件)

    • router.请求方法(地址,[中间件…,]回调函数)

    • 其用法与应用级别的中间件没有任何区别，只是一个绑在app实例上，一个绑在router上

内置中间件

express提供了好用的内置中间件，如提供一个静态资源管理的中间件，通过此中间件就可以帮助为我们快速搭建一个静态资源服务器：

app.use('前缀',express.static('托管目录地址'))

在express中，除了内置的express.static()中间件，还内置了另外2个常用的中间件：

  • express.json()

    使用示例：

    //有了这个中间件以后，我们可以从客户端给服务器端发送json数据，这个json数据会放到请求对象req的body属性上app.use(express.json())app.post('/p1',(req,res)=>{//express.json中间件可以让数据挂在req的body属性上console.log(req.body);res.send('thisp1requestisended')})

    首先必须是post请求，然后必须有数据，但是数据不能是以前的 x-www-form-urlencoded这样的数据，必须是raw的数据

    然后请求头的content-type 必须是 application/json

    • 作用：接收json格式提交的数据

    • 兼容性问题：express >= 4.16.0

    • app.use(express.json())

    • 其在接收完数据后，会将数据的对象形式挂载到req请求对象的body属性上

  • express.urlencoded()

    • 作用：处理post表单数据

    • 兼容性问题：express >= 4.16.0

    • app.use(express.urlencoded({extended: false}))

    • 其在接收完数据后，会将数据的对象形式挂载到req请求对象的body属性上

注意，

  • 后面提及的这2个常用内置中间件存在兼容性问题。

  • 上述2个中间件都说把数据处理之后挂到req.body上，但是实际上并不会出现我们想的覆盖的问题。

案例：使用json、urlencoded中间件来接收json数据与表单post数据，发送可以通过postman来进行

自定义中间件

自定义中间件，其本质就是定义一个处理请求的函数，只是此函数中除了有request和response参数外还必须包含一个next参数，此参数作用让中间件能够让流程向下执行下去直到匹配到的路由中发送响应给客户端。也可以通过给request对象添加属性来进行中间件数据的向下传递

functionmfn(req,res,next){//.自己需要定义的逻辑流程//中间件最后一定要执行此函数，否则程序无法向下执行下去next()}

注意：在整个请求链路中，所有中间件与最终路由共用一份req和res

案例：依据上述的共用特性，自定义一个中间件来接收post提交的表单数据（意义：内置那中间件是不是存在兼容性问题）

第三方中间件

在express中，其允许我们使用第三方的中间件来进行对数据进行处理。比较典型的例如：可以使用第三方中间件来接收post数据。

以使用body-parser中间件来接收post数据为例，步骤如下：

  • 安装三方中间件body-parser

    • npm i -S body-parser

  • 应用文件中导入body-parser

  • 通过中间件调用 app.use(body.urlencoded({extended: false}))

  • 在匹配的路由中通过req.body获数post中数据

    • Express内置的express.urlencoded中间件，就是基于body-parser这个第三方中间件进一步封装出来的。但内置的有版本兼容问题，所以一般项目选择安装使用第三方的中间件

在使用的时候，body-parser库的语法与前面看的express内置的express.urlencoded中间件的语法非常相似，原因是内置中间件是基于body-parser来实现的。

其他第三方中间件：http-proxy-middleware/cors/cookie-session …

异常处理中间件

**作用：**专门用来捕获整个项目发生的异常错误，从而防止项目异常崩溃的问题产生（友好显示异常）。

**格式：**错误级别中间件的函数参数中，必须有四个形参，分别是(err,req,res,next)

问：多出来的err参数有什么作用呢？

答：里面包含了错误的信息，err.message属性中就包含了错误的文本信息，这个信息可以在中间件中输出给用户看。

app.get('/',(req,res)=>{thrownewError('服务器内部发生了致命的错误！')res.send('Welcometomyhomepage')})app.use((err,req,res,next)=>{console.log('发生了错误：'+err.message)res.send('Error！'+err.message)})

**案例：**要求指定一个路径（可能路由对应的文件不存在），读取文件内容，输出给用户

注意事项：错误级别中间件要想发挥其作用，必须写在所有的路由的后面，是否是app.listen之前无所谓。

404中间件

**作用：**用于处理404的请求响应

//假设定义这个路由，但是实际请求的时候请求了/12345，这个时候就会404app.post("/1234",(req,res,next)=>{res.send('你请求成功了')});//404的输出//该中间件也需要写在最后（与异常中间件的顺序无所谓，只要确保其在所有的路由方法之后就可）app.use((req,res,next)=>{//输出404错误res.status(404).send('<h2>404</h2>')//先指定404状态码，然后再输出错误信息})

404错误中间件也要求在所有的正常请求路由的后面去声明使用，不要放在路由的前面，否则会导致后面的路由都是404错误。

**注意点：**错误级别的中间件，必须在所有路由之后注册，至于404中间件与异常中间件，谁先谁后无所谓。

模板页面：页面：https://404.life/

其他模块

cookie

cookie的原理是在浏览器中开辟了一个用来存储http请求中的数据，第一次保存之后，下次请求只要还是使用的当前浏览器，就能访问到浏览器这个空间中的数据。

cookie会作为键值对，在响应头和请求头之间携带。

cookie的特点：

  1. 域名限制，当前域名下设置的cookie，只能在当前域名下使用

  2. 时效性，cookie不会永久存储在浏览器，具有一定的有效期

  3. 数量限制，正常情况下，每个域名最多不能超过50个cookie

  4. 空间限制，cookie只能存储4kb

  5. 数据类型限制，cookie中只能存储字符串

npmicookie-parser-S

使用：

//导入constcookieParser=require('cookie-parser')//中间件app.use(cookieParser());//请求头获取req.headers.cookie//获取所有cookie//响应头设置res.cookie(键,值,{maxAge:有效期-毫秒})//设置cookie

session

cookie是存储在浏览器的，所以安全性不高，所以一些重要数据就不能存储在cookie中，且cookie的存储空间有限制，所以就有了session。

session是存储服务器端的，session需要依赖cookie，session数据存储会在cookie中存放一个sessionid，这个sessionid会跟服务器端之间产生映射关系，如果sessionid被篡改，他将不会跟服务器端进行隐射，因此安全系数更高。且session的有效期比较短。通常是20分钟左右，如果浏览器在20分钟内没有跟服务器进行交互，服务器就会删除session数据。

npmicookie-session-S

使用：

//导入：constsession=require('cookie-session')//session配置session({name:"sessionId",secret:"asdfasdfqwer",//给sessioinId加密使用的秘钥，随便填写maxAge:20*60*1000//20分钟})//设置sessionreq.session[键]=值//获取sessionreq.session[键]

加密

npmibcryptjs-S

使用：

varbcrypt=require('bcryptjs');//加密密文=bcryptjs.hashSync(明文[,数字]);//数字，将使用指定的轮数生成盐并将其使用。推荐10//验证bcryptjs.compareSync(明文,密文);//通过返回true，失败返回false

jwt

npminstalljsonwebtoken

使用：

//加密生成tokenvarjwt=require('jsonwebtoken');vartoken=jwt.sign(被加密的对象,盐);//验证jwt.verify(token,盐,function(err,decoded){//decoded是解密后的对象});

文件上传

npmimulter-S

使用：

varmulter=require('multer')varupload=multer({dest:path.join(__dirname,'public','image')})//指定上传的文件路径app.post('/profile',upload.single('上传表单name值'),function(req,res,next){//req.file是上传的文件信息-可以从中获取到文件名称、路径、后缀-拼接路径存入mongodb})

mysql

npmimysql-S

使用：

//导入constmysql=require("mysql");//创建连接对象constdb=mysql.createConnection({host:"localhost",user:"root",password:"root",database:"test"});//连接db.connect(err=>{if(err){console.log("连接失败，错误："+err);return;}console.log("连接成功");});//执行语句db.query("",(err,result)=>{if(err){console.log("失败，错误："+err);return;}console.log("成功");console.log(result);});

验证码

npmisvg-captcha-S

使用：

constsvgCaptcha=require('svg-captcha')//创建验证码letcaptcha=svgCaptcha.create();//captcha是是一个对象，其中包含data键和text键，text是验证码上的字符，data是一个svg标签直接可以显示为一张图片

邮件发送

npminstallnodemailer--save

使用：

constnodemailer=require('nodemailer')//1.创建发送器consttransport=nodemailer.createTransport({//需要你发送放邮箱的stmp域名和密码和一些其他信息//需要你去复制一下,找到下载的nodemailer第三方包//nodemailer->lib->well-known->services.json"host":"smtp.qq.com","port":465,"secure":true,//证明你的身份auth:{//发送方邮箱的用户名user:'邮箱号',//stmp允许密码pass:'授权码'}})//2.发送邮件transport.sendMail({//从那个邮箱发送from:'发送方邮箱',//发送到哪里,可以写一个字符串,书写邮箱,也可以写一个数组,写好多邮箱to:['接收方邮箱','接收方邮箱'],//邮件标题subject:'标题',//本次邮件的超文本内容html:`您好:本次的验证码是<h2style="color:red;">2345</h2>请在3分钟内使用<br>------------------------<br>前途无限股份有限公司`,//本次邮件的文本内容//text:''},function(err,data){if(err)returnconsole.log(err)console.log('邮件发送成功')console.log(data)})

模板引擎

介绍

在一个web应用程序中，如果只是使用服务器端代码来编写客户端html代码，前后端不分离，那么会造成很大的工作量，而且写出来的代码会比较难以阅读和维护。如果只是使用客户端的静态的HTML文件，那么后端的逻辑也会比较难以融入到客户端的HTML代码中。为了便于维护，且使后端逻辑能够比较好的融入前端的HTML代码中，同时便于维护，很多第三方开发者就开发出了各种Nodejs模板引擎，其中比较常用的就是Jade/Pug、Ejs和art-template 等模板引擎。

目的：使后端逻辑能够比较好的融入前端的HTML代码中，同时便于维护

art-template 是一个简约、超快的模板引擎。

开发模式：
传统开发模式：
前端代码和后端代码写在了一起
混合在了一起，但是这种文件有要求，文件通常都是后端语言的文件中才能写后端的逻辑 - 这样的话，对于我们前端攻城狮特别不友好，因为我们前端攻城狮负责html页面，但是在html页面中不能写后端的逻辑，如果将html页面放在后端的文件中，我们又需要学习后端语言
此时，模板引擎出现了 - 模板引擎其实就是让我们可以在html页面中书写后端的逻辑 - 循环/判断 …
模板引擎有很多种：jade/ejs/art-tamplate …

模板引擎最终能在html中写逻辑，相当于我们代码前后端混合在一起的一种语法，最终为什么能被浏览器所识别？因为浏览器在识别之前，我们的模板引擎需要进行编译 - html代码
前后端分离开发模式：
html一个人去写；
后端接口另一个人去写；
双方之间对接，使用接口文档
html上所有的数据，都是通过ajax请求回来，并通过dom操作显示在页面中的

模板引擎渲染速度测试：

特性

  • 拥有接近 JavaScript 渲染（DOM操作）极限的的性能（快）

  • 调试友好：语法、运行时错误日志精确到模板所在行；支持在模板文件上打断点（Webpack Loader）

  • 支持 Express、Koa、Webpack

  • 支持模板继承（布局）与子模板（引入包含）

  • 浏览器版本仅 6KB 大小

使用

下载安装：

#安装npmi-Sart-templateexpress-art-template

配置：

//模板引擎配置//指定art-template模板，并指定模块后缀为.htmlapp.engine('html',require('express-art-template'));//指定模板视图路径app.set('views',path.join(__dirname,'views'));//省略指定模块文件后缀后名称（可选，在渲染时可以省略的后缀）app.set('viewengine','html')

art-template 支持**标准语法与原始语法**。标准语法可以让模板易读写，而原始语法拥有强大的逻辑表达能力。标准语法支持基本模板语法以及基本 JavaScript 表达式；原始语法支持任意 JavaScript 语句，这和 Ejs一样。

  • 使用art-template展示一个视图（html文件）

    • 将视图放入views目录下（允许分目录）

    • 编写代码，展示视图的方式是`res.redner(文件的路径)

      app.get('/',(req,res)=>{//输出视图res.render('404.html')})

  • 控制层返回数据（在js控制层中赋值变量到视图中）

    app.get(uri,(req,res)=>{res.render(模板,{username:'张三',age:25,gender:'女',hobby:['篮球','乒乓球','羽毛球']})})

模板语法

变量输出：

<!--标准语法-->{{username}}<!--或者--><!--原始语法--><%=username%>

在默认情况下，上述输出方式不能将带有HTML标记的内容让浏览器解析，只会原样输出。如果需要将HTML标记让浏览器，则请使用下述方式输出数据：

<!--标准语法-->{{@username}}<!--原始语法--><%-username%>

条件判断：

{{if条件}}…{{elseif条件}}…{{/if}}<%if(条件){%>…<%}elseif(条件){%>…<%}%>

循环：

<!--支持数组和对象的迭代默认元素变量为$value下标为$index可以自定义{{eachtargetvalkey}}-->{{each循环的数据}}{{$index}}{{$value}}{{/each}}{{each循环的数据valkey}}{{key}}{{val}}{{/each}}<%for(vari=0;i<target.length;i++){%><%=i%><%=target[i]%><%}%>

如果使用默认的键、值的名字（index,value）则其前面的$一定要写！一定要写！！！

如果使用的自定义的键、值的名字，则前面的$一定不能写！！不能写！！

模板导入：

{{include'被引入文件路径'}}<%include('被引入文件路径')%>

  • 如果是当前路径下的一定要写./，不写则从磁盘根下开始寻找

  • 被include的文件后缀名默认为.art，如果不是请勿省略

  • 在子模板中最好不要有html、head和body标签（否则容易出现样式错误的问题）

模板继承：

被继承的模板：

<html><head><metacharset="utf-8"><!--类似于vue的插槽--><title>{{block'title'}}MySite{{/block}}</title></head><body><!--block占位符content此占位的名称-->{{block'content'}}{{/block}}</body></html>

需要继承的子模板：

<!--extend继承-->{{extend'./layout.html'}}{{block'title'}}首页{{/block}}{{block'content'}}<p>Thisisjustanawesomepage.</p>{{/block}}

关于“express怎么使用”的内容就介绍到这里了，感谢大家的阅读。

本文标签： express怎么用