NestJS：我們一直在等待的精美的Node.js框架

NestJS是一個精心制作的服務(wù)器端（后端）應(yīng)用程序框架，以支持開發(fā)人員的生產(chǎn)力并讓他們的生活更加快樂。

那么，它不僅是一個框架，它還是進入領(lǐng)域驅(qū)動設(shè)計，事件采購，微服務(wù)架構(gòu)等先進工程概念領(lǐng)域的推動者。 所有軟件包都以簡單輕量級的形式打包，以便您可以選擇 - 無論您決定使用整個框架還是僅重新使用其組件。

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

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

[[223298]]

然而，盡管 Node.js 的優(yōu)點很多，但它并不能解決最常見的問題，在我看來，這是***的問題，所有的 NodeJS 現(xiàn)代框架似乎都沒有受到熏陶 - 架構(gòu)的靈活性。

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

NestJS 到底是什么？

根據(jù)該項目的網(wǎng)站:

NEST 是構(gòu)建高效，可擴展的 NodeJS 服務(wù)器端應(yīng)用程序的框架。

這與 Node.js 語言相同，所以區(qū)別在哪里？ 那么，重點是在細節(jié)：

它使用現(xiàn)代JavaScript，使用Typescript（保留與純 JavaScript 的兼容性）構(gòu)建，并結(jié)合了OOP，F(xiàn)P 和 FRP 的元素。

就是這樣。 Nest 框架以一種非?；钴S的方式鼓勵開發(fā)人員嘗試，學(xué)習(xí)和使用一些著名的軟件工程范例。這不僅是介紹性的口號 - 在項目文檔中我們找到了很多示例，指導(dǎo)和代碼源，以便我們可以在幾分鐘內(nèi)在項目中使用它們。

此外，所有這些新詞匯的 NestJS 給我們參考它背后的知識。 所以如果你不知道一些模式 - 不用擔(dān)心，你將會順利地完成整個過程。

一些特性

NestJS 是一個完全用 TypeScript 編寫的框架（它也支持 JS），它很容易測試，并且?guī)砹怂斜匾臇|西，你總是但您不知道該選什么。

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

入門：構(gòu)建一個簡單的天氣應(yīng)用程序

在這篇文章中，我們將使用 Nest 框架和 OpenWeatherMap API 編寫一個簡單的天氣應(yīng)用程序。

準(zhǔn)備項目

首先，讓我們確保你已經(jīng)安裝了支持的 Node.js 版本：

node -v

需要高于 6.11.0 。 如果您沒有安裝Node.js或版本不正確，請安裝或更新。

第二步是從 OpenWeatherMap 網(wǎng)站檢索API密鑰。 為了實現(xiàn)我們需要注冊的功能，成功注冊后，我們將能夠從 API密鑰標(biāo)簽中檢索我們的API密鑰 。

準(zhǔn)備就緒了。 讓我們來設(shè)置這個項目。 為此，我將使用 Nest 的 TypeScript 初學(xué)者存儲庫（還有一種方法可以從頭開始構(gòu)建項目，但我很懶）。 它提供了良好的初學(xué)者體驗，并擁有開始編寫代碼所需的一切。

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

$ cd weather-app /

安裝依賴關(guān)系并啟動：

$ npm i

$ npm run start

當(dāng)安裝了項目依賴關(guān)系并且應(yīng)用程序成功啟動后，您應(yīng)該在控制臺中看到以下輸出，并在瀏覽器中指向 http://localhost:3000/ 的url，應(yīng)該會給您熱情而歡迎的Hello World！ 文本。

> nest-typescript-starter@1.0.0 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 客戶端

我們已經(jīng)建立了項目，獲取天氣數(shù)據(jù)的 API密鑰和開發(fā)服務(wù)器，隨時準(zhǔn)備交付。

我們現(xiàn)在安裝一個HTTP客戶端，在這個區(qū)域我的個人偏好是 axios 。 為什么選擇axios？ 這是一個基于Promise 的客戶端，它支持服務(wù)器端和客戶端，并提供許多有用的功能，如：對JSON轉(zhuǎn)換的自動響應(yīng)和專用的工具 - moxios--使測試變得順暢和輕松。

$ npm i --save axios

建立***個服務(wù)

現(xiàn)在我們可以開始構(gòu)建我們的***個服務(wù)

為了做到這一點，讓我們在我們的 src/ 文件夾中創(chuàng)建一個名為 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;

}

}

我們正在創(chuàng)建一個封裝 HTTP 客戶端的類，以實現(xiàn)實際的 API 調(diào)用。 有一點需要注意的是類裝飾器 @Component()，多虧了它，框架才會知道這是我們想要在 DiC 中注冊的組件。 它有一種方法，這是異步的 - 它會返回一個Promise - 返回到控制器將由 Nest 處理。

HTTP通信層

接下來我們需要建立的是控制器。 在src /文件夾中創(chuàng)建一個名為 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 路由上作出響應(yīng)。

然后，我們在類構(gòu)造函數(shù)中注入了我們的 WeatherService ，并將其設(shè)置為名為weatherService 的私有屬性。

***是一個稱為 root 的異步操作，它返回一個Promise，最終解析為一個對象。 它內(nèi)部調(diào)用我們的 weatherService 并獲得紐約的實際天氣預(yù)報。

連接點

為了使我們的應(yīng)用程序正常工作，我們需要做的***一件事是將應(yīng)用程序模塊中的所有部分連接在一起：

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 {}

保存文件，重啟你的開發(fā)服務(wù)器，當(dāng)你在瀏覽器中導(dǎo)航到url http://127.0.0.1:3000/weather 時，你會看到天氣服務(wù)的響應(yīng)。

上面的代碼是為了顯示我們?nèi)绾慰焖俚卦?NestJS 中構(gòu)建一個好的東西。然而, 我看到一些改進, 這還沒有做, 因為我想保持簡單:

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

概要

我們從理論上討論了NestJS并做了一個實際的例子。 欲了解更多信息，請參閱框架的官方文檔，其中包含大量隨時可用的指導(dǎo)和代碼片段。

Node.js 是為了擴展和實現(xiàn)實時網(wǎng)絡(luò)應(yīng)用程序的高效開發(fā)而創(chuàng)建的，它非常好。

現(xiàn)在我們已經(jīng)有了 NestJS 框架來解決架構(gòu)問題。

中文文檔: https://docs.nestjs.cn

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