夜猫子的知识栈 夜猫子的知识栈
首页
  • 前端文章

    • JavaScript
  • 学习笔记

    • 《JavaScript教程》
    • 《Web Api》
    • 《ES6教程》
    • 《Vue》
    • 《React》
    • 《TypeScript》
    • 《Git》
    • 《Uniapp》
    • 小程序笔记
    • 《Electron》
    • JS设计模式总结
  • 《前端架构》

    • 《微前端》
    • 《权限控制》
    • monorepo
  • 全栈项目

    • 任务管理日历
    • 无代码平台
    • 图书管理系统
  • HTML
  • CSS
  • Nodejs
  • Midway
  • Nest
  • MySql
  • 其他
  • 技术文档
  • GitHub技巧
  • 博客搭建
  • Ajax
  • Vite
  • Vitest
  • Nuxt
  • UI库文章
  • Docker
  • 学习
  • 面试
  • 心情杂货
  • 实用技巧
  • 友情链接
收藏
  • 分类
  • 标签
  • 归档
GitHub (opens new window)

夜猫子

前端练习生
首页
  • 前端文章

    • JavaScript
  • 学习笔记

    • 《JavaScript教程》
    • 《Web Api》
    • 《ES6教程》
    • 《Vue》
    • 《React》
    • 《TypeScript》
    • 《Git》
    • 《Uniapp》
    • 小程序笔记
    • 《Electron》
    • JS设计模式总结
  • 《前端架构》

    • 《微前端》
    • 《权限控制》
    • monorepo
  • 全栈项目

    • 任务管理日历
    • 无代码平台
    • 图书管理系统
  • HTML
  • CSS
  • Nodejs
  • Midway
  • Nest
  • MySql
  • 其他
  • 技术文档
  • GitHub技巧
  • 博客搭建
  • Ajax
  • Vite
  • Vitest
  • Nuxt
  • UI库文章
  • Docker
  • 学习
  • 面试
  • 心情杂货
  • 实用技巧
  • 友情链接
收藏
  • 分类
  • 标签
  • 归档
GitHub (opens new window)
  • Node基础

  • 《MySQL》学习笔记

  • Midway

  • Nest

    • 开篇词
    • 学习理由
    • nest概念扫盲
    • 快速掌握 nestcli
    • 5种http数据传输方式
    • IoC 解决了什么痛点问题?
    • 如何调试 Nest 项目
    • Provider注入对象
    • 全局模块和生命周期
    • AOP 架构有什么好处?
    • 一网打尽 Nest 全部装饰器
    • Nest如何自定义装饰器
    • Metadata和Reflector
    • ExecutionContext切换上下文
    • Module和Provider的循环依赖处理
    • 如何创建动态模块
    • Nest和Express,fastify
      • 了解 Express
      • Nest 做了哪些?
        • Adapter
      • 切换到 fastify
      • 总结
    • Nest的Middleware
    • RxJS和Interceptor
    • 内置Pipe和自定义Pipe
    • ValidationPipe验证post请求参数
    • 如何自定义 Exception Filter
    • 图解串一串 Nest 核心概念
    • 接口如何实现多版本共存
    • Express如何使用multer实现文件上传
    • Nest使用multer实现文件上传
    • 图书管理系统
    • 大文件分片上传
    • 最完美的 OSS 上传方案
    • Nest里如何打印日志
    • 为什么Node里要用Winston打印日志
    • Nest 集成日志框架 Winston
    • 通过Desktop学Docker也太简单了
    • 你的第一个 Dockerfile
  • 其他

  • 服务端
  • Nest
神说要有光
2025-03-10
目录

Nest和Express,fastify

前面我们用的 Nest 的 request、response 对象都是 Express 的,而且 Nest 也支持 Express 的中间件机制。

那 Nest 和 Express 是什么关系呢?

# 了解 Express

Express 是一个处理请求、响应的库,它是这样用的:

const express = require('express')
const cookieParser = require('cookie-parser')
const cookieValidator = require('./cookieValidator')

const app = express()

async function validateCookies (req, res, next) {
  await cookieValidator(req.cookies)
  next()
}

app.use(cookieParser())

app.use(validateCookies)

app.use((err, req, res, next) => {
  res.status(400).send(err.message)
})

app.listen(3000)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

通过 use 一个个中间件来处理请求、返回响应。

这种调用链叫做洋葱模型:

基于中间件能完成各种功能。

但是 Express 只是一个处理请求的库,并没有提供组织代码的架构能力,代码可能写成各种样子。

# Nest 做了哪些?

所以企业级开发,我们会用对它封装了一层的库,比如 Nest。

Nest 提供了 IOC、AOP 等架构特性,规定了代码组织的形式,而且对 websocket、graphql、orm 等各种方案都提供了开箱即用的支持。

也就是说,用 Node 写一个 http 服务有三个层次:

  • 直接使用 http、https 的模块
  • 使用 express、koa 这种库
  • 使用 Nest 这种企业级框架

就像写 java 你还会直接处理 http 请求并手动集成各种方案么?

不会,会直接用 Spring 这种一站式企业级开发框架。

同样的道理, Nest 就是 node 生态里的 Spring。

但是 Nest 也没有和 Express 强耦合,它做了一层抽象:

定义了 HttpServer 的 interface (opens new window):

然后封装了 AbstractHttpAdapter 的 abstract class (opens new window):

之后分别提供了 express 和 fastify 的实现:

# Adapter

Adapter 是适配器的意思,也就是说 Nest 内部并没有直接依赖任何一个 http 处理的库,只是依赖了抽象的接口,想用什么库需要实现这些接口的适配器。

你可以用 express,也可以灵活的切换成 fastify,对 Nest 没有任何影响。

这俩适配器分别在 @nestjs/platform-express 和 @nestjs/platform-fastify 的包里:

默认用的是 platform-express 的包:

下面我们切换到 fastify 试试看:

nest new fastify-test -p npm

同样,先用 @nestjs/cli 创建个 nest 项目

然后把它跑起来:

nest start --watch

浏览器访问 http://localhost:3000 (opens new window) 看到 hello world 就是服务跑成功了:

现在用的是默认的 express,我们切换到 fastify 试试看:

# 切换到 fastify

安装 fastify 和 @nestjs/platform-fastify:

npm install fastify @nestjs/platform-fastify

然后修改下 Nest 创建的方式:

改成这样:

这个 FastifyAdapter 前面讲过,传入这个 adapter 之后,就切换到了 fastify 平台。

这里你还可以再传一个类型参数:

这样返回的 app 就会提示 fastify 平台特有的方法了:

这也是为什么之前我们要传入 NestExpressApplication 才有 useStaticAssets 方法:

然后在 controller 里可以注入 fastify 的 request 和 reply 对象:

import { Controller, Get, Request, Response } from '@nestjs/common';
import { FastifyReply, FastifyRequest } from 'fastify';
import { AppService } from './app.service';

@Controller()
export class AppController {
  constructor(private readonly appService: AppService) {}

  @Get()
  getHello(@Request() request: FastifyRequest, @Response() reply: FastifyReply) {
    reply.header('url', request.url)
    reply.send('hello')
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

我们注入了 fastify 的 request 和 reply 对象,然后用它来设置 header 发送响应:

这里要注意的是一旦用 @Response 注入了响应对象,就不能通过 return 的方式来返回响应内容了,需要手动调用 res.send。

这点用 express 时也是一样。

很容易理解,因为你可能在方法里用 resposne 对象发送数据了,那如果 Nest 再把返回值作为响应内容,不就冲突了么?

当然,你也可以这样做:

传个 passthrough 参数,代表不会在方法里自己发送响应内容。

这样返回值就生效了:

最后,我们来思考下为什么 Nest 要做能够轻松切换 http 处理库呢?

因为 Nest 的核心还是在于 IOC、AOP 这些架构特性,像 express、fastify 只不过是请求、响应的方法不同而已,区别并不大。

如果强依赖于 express,万一有更好的 http 处理库怎么办?

这种加一层抽象和适配器的方式,能让 Nest 更加通用、灵活,有更强的扩展性。

案例代码在小册仓库 (opens new window)。

# 总结

express 是基于中间件的洋葱模型处理请求、响应的库,它并没有提供组织代码的架构特性,代码可以写的很随意。

而为了更好的可维护性,我们都会用 Nest 这种一站式企业级开发框架。就像 java 里会用 Spring 框架一样。

Nest 底层是 express 但也不完全是,它内部实现是基于 interface 的,而且提供了 @nestjs/platform-express、@nestjs/platform-fastify 这两个 adapter 包。

这样就可以轻松的切换 express、fastify 或者其他的 http 请求处理的库。

这就是适配器模式的魅力。

编辑 (opens new window)
上次更新: 2025/5/14 16:47:16
如何创建动态模块
Nest的Middleware

← 如何创建动态模块 Nest的Middleware→

最近更新
01
IoC 解决了什么痛点问题?
03-10
02
如何调试 Nest 项目
03-10
03
Provider注入对象
03-10
更多文章>
Copyright © 2019-2025 Study | MIT License
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式