Nestjs入門教程【一】基礎概念

沒有盡頭，沒有開始，只有對生活無盡的熱情。

• 微信公衆號 《JavaScript全棧》
• 掘金 《合一大師》
• 視頻講解：Bilibili 《合一大師》

內容持續更新

介紹

爲何學習Nestjs

不知你們能否據說過 Java 語言大名鼎鼎的幾個框架——SpringBoot、SpringMVC。不能否認這些框架的設計思想在後端服務領域都是領先的。做爲以 Javascript 爲主要開發語言的咱們，也想有這樣一些優秀的、漸進式的服務端框架，雖然在此以前有 Express 、Koa、Egg 等基於Nodejs的服務端框架，但都不是我鍾愛的，由於我入門編程就是使用Java的三大框架SSH。MVC 也許是大多開發者所能接受的開發思想了，這裏解釋一下，M（Model模型即數據層）、V（View視圖，現多爲先後端分離項目，後端只提供接口服務）、C（Controller控制器，控制前端請求來的路由分發等）。明白這三點只是基礎，隨着業務不斷複雜，咱們須要管理的數據愈來愈多、數據庫操做愈來愈複雜、關於性能緩存的要求愈來愈高，咱們可能會變得一籌莫展。如何優雅地管理項目模塊，變得尤其重要，我以爲 Nestjs 正是這樣一個幫助咱們更好開發的框架。咱們開始學習吧！

Nestjs的主要思想

Nest (NestJS)是基於Nodejs的服務端框架，建議使用Typescript進行開發（不過也一樣支持使用JavaScript開發）。經過這個框架學習，咱們不只可以打通先後端開發任督二脈，還能學到譬如 OOP（面向對象編程）、FP（函數式編程）、FRP（函數響應式編程）思想，助力高薪。

Nestjs默認選擇 Express 做爲底層服務框架，你也能夠經過配置選擇 Fastify。

安裝

相信使用過 Vue、 React 或 Angular 的同窗都熟悉項目初始化的腳手架工具，Nestjs也爲你們提供了一個腳手架工具，有了這個工具咱們可以更快搭建起Nestjs項目，下面咱們來安裝它吧。

npm i -g @nestjs/cli
複製代碼

爲了版本一致，咱們統一制定版本號爲：@6.14.0，安裝命令就是

npm i -g @nestjs/cli@6.14.0
複製代碼

安裝完成之後，咱們能夠經過幫助命令檢測腳手架工具是否安裝成功，命令很簡單，以下

nest -h
複製代碼

咱們若是能夠看到相似以下內容，則表示安裝成功

Usage: nest <command> [options]

Options:
  -v, --version                                   Output the current version.
  -h, --help                                      Output usage information.

Commands:
  new|n [options] [name]                          Generate Nest application.
  build [options] [app]                           Build Nest application.
  start [options] [app]                           Run Nest application.
  generate|g [options] <schematic> [name] [path]  Generate a Nest element.
    Available schematics:
      ┌───────────────┬─────────────┐
      │ name          │ alias       │
      │ application   │ application │
      │ angular-app   │ ng-app      │
      │ class         │ cl          │
      │ configuration │ config      │
      │ controller    │ co          │
      │ decorator     │ d           │
      │ filter        │ f           │
      │ gateway       │ ga          │
      │ guard         │ gu          │
      │ interceptor   │ in          │
      │ interface     │ interface   │
      │ middleware    │ mi          │
      │ module        │ mo          │
      │ pipe          │ pi          │
      │ provider      │ pr          │
      │ resolver      │ r           │
      │ service       │ s           │
      │ library       │ lib         │
      │ sub-app       │ app         │
      └───────────────┴─────────────┘
  info|i                                          Display Nest project details.
  update|u [options]                              Update Nest dependencies.
  add [options] <library>                         Adds support for an external library to your project.
複製代碼

到這裏，你是否是火燒眉毛想初始化一個項目練手了呢？那咱們就來建立一個項目

nest new nest-demo
複製代碼

如今只須要靜靜地等待~ 初始化並安裝完成之後，啓動項目

npm run start
複製代碼

而後打開瀏覽器，輸入 http://localhost:300，就能看到呈現給咱們的頁面了。我完事了，你呢？

九個核心概念

我看多不少人的演講和課程之後，發現了一個頗有意思的規律，晦澀難懂的概念想講明白可是聽衆實在是聽不明白，簡單明瞭的概念不想讓聽衆以爲容易故意往復雜了說致使聽衆同樣糊里糊塗。我不想這樣，我想個人這套課程可以從實用出發，逐步深刻，最後講解該框架的設計原理與實現，但是就算我想說的很明白，框架自己的不少概念咱們也無法躲避開，與其在咱們後面的工做和學習中與這些概念糾纏不休，咱們長痛不如短痛，先從要害下手。

九個核心概念貫穿Nestjs開發始終，也只有你深入理解了這些核心概念，你才能構建出優秀的Nestjs項目，就像早些年Java面試必問JSP中九大內置對象 。

1. Controllers
2. Providers
3. Modules
4. Middleware
5. Exception Filters
6. Pipes
7. Guards
8. Interceptors
9. Custom decorators

Controllers

英文直譯：控制器，控制？控制什麼？

客戶端就像一個懵懂的小男生，看到了喜歡的女孩子就會示好表白，是給你這壞男孩好人卡仍是傾心相待，控制權在女孩子手中。客戶端的請求最終交給那個函數或者模塊處理都須要經過預先處理，直接處理客戶端請求（路由、方法等）的模塊咱們稱之爲控制器。@Controller

Providers

英文直譯：提供者，提供？提供什麼？

場景一：

我：親愛的，我想吃燒烤。

女朋友：好冷啊，我不想作。

我：恰好我看到樓下開了一家麼斯烤肉，去嚐嚐吧。

場景二：

我：親愛的，咱們房子立刻要裝修了，你作總設計師能夠嗎？

老婆：我是UI設計師！不是室內設計，不過我有個朋友公司作設計挺棒，要不？

我：好的，我去學室內設計，而後去你朋友那上班

從以上兩個場景，咱們能看出什麼？女友不愛我無論要幹嗎，都能找到提供服務的商家。提供者使咱們預先定義好的一些服務，爲咱們後續開發過程服務。@Injectable() 裝飾的類。

Modules

英文直譯：模塊，何時模塊？

君子由什麼組成？咱們能夠想到忠孝仁義，這四個特質拆開來個個都是優秀品質，組合在一塊兒就成了受人尊敬的正人君子。Nestjs個個模塊、功能、服務等都是優秀個體，裝載到一塊兒即是優秀的服務架構。@Module() 裝飾的類來組織應用結構。

Middleware

英文直譯：中間賤件，誰的中間？

中間，是客戶端和路由處理的中間，咱們前面提到路由交給了控制器處理，若是咱們想請求在到達控制器以前或者在響應發送給客戶端以前對request和response作一些處理，就可使用中間件，在中間件定義的過程當中，有一個很重要的函數——next()，他決定了請求-響應的循環系統。提一點，你知道Koa的洋蔥模型嗎？

一直講中文有點累，咱們粘貼點express官方給的中間件描述

Middleware functions can perform the following tasks:

• execute any code.
• make changes to the request and the response objects.
• end the request-response cycle.
• call the next middleware function in the stack.
• if the current middleware function does not end the request-response cycle, it must call next() to pass control to the next middleware function. Otherwise, the request will be left hanging.

Exception filters

英文直譯：異常過濾器，過濾誰？

當你的項目中出現了異常，而代碼中卻沒有處理，那麼這個異常就會到Nestjs內建的異常處理層，咱們經過預約義異常處理過濾器，就能將異常更友好地響應給前端。

Pipes

英文直譯：管道，和水管有區別嗎？

有用過Linux系統的同窗，能否知道bash命令中那小小的一個豎線，這個命令有印象嗎？

ls | grep '*.js'
複製代碼

列舉當前目錄下的文件及文件夾，而後獲得的結果進行過濾，過濾規則爲知足文件後綴名爲js的文件。咱們經過這個操做，能感覺到管道的做用，其做用能夠概括爲一下兩點

1. 轉換：將輸入的內容轉換爲但願獲得的結果
2. 驗證：驗證輸入的內容是否知足預先定義的規則，若是驗證經過，則會進入到後續操做；不然將拋出異常

filter 和 Pipes 使用的階段類似，都是在請求處理以前，可是他們的職責卻有很大差異，各自職責以列舉，詳細的使用場景咱們後續介紹。管道是用@Injectable()裝飾並實現了PipeTransform 接口的類。

Guards

英文直譯：守衛，守衛誰？

咱們的房子爲何須要鑰匙？由於咱們不容許外人進入咱們的房間。應用中有些請求處理不是對全部前來請求的用戶徹底開放的，只有具備指定身份的人才能請求某些接口，負責這一職責的功能模塊稱之爲守衛。管守衛是用@Injectable()裝飾並實現了CanActivate接口的類。提示一點

Guards are executed after each middleware, but before any interceptor or pipe.

Interceptors

英文直譯：攔截器，攔截誰？爲何要攔截，攔截了作什麼？

一個流水線，若是中間臨時須要加一道工序，隨加隨撤，咱們發現這一道工序只是目前臨時新增的，他並不屬於這條流水線上完整環境中的一個步驟，所以這道工序咱們能夠將它看作外來者，有沒有他不影響咱們現有的流水線工做，但加入了它，咱們如今流水線製造出的產品更趨於定製化。這道工序咱們是切入到現有流水線中來的，這種作法咱們稱之爲面向切面，固然在程序界，他就是頗有名的一個思想 Aspect Oriented Programming （AOP）思想，即面向切面編程，它有一下幾點優點

1. 在現有某個函數執行前/後新增一個額外邏輯
2. 轉換一個函數返回的值，這點概念上與Pipes相近
3. 轉換一個函數運行時拋出的異常
4. 能夠繼承某個基礎函數的行爲，更優雅的組合功能
5. 重寫某個函數

攔截器是用@Injectable() 裝飾並實現了 NestInterceptor 接口的類。

Custom decorators

英文直譯：自定義裝飾器

在此以前，介紹了不少裝飾器，好比：@Injectable() 、@Module() 、@Controller 等，還有請求相關的裝飾器：@Get() 、@Post() 、@Param 等。