Node.js(五、express中间件)

1、Express框架简介

1.1、Express框架是什么

Express是一个基于Node平台的web应用开发框架,它提供了一系列的强大特性,帮助你创建各种Web应用。我们可以使用npm install express命令进行下载。

1.2、Express框架特性

  • 提供了方便简洁的路由定义方式。
  • 对获取HTTP请求参数进行简化处理。
  • 模板引擎支持程度高,方便渲染动态HTML页面。
  • 提供了中间件机制有效控制HTTP请求
  • 拥有大量第三方中间件对功能进行扩展。

1.3、Express框架基本使用

// 引入Express框架
const express = require('express')
// 使用框架创建服务器
const app = express()
app.get('/', (req, res) => {
    
    
    // 对客户端做出响应。
    // 1、send方法内部会检测响应内容的类型。
    // 2、send方法会自动设置http状态码
    // 3、send方法会帮助我们自动设置响应内容的类型及编码。
    res.send('lgg')
})

// 监听80端口
app.listen(80)

2、Express中间件

2.1、什么是中间件

中间件就是一堆方法,可以接受客户端发来的请求,可以对请求做出响应,也可以将请求继续交给下一个中间件继续处理。

  • 中间件主要由两部分构成中间件方法以及请求处理函数
  • 中间件方法由Express提供,负责拦截请求,请求处理函数由开发人员提供,负责处理请求。
// get、post中间件
app.get('请求路径', '处理函数') // 接受并处理get请求
app.post('请求路径', '处理函数') // 接受并处理post请求
  • 可以针对同一个请求设置多个中间件,对同一请求进行多次处理。
  • 默认情况下,请求从上到下依次匹配中间件,一旦匹配成功,终止匹配。
  • 可以调用next方法将请求的控制权交给下一个中间件,直到遇到结束请求的中间件。
app.get('/request', (req, res, next) => {
    
    
    req.name = 'lgg'
    next() // 交由下一个中间件处理
})
app.get('/request', (req, res, next) => {
    
    
    res.send(req.name)
})

2.2、app.use中间件用法

app.use匹配所有的请求方式,可以直接传入请求处理函数,代表接受所有的请求。

app.use((req, res, next) => {
    
    
    console.log(req.url)
    next()
})

app.use第一个参数也可以传入请求地址,代表不论什么请求方式,只要是这个请求地址就接受这个请求。

app.use('/list', (req, res, next) => {
    
    
    console.log(req.url)
    next()
})

2.3、中间件应用

  1. 路由保护,客户端在访问需要登录的页面时,可以先使用中间件判断用户登录状态,用户未登录,则拦截请求,直接响应,禁止用户进入需要登录的页面。
  2. 网站维护公告,在所有路由的最上面定义接受所有请求的中间件,直接为客户做出响应,网站正在维护中。
// 写在最前面
// app.use((req, res, next) => {
    
    
//     res.send('网站维护中……')
// })
  1. 自定义404页面8。
// 写在最后
app.use((req, res, next) => {
    
    
    // // 为客户端响应404状态码以及提示信息
    // res.status(404)
    // // 但是状态码不是400
    // res.send('当前访问的页面不存在')
    // 可以链式调用
    res.status(404).send('当前访问的页面不存在')
})

2.4、错误处理中间件

在程序执行的过程中,不可避免的会出现一些无法预料的错误,比如文件读取失败,数据库连接失败。错误处理中间件是一个集中处理错误的地方。

// 引入express框架;先安装 npm install express
const express = require('express');
const fs = require('fs')
// 创建网站服务器
const app = express()
 
app.use('/list', (req, res, next) => {
    
    
    // 1、同步代码出错
    // throw new Error('程序发生未知错误') // 同步代码 // Error是nodejs的内置构造函数,创建Error构造函数的实例就相当于创建了一个错误,然后抛出错误使用关键字throw, 然后会自动执行错误处理中间件
    // res.send('list')

    // 2、异步代码出错
    fs.readFile('/demo.index', 'utf8', (err, result) => {
    
    
        if (err != null) {
    
    
            next(err)
        } else {
    
    
            res.send(result)
        }
    })
    
})

// 错误处理中间件(只能主动的捕获到同步代码出错,异步代码出错捕获不到,需要手动调用next(err)把错误传进去)
app.use((err, req, res, next) => {
    
    
    res.status(500).send(err.message)
})

// 监听端口
app.listen(80)

2.5、捕获错误

在nodejs中,异步API的错误信息都是通过回调函数(next)获取的,支持Promise对象的异步API发生错误可以通过catch方法捕获。异步函数执行如果发生错误如何捕获错误呢?

  • try catch可以捕获异步函数以及其他同步代码在执行过程中发生的错误。但是不能捕获其他类型的API发生的错误
// 引入express框架;先安装 npm install express
const express = require('express');
const fs = require('fs')
const promisify = require('util').promisify
const readFile = promisify(fs.readFile) // 改造成返回 Promise 实例的方法

// 创建网站服务器
const app = express()
 
app.use('/list', async (req, res, next) => {
    
     // 加async变成异步函数

    // fs.readFile('/demo.index', 'utf8', (err, result) => { // 依赖回调的异步函数,要改造成返回 Promise 实例的方法
    //     if (err != null) {
    
    
    //         next(err)
    //     } else {
    
    
    //         res.send(result)
    //     }
    // })
    try {
    
    
    //   const val = await readFile('/demo1.html')
      const val = await readFile('./03错误处理中间件.js')
      res.send(val)
    } catch(err) {
    
    
        next(err)
    }
    
})

// 错误处理中间件(只能主动的捕获到同步代码出错,异步代码出错捕获不到,需要手动调用next(err)把错误传进去)
app.use((err, req, res, next) => {
    
    
    res.status(500).send(err.message)
})

// 监听端口
app.listen(80)
  • primisify的使用
// 一、只要符合 Node.js 的回调风格,所有函数都可以转换。即promisify的使用满足两个条件即可
// 1、最后一个参数是函数。
// 2、回调函数的参数为(err, result)
 const util = require('util');
const fs = require('fs');
const stat = util.promisify(fs.stat);
stat('.')
 .then((stats) => {
    
    
  // Do something with `stats`
 })
 .catch((error) => {
    
    
  // Handle the error.
 });
// 二、结合 Await/Async 使用
const util = require('util');
const fs = require('fs');

const stat = util.promisify(fs.stat);
async function readStats(dir) {
    
    
 try {
    
    
  let stats = await stat(dir);
  // Do something with `stats`
 } catch (err) {
    
     // Handle the error.
  console.log(err);
 }
}
readStats('.');

3、Express框架请求处理

3.1、构建模块化路由

  • app.js文件
const express = require('express')
const home = require('./route/home')
const user = require('./route/user')
// 创建服务器
const app = express()

// 将路由和请求路径进行匹配
app.use('/home', home)
app.use('/user', user)

app.listen(80)
  • route/home.js文件
const express = express('express')
// 创建路由对象
const home = express.Router()
// 在home路由下面继续创建路由
home.get('/index', (req, res) => {
    
    
   //  当用户访问/home/index时
   res.send('我是home页')
})

module.exports(home)
  • route/user.js文件
const express = express('express')
// 创建路由对象
const user = express.Router()
// 在home路由下面继续创建路由
user.get('/index', (req, res) => {
    
    
   //  当用户访问/user/index时
   res.send('我是user页')
})

module.exports(user)

3.2、GET参数的获取

Express框架中使用req.query即可获取GET参数,框架内部会将GET参数转换为对象并返回。

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

// 接收地址栏中问号后面的参数
 // 例如: http://localhost:3000/?name=lgg&age=18
app.get('/index', (req, res) => {
    
    
    res.send(req.query) // {"name":"lgg","age":"18"}
})

// 监听端口
app.listen(80)

3.3、POST参数的获取

Express中接收post请求参数需要借助第三方包 body-parser
:npm install body-parser

const express = require('express');
 // 引入body-parser模块
const bodyParser = require('body-parser')
const app = express()

// app.use中调用的方法它的返回值也是一个函数,正好作为其参数
 // 配置body-parser模块
app.use(bodyParser.urlencoded({
    
    extended: false})) // extended:的值为false时,回调用nodejs的querystring系统模块进行处理;为true时会使用qs第三方模块进行处理,会更强大。但是使用querstring就能满足要求,也是官方推荐设置
 // 接收请求
app.post('/index', (req, res) => {
    
    
    res.send(req.body)
})

// 错误处理中间件(只能主动的捕获到同步代码出错,异步代码出错捕获不到,需要手动调用next(err)把错误传进去)
app.use((err, req, res, next) => {
    
    
    res.status(500).send(err.message)
})

// 监听端口
app.listen(80)

3.4、Express路由参数

// 引入express框架;先安装 npm install express
const express = require('express');
const app = express()

 // 例如: http://localhost:3000/lgg/18
app.get('/index/:name/:age', (req, res) => {
    
    
    res.send(req.params) // {"name":"lgg","age":"18"}
})

// 监听端口
app.listen(80)

3.5、静态资源的处理

使用Express内置的express.static可以方便的托管静态文件,例如img、css、js文件等

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

// 实现静态资源访问功能
app.use('/static', express.static(path.join(__dirname, 'public'))) // 会判断客户端发来的请求是否是静态资源请求;是则直接响应终止当前请求,不是则会调用next方法将请求的控制权交给下一个中间件

// 现在,public 目录下面的文件就可以访问了。
// http://localhost:3000/images/kitten.jpg
// http://localhost:3000/css/style.css
// http://localhost:3000/js/app.js
// http://localhost:3000/images/bg.png
// http://localhost:3000/default.html 

/*
// 也可以指定一个虚拟路径
app.use('/static', express.static(path.join(__dirname, 'public')))
// 则
// http://localhost:3000/static/images/kitten.jpg
// http://localhost:3000/static/css/style.css
// http://localhost:3000/static/js/app.js
// http://localhost:3000/static/images/bg.png
// http://localhost:3000/static/default.html 
*/

// 监听端口
app.listen(80)

3.6、express-art-template模板引擎

  • 为了使art-template模板引擎能够更好的和Express框架配合,模板引擎官方在原art- template模板引擎的基础上封装了express- art- template。
  • 使用npm install art-template express-art-template命令进行安装
// 引入express框架;先安装 npm install express
const express = require('express');
const path = require('path')
const app = express()

// 1、告诉express框架使用什么模板引擎渲染什么后缀的模板文件。(‘模板后缀’,‘使用的模板引擎’)
app.engine('art', require('express-art-template'))
// 2、告诉express框架模板存放的位置是什么(‘固定的值’,‘路径’)
app.set('views', path.join(__dirname, 'pages'))
// 3、告诉express框架模板的默认后缀是什么
app.set('view engine', 'art')

app.get('/', (req, res) => {
    
    
    // 渲染模板,render方法帮我们做了很多事情
    // 1、拼接模板路径
    // 2、拼接模板后缀
    // 3、哪个模板和哪个数据进行拼接
    // 4、将拼接结果响应给客户端
    res.render('list', {
    
    
        msg: 'lgg'
    })
})
// 监听端口
app.listen(80)

3.7、app.locals对象

将变量设置到app.locals对象下面,这个数据在所有的模板中都可以获取到。

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

app.locals.users = [{
    
    
    name: 'lg',
    age: 3
},{
    
    
    name: 'lgg',
    age: 18
}]

app.engine('art', require('express-art-template'))
app.set('views', path.join(__dirname, 'pages'))
app.set('view engine', 'art')

app.get('/', (req, res) => {
    
    
    res.render('list', {
    
    
        msg: 'lgg'
    })
})
app.get('/index', (req, res) => {
    
    
    res.render('index', {
    
    
        msg: 'lgg'
    })
})
// 监听端口
app.listen(80)

猜你喜欢

转载自blog.csdn.net/weixin_44767973/article/details/123449306