【譯】NestJS：我們一直在等待的精美的Node.js框架 轉 薦

NestJS 是一個精心製作的服務器端（後端）應用程序框架，以支持開發人員的生產力並讓他們的生活更加快樂。

那麼，它不僅是一個框架，它還是進入領域驅動設計，事件採購，微服務架構等先進工程概念領域的推動者。 所有軟件包都以簡單輕量級的形式打包，以便您可以選擇 - 無論您決定使用整個框架還是僅重新使用其組件。

我是一個 PHP 編寫的 Symfony 框架的粉絲。 在我的職業生涯中，我花了好幾年的時間開發大型應用程序，它並沒有讓我失望。 它寫得很好，作爲一個客觀的，具有良好文檔的模塊化 Web 框架，提供了良好的開發者體驗。 與我描述 NestJS 完全一樣。

Node.js 和包管理器 NPM 提供了功能全面的服務器端環境，靈活性強，運行速度極快，對開發人員來說具有巨大的靈活性，從而將開發到生產的時間縮短到幾小時，而不是幾天。

然而，儘管 Node.js 的優點很多，但它並不能解決最常見的問題，在我看來，這是最大的問題，所有的 NodeJS 現代框架似乎都沒有受到薰陶 - 架構的靈活性。

有人可能會說 - 這不是決定項目架構的框架問題。 那麼，我完全同意這一點，但是我們幾乎在每個項目中都會看到一些衆所周知的概念和模式。 在我看來，如果一個框架將開發人員推向了良好的架構決策，這是一件好事。

NestJS 到底是什麼？

根據該項目的網站:

NEST 是構建高效，可擴展的 NodeJS 服務器端應用程序的框架。

這與 Node.js 語言相同，所以區別在哪裏？ 那麼，重點是在細節：

它使用現代JavaScript，使用Typescript（保留與純 JavaScript 的兼容性）構建，並結合了OOP，FP 和 FRP 的元素。

就是這樣。 Nest 框架以一種非常活躍的方式鼓勵開發人員嘗試，學習和使用一些著名的軟件工程範例。這不僅是介紹性的口號 - 在項目文檔中我們找到了很多示例，指導和代碼源，以便我們可以在幾分鐘內在項目中使用它們。 此外，所有這些新詞彙的 NestJS 給我們參考它背後的知識。 所以如果你不知道一些模式 - 不用擔心，你將會順利地完成整個過程。

一些特性

NestJS 是一個完全用 TypeScript 編寫的框架（它也支持 JS），它很容易測試，並且帶來了所有必要的東西，你總是但您不知道該選什麼。

• 依賴注入容器 - NestJS 帶有自己的DiC，這是一個在 JavaScript 世界中似乎被遺忘的實用工具，但我真的不能沒有它。 有一些解決方案像 Inversify 或 Bottle，但 NestJS 有自己的解決方案。 它也支持工廠注入。
• 模塊化 - 在NestJS中，處於相同域邊界內的應用程序的每個邏輯部分都是一個模塊，它鼓勵封裝。
• 可測試性 - 由於引入了 DiC 和 Modularisation，您可以根據服務構建應用程序, 使控制器的工作更容易進行測試。
• 使用 TypeScript中 - 類型很好。 你可以給一個變量分配類型，減少可能出現的錯誤。

入門：構建一個簡單的天氣應用程序

在這篇文章中，我們將使用 Nest 框架和 OpenWeatherMap API 編寫一個簡單的天氣應用程序。 準備項目 首先，讓我們確保你已經安裝了支持的 Node.js 版本：

node -v

需要高於 6.11.0 。 如果您沒有安裝Node.js或版本不正確，請安裝或更新。 第二步是從 OpenWeatherMap 網站檢索API密鑰。 爲了實現我們需要註冊的功能，成功註冊後，我們將能夠從 API密鑰標籤中檢索我們的API密鑰 。 準備就緒了。 讓我們來設置這個項目。 爲此，我將使用 Nest 的 TypeScript 初學者存儲庫（還有一種方法可以從頭開始構建項目，但我很懶）。 它提供了良好的初學者體驗，並擁有開始編寫代碼所需的一切。

  $ git clone https://github.com/nestjs/typescript-starter.git project
   $ cd weather-app /

安裝依賴關係並啓動：

$ npm i
$ npm run start

當安裝了項目依賴關係並且應用程序成功啓動後，您應該在控制檯中看到以下輸出，並在瀏覽器中指向 http://localhost:3000/ 的url，應該會給您熱情而歡迎的Hello World！ 文本。

 > [email protected] start /Users/mat/Development/weather-app> node index.js

[Nest] 31827 - 2018-1-13 11:39:32 [NestFactory] Starting Nest application...
[Nest] 31827 - 2018-1-13 11:39:32 [InstanceLoader] ApplicationModule dependencies initialized +7ms
[Nest] 31827 - 2018-1-13 11:39:32 [RoutesResolver] AppController {/}: +34ms
[Nest] 31827 - 2018-1-13 11:39:32 [RouterExplorer] Mapped {/, GET} route +2ms
[Nest] 31827 - 2018-1-13 11:39:32 [NestApplication] Nest application successfully started +1ms

安裝 HTTP 客戶端

我們已經建立了項目，獲取天氣數據的 API密鑰和開發服務器，隨時準備交付。 我們現在安裝一個HTTP客戶端，在這個區域我的個人偏好是 axios 。 爲什麼選擇axios？ 這是一個基於Promise 的客戶端，它支持服務器端和客戶端，並提供許多有用的功能，如：對JSON轉換的自動響應和專用的工具 - moxios--使測試變得順暢和輕鬆。

$ npm i --save axios

建立第一個服務

現在我們可以開始構建我們的第一個服務 爲了做到這一點，讓我們在我們的 src/ 文件夾中創建一個名爲 weather.service.t s的文件：

import { Component } from '@nestjs/common';
import axios, { AxiosInstance } from 'axios';

@Component()
export class WeatherService {
    private client: AxiosInstance;

    constructor() {
        this.client = axios.create({
            baseURL: 'https://api.openweathermap.org/data/2.5/',
            params: {
                APPID: 'CHANGE_ME'
            }
          });
    }

    async ofCity(city: string): object {
        const response = await this.client.get('weather', {
            params: { q: city }
        });
        return response.data;
    }
}

我們正在創建一個封裝 HTTP 客戶端的類，以實現實際的 API 調用。 有一點需要注意的是類裝飾器 @Component()，多虧了它，框架纔會知道這是我們想要在 DiC 中註冊的組件。 它有一種方法，這是異步的 - 它會返回一個Promise - 返回到控制器將由 Nest 處理。 HTTP通信層 接下來我們需要建立的是控制器。 在src /文件夾中創建一個名爲 weather.controller.ts 的文件：

import { Get, Controller } from '@nestjs/common';
import { WeatherService } from './weather.service';

@Controller('weather')
export class WeatherController {
    constructor(private readonly weatherService: WeatherService) {}

        @Get()
        async root(): Promise< object > {
        const response = await this.weatherService.forCity('New York');
        return response;
  }

裝飾器 @Controller（'weather'）告訴框架我們期望這個控制器在 / weather 路由上作出響應。 然後，我們在類構造函數中注入了我們的 WeatherService ，並將其設置爲名爲weatherService 的私有屬性。 最後是一個稱爲 root 的異步操作，它返回一個Promise，最終解析爲一個對象。 它內部調用我們的 weatherService 並獲得紐約的實際天氣預報。 連接點 爲了使我們的應用程序正常工作，我們需要做的最後一件事是將應用程序模塊中的所有部分連接在一起：

import { Module } from '@nestjs/common';
import { AppController } from './app.controller';
import { WeatherController } from './weather.controller';
import { WeatherService } from './weather.service';

@Module({
  imports: [],
  controllers: [AppController, WeatherController],
  components: [WeatherService],
})export class ApplicationModule {} 

保存文件，重啓你的開發服務器，當你在瀏覽器中導航到url http://127.0.0.1:3000/weather 時，你會看到天氣服務的響應。 上面的代碼是爲了顯示我們如何快速地在 NestJS 中構建一個好的東西。然而, 我看到一些改進, 這還沒有做, 因爲我想保持簡單:

• 返回類型的接口。 我們可以充分利用 TypeScript 和強類型所有的東西
• 錯誤處理。 當 promise 不是 resolve 時，我們的控制器很可能會中斷
• 測試套件。 我們還沒有寫任何測試
• 我們要返回整個數據 blob。我們只能去掉我們關心的值

概要

我們從理論上討論了NestJS並做了一個實際的例子。 欲瞭解更多信息，請參閱框架的官方文檔，其中包含大量隨時可用的指導和代碼片段。 Node.js 是爲了擴展和實現實時網絡應用程序的高效開發而創建的，它非常好。 現在我們已經有了 NestJS 框架來解決架構問題。

中文文檔: https://docs.nestjs.cn 英文官方文檔：https://docs.nestjs.com