Express.js

笔记 Javascript 前端

Express.js

1.1 什么是express

1.1.1 能做什么

对于前端程序员来说，最常见的两种服务器，分别是：

WEB网站服务器：专门对外听web网页资源的服务器
API接口服务器：专门对外提供api接口的服务器

可以快速创建web网站服务器和api接口服务器

1.1.2 安装expres

npm i express@4.17.2

1.2 创建最基本的web服务器

// 1.导入express
const express = require('express');
// 2.创建web服务器
const app = express()

//3. 调用app.listen(端口号，启动成功后的回调函数)，启动服务器
app.listen(8090,()=>{
    console.log('express server running at http://127.0.0.1:8090');
})

1.2.3监听GET请求

//参数1：客户端请求的URL地址
//参数2：请求对应的处理函数
// req:请求对象（包含了与请求相关的属性和方法）
// res:响应对象(包含了与响应相关的属性和方法)
app.get('请求URL',function(req,res){/*处理函数*/})

1.2.4 监听POST请求

通过app.post()方法，可以监听客户端的post请求，具体语法格式

1.2.5 把内容响应给客户端

通过res.send()方法，可以把处理好的内容，发送给客户端

// 1.导入express
const express = require('express');
// 2.创建web服务器
const app = express();


//参数1：客户端请求的URL地址
//参数2：请求对应的处理函数
// req:请求对象（包含了与请求相关的属性和方法）
// res:响应对象(包含了与响应相关的属性和方法)
app.get('/index',(req,res)=>{
//    向客户端发送json对象
    res.send({name:'meowrain',age:20,gender:'男'})
})
app.post('/query',(req,res)=>{
    // 向客户端发送文本内容
    res.send('请求成功')
})

//3. 调用app.listen(端口号，启动成功后的回调函数)，启动服务器
app.listen(8090,()=>{
    console.log('express server running at http://127.0.0.1:8090');
})

1.2.6 获取URL中携带的查询参数

通过req.query对象，可以访问到客户端通过查询字符串的形式。发送到服务器的参数

app.get('/',(req,res)=>{
    //req.query默认是一个空对象
    // 客户端使用?name=zs&age=20对象访问到
    //req.query.name req.query.age
    console.log(req.query.name);
    console.log(req.query.age);
    console.log(req.query);
    
})

1.2.7 获取URL中的动态参数

通过req.params对象，可以访问到URL中，通过:匹配到的动态参数

// 1.导入express
const express = require('express');
// 2.创建web服务器
const app = express();


//参数1：客户端请求的URL地址
//参数2：请求对应的处理函数
// req:请求对象（包含了与请求相关的属性和方法）
// res:响应对象(包含了与响应相关的属性和方法)
app.get('/user/:id',(req,res)=>{
    // URL地址中，可以通过:参数名的形式，匹配动态参数值
    console.log(req.params);
    res.send(req.params);
    // req.params是动态匹配到的url参数，默认也是一个空对象

})
app.post('/query',(req,res)=>{
    // 向客户端发送文本内容
    res.send('请求成功')
})

//3. 调用app.listen(端口号，启动成功后的回调函数)，启动服务器
app.listen(8090,()=>{
    console.log('express server running at http://127.0.0.1:8090');
})

1.3 托管静态资源

1.3.1 express.static()

express提供了一个非常好用的函数，叫做express.static()，通过它，我们可以非常方便地创建一个静态资源服务器。

例如：通过如下代码就可以将public目录下的图片，CSS文件，Javascript文件对外开放访问了

const express = require('express');
const app = express();
app.use(express.static('login-bg'))//填写静态网站目录
app.listen(8090,()=>{
    console.log('express server running at http://127.0.0.1:8090');
})

1.3.2 托管多个静态资源目录

如果要托管你多个静态资源目录，要多次调用express.static()函数

const express = require('express');
const app = express();
app.use('/blog',express.static('login-bg'));
app.use('/index',express.static('index'));
app.listen(8090,()=>{
    console.log('express server running at http://127.0.0.1:8090');
})

如上，两次使用app.use即可托管朵儿静态资源目录

访问静态资源文件时，express.static()函数会根据目录的添加顺序查找所需的文件

像上面这串代码，我们就可以通过访问 http://127.0.0.1:8090/blog 来访问login-bg这个文件夹里面的网页内容

通过访问 http://127.0.0.1:8090/index来访问index文件夹里面的网页内容

1.4 Express路由

1.4.1 什么是路由

广义上来讲，路由就是映射关系

在express中，路由指的就是客户端的请求和服务器处理函数之间的映射关系

express的路由分3部分组成，分别是

请求的类型，请求的url地址，处理函数，格式如下

1.4.2 express路由中的例子

const express = require('express');
const app = express();
//匹配GET请求，且请求URL为 /
app.get('/', (req, res) => {
    res.send('hello world');
})
// 匹配POST请求，且请求URL为 /
app.post('/',(req,res)=>{
    res.send('GOT A POST REQUEST');
})

app.listen(8090, () => {
    console.log("port 8090 is listening,server running");
})

如上，get和post是请求的类型，/是请求的Url地址，后面是处理函数。像这样的代码，叫做express路由

1.4.3 路由的匹配过程

每当一个请求到达服务器之后，需要先经过路由的匹配，只有匹配成功之后，才会调用对应的处理函数

在匹配时，会按照路由的顺序进行匹配，如果请求类型和请求的url同时匹配成功，则express会将这次请求，转交给对应的function函数进行处理

1.4.4 模块化路由

为了方便对路由进行模块化的管理，express不建议将路由直接挂载到app上，而是推荐把路由抽离为单独的模块

将路由抽离为单独模块的步骤如下：

创建路由模块对应的js文件
调用express.Router()函数创建路由对象
向路由对象上挂载具体的路由
使用module.exports向外共享路由对象
使用app.use()函数注册路由模块

创建路由模块

const express = require('express');
const app = express();
var router = express.Router() //创建路由对象

router.get('/user/list',(req,res)=>{ //挂载获取用户列表的路由
    res.send('get user list')
})

router.post('/user/add',(req,res)=>{ // 挂载添加用户的路由
    res.send('add new user') 
})

module.exports = router //向外导出路由对象

1.4.5 注册和使用路由模块

const express = require('express');
const app = express();
//1. 导入路由模块
const router = require('./router/router.js');

// 2. 使用app.use()注册路由模块
app.use(router);

app.listen(8090, () => {
    console.log("port 8090 is listening,server running");
})

注意：app.use()函数的作用，就是来注册全局中间件

Express中间件

中间件，特指业务流程的中间处理环节

1.1 Express中间件的调用流程

当一个请求到达express的服务器之后，可以连续调用多个中间件，从而对这次请求进行预处理

1.2 express中间件的格式

express的中间件，本质上就是一个function处理函数

格式如下：

中间件函数的形参列表中，必须包含next参数，而路由处理函数中只包含req和res.

1.2.1 next函数的作用

next函数是实现多个中间件连续调用的关键，它表示把流转关系转交给下一个中间件或路由

1.2.2 定义中间件函数

可以通过如下方式，定义一个最简单的中间件函数；

const express = require('express')
const app = express()

// 常量mw所指向的，就是一个中间件函数
const mw = function(req,res,next) {
    console.log('这是一个最简单的中间件函数');
    //注意： 在当前中间件的业务处理完毕后必须调用next()函数
    //表示把流转关系转交给下一个中间件或路由
    next()
}

app.listen(8090, () => {
    console.log("port 8090 is listening,server running");
})

1.2.3 全局生效的中间件

客户端发起的任何请求，到达服务器后，都会触发的中间件，叫做全局生效的中间件，通过调用app.use(中间件函数)，即可定义一个全局生效的中间件

const express = require('express')
const app = express()

// 常量mw所指向的，就是一个中间件函数
const mw = (req,res,next)=> {
    console.log('这是一个最简单的中间件函数');
    //注意： 在当前中间件的业务处理完毕后必须调用next()函数
    //表示把流转关系转交给下一个中间件或路由
    next()
}
 
// 将mw注册为全局生效的中间件
app.use(mw);

app.get('/',(req,res)=>{
    res.send('home page')
})
app.get('/user',(req,res)=>{
    res.send('user page')
})

app.listen(8090, () => {
    console.log("port 8090 is listening,server running");
})

1.2.4 定义全局中间件的简化形式

const express = require('express')
const app = express()

// 常量mw所指向的，就是一个中间件函数
// const mw = (req,res,next)=> {
//     console.log('这是一个最简单的中间件函数');
//     //注意： 在当前中间件的业务处理完毕后必须调用next()函数
//     //表示把流转关系转交给下一个中间件或路由
//     next()
// }
 
// 将mw注册为全局生效的中间件
app.use((req,res,next)=>{
    console.log('这是最简单的中间件函数');
    next();
});

app.get('/',(req,res)=>{
    res.send('home page')
})
app.get('/user',(req,res)=>{
    res.send('user page')
})

app.listen(8090, () => {
    console.log("port 8090 is listening,server running");
})

1.2.5 中间件的作用

多个中间件之间，共享同一份req和res，基于这样的特性，我们可以在上游的中间件中，统一为req或res对象添加自定义的属性或方法，供下游的中间件或者路由进行使用

案例：

const express = require('express')
const app = express()

app.use((req, res, next) => {
    //获取到请求到达服务器的时间
    const time = new Date();
    console.log('这是最简单的中间件函数');
    //为req对象，挂载自定义属性，从而把时间共享给后面的所有路由
    req.startTime = time;
    next();
});

app.get('/', (req, res) => {
    res.send(`you are visiting the home page.The time is ${req.startTime} `)
})
app.get('/user', (req, res) => {
    res.send('user page')
})

app.listen(8090, () => {
    console.log("port 8090 is listening,server running");
})

1.2.6 定义多个全局中间件

可以使用app.use()连续定义多个全局中间件。客户端请求到达服务器之后，会按照中间件定义的先后顺序依次进行调用，示例代码如下：

const express = require('express')
const app = express()

app.use((req, res, next) => { //第一个全局中间件
    //获取到请求到达服务器的时间
    console.log('这是第一个中间件函数');
    next();
});

app.use((req,res,next)=>{//第二个全局中间件
    console.log('这是第二个中间件函数');
    next();
})

app.use((req,res,next)=>{ //第三个全局中间件
    console.log('这是第三个中间件函数');
    next();
})


app.get('/', (req, res) => {
    res.send(`you are visiting the home page.The time is ${req.startTime} `)
})
app.get('/user', (req, res) => {
    res.send('user page')
})

app.listen(8090, () => {
    console.log("port 8090 is listening,server running");
})

1.2.7 局部生效的中间件

不使用app.use()定义中间件，叫做局部生效的中间件，示例如下：

const express = require('express')
const app = express()

const mw = (req, res, next) => { //第一个全局中间件
    //获取到请求到达服务器的时间
    console.log('这是第一个中间件函数');
    next();
}



app.get('/', mw, (req, res) => {
    res.send(`you are visiting the home page.The time is ${req.startTime} `)
})
app.get('/user', (req, res) => {
    res.send('user page')
})

app.listen(8090, () => {
    console.log("port 8090 is listening,server running");
})

mw这个中间件值在当前路由中生效，这种用法属于局部生效的中间件

mw这个中间件不会影响下面的路由

1.2.8 错误级别的中间件

错误级别中间件的作用：专门用来捕获整个项目中发生的异常错误，从而防止项目异常崩溃问题

格式：错误级别中间件的function处理函数汇总，必须有4个形参，形参顺序从前到后，分别是(err,req,res,next)

错误级别中间件的使用；

const express = require('express')
const app = express()

app.get('/', (req, res) => { //1.路由
    throw new Error('服务器内部发生错误'); // 抛出一个自定义的错误
    res.send('Home page');
})
app.use((err, req, res, next) => { // 错误级别的中间件
    console.log('发生了错误' + err.message); //在服务器打印错误消息
    res.send('erro' + err.message);
})
app.listen(8090, () => {
    console.log("port 8090 is listening,server running");
})

如果觉得文章对你有用，请随意赞赏

express.js