本篇文章帶大家聊聊node框架 Nest.js是如何松耦合地整合 Express 的,希望對大家有所幫助!
Node.js 提供了 http 模塊用于監(jiān)聽端口、處理 http 請求,返回響應(yīng),這也是它主要做的事情。
但是 http 模塊的 api 太過原始,直接基于它來處理請求響應(yīng)比較麻煩,所以我們會用 express 等庫封裝一層。
這一層做的事情就是給 request 和 response 添加了很多處理請求響應(yīng)的方法,滿足各種場景的需求,并且對路由做了處理,而且,也提供了中間件的調(diào)用鏈便于復用一些代碼,這種中間件的調(diào)用鏈叫做洋蔥模型。
但這一層沒有解決架構(gòu)問題:當模塊多了怎么辦,怎么管理?如何劃分 Model、View、Controller? 等等。
所以,用 Node.js 做后端服務(wù)時我們會再包一層,解決架構(gòu)問題,這一層的框架有 eggjs(螞蟻的)、midwayjs(淘寶的)、nestjs(國外的)。
nestjs 是其中最優(yōu)秀的一個:
這一層的底層還是 express、koa 等,它只是在那些 http 框架的基礎(chǔ)上額外解決了架構(gòu)問題。
而且 nestjs 還有一點做的特別好,它不依賴任何一個 http 平臺,可以靈活的切換。
那么 nestjs 是怎么做到底層平臺的切換的呢?
想想 react 是怎么做到把 vdom 渲染到 canvas、dom、native 的?
定義一層統(tǒng)一的接口,各種平臺的 render 邏輯實現(xiàn)這些接口。這種模式叫做適配器模式。
適配器模式是當用到第三方實現(xiàn)的某個功能時,不直接依賴,而是定義一層接口,讓第三方去適配這層接口。這樣任何一個適配了這層接口的方案都能集成,也能夠靈活的切換方案。
Nest.js 對底層的 http 平臺就是提供了一層接口(HttpServer),定義了一堆用到的方法:
因為 ts 的 interface 必須實現(xiàn)所有的方法才行,為了簡化,又繼承了一層抽象類 AbstractHttpAdapter,把需要實現(xiàn)的方法定義成 abstract 的。
然后 express 或者別的平臺比如 fastify 只要繼承這個適配器的類,實現(xiàn)其中的抽象方法,就能接入到 Nest.js 里:
比如 ExpressAdapter:
或者 FastifyAdapter:
這些邏輯分別放在 platform-express 和 platform-fastify 包里:
Nest.js 第一行代碼是調(diào)用 create:
create 里就會選擇一種 httpAdapter 來創(chuàng)建服務(wù):
默認是 express:
這樣,之后調(diào)用的 request 和 response 的方法最終就都是 express 的了。
比如在 controller 里可以用 @Request 裝飾器來注入 reqeust 對象,就可以調(diào)用 reqeust 的各種方法。
import { Controller, Get, Request } from '@nestjs/common'; @Controller('cats') export class CatsController { @Get() findAll(@@Request() request: Request): string { return 'This action returns all cats'; } }
如果你想調(diào)用一些接口之外的特定平臺的方法的話,Nest.js 也支持,那就換用 @Req 來注入:
import { Controller, Get, Req } from '@nestjs/common'; @Controller('cats') export class CatsController { @Get() findAll(@@Req() request: Request): string { return 'This action returns all cats'; } }
這樣注入的就是特定平臺比如 express 的原生 request 對象,就可以直接用它的所有方法。
此外,如果真的要用 Express 平臺的特定 api 的話,在 NestFactory.create 的時候可以指定對應(yīng)的類型參數(shù),這樣就能做相應(yīng)的類型提示和檢查了:
但是這樣就和特定平臺耦合了,除非是確定不會切換平臺,否則不建議這么做。
http 平臺是這么做的,同理,websocket 平臺也是這樣的:
定義了一層統(tǒng)一的接口,通過適配器的方式分別接入 socketio 和 websocket,可以靈活的切換:
圖解下 Nest.js 關(guān)于 http 、websocket 平臺的處理:
總結(jié)
Node.js 提供了 http 模塊用來監(jiān)聽端口、處理請求響應(yīng),但是它的 api 過于原始,所以我們會包一層,在 express 這一層提供