NestJS Node.js（開發者的使用方法）

TypeScript 支持

NestJS 的構建使用 TypeScript，它是一種靜態型別的 JavaScript 超集，提供了先進的自動完成、型別安全和現代語言功能。 這提高了程式碼的可維護性並有助於在編譯期間檢測錯誤。 NestJS 預設支持 JavaScript 和 TypeScript，為開發者提供更多自由。

模組化架構

NestJS 鼓勵以模組為基礎的程式碼組織。 當相關組件如控制器、提供者和服務被封裝在單個模組中時，程式碼的維護、擴展和組織變得更簡單。 應用程式的模組可以在其他區域使用，促進了 DRY（不重複自己）理念。

相依性注入

NestJS 的主要功能之一是其先進的相依性注入系統，這使得管理相依性變得更加容易。 透過注入相依性而不是硬編碼相依性，NestJS 建立了鬆散耦合和可測試的組件。 這種風格還使更具模組化的程式碼和更佳的關注點分離成為可能。

裝飾器

裝飾器在 NestJS 中被廣泛用於建立和設置類及成員。 使用像 @Injectable() 等裝飾器，提升了程式碼的可讀性和表達性，清楚地顯示應用程式每個組件的功能和行為。

與 Express 和 Fastify 的相容性

由於其適應性，NestJS 讓開發者可以選擇使用 Fastify 或 Express 作為底層的 HTTP 伺服器。 雖然 Fastify 提供更好的效能，Express 以使用者友好和高效著稱。 由於這種可適性，開發者可以根據特定需求調整他們的應用程式。

中介軟體

NestJS 支持類似 Express 的中介軟體功能。 在請求到達路由處理器之前，中介軟體可以處理它們，提供如正文解析、身份驗證和日誌記錄等功能。 這有助於實施可重用的處理請求邏輯。

例外處理

NestJS 具有強大的例外處理系統，允許程式設計師建立獨特的例外過濾器。 這些過濾器通過以標準化方式捕捉和處理例外，提高了錯誤管理和響應的一致性。

管道和守衛

管道：管道用於資料轉換和驗證。可在控制器級別、路由處理級別或全域實施。 內建了驗證和轉換管道，也可以製作自定義管道。

守衛：守衛實施工授權和身份驗證邏輯。 它們使用特定規則，例如驗證使用者角色或權限，決定是否批准請求。

安裝 NestJS CLI

首先，使用 Yarn 或 npm 全域安裝 NestJS CLI。

npm install -g @nestjs/cli

npm install -g @nestjs/cli

建立新項目

using CLI 開始一個新的 NestJS 項目。 將 "my-nest-app" 更改為您想要的項目名稱。

nest new my-nest-app

nest new my-nest-app

項目結構

以下是標準項目結構的簡要綱要：

src/
├── app.controller.ts
├── app.controller.spec.ts
├── app.module.ts
├── app.service.ts
├── main.ts
test/
├── app.e2e-spec.ts
└── jest-e2e.json

• app.controller.ts： 包含應用程式的主控制器。
• app.service.ts： 包含應用程式的主服務。
• app.module.ts： 應用程式的根模組。
• main.ts： 應用程式的入口點。

配置模組

為了管理配置，安裝 @nestjs/config 套件。

npm install @nestjs/config

npm install @nestjs/config

將配置模組新增至 app.module.ts 文件。

import { Module } from '@nestjs/common';
import { ConfigModule } from '@nestjs/config';
import { AppController } from './app.controller';
import { AppService } from './app.service';

@Module({
  imports: [
    ConfigModule.forRoot({
      isGlobal: true, // Make the module global
    }),
  ],
  controllers: [AppController],
  providers: [AppService],
})
export class AppModule {}

使用配置服務存取環境變數。

import { Injectable } from '@nestjs/common';
import { ConfigService } from '@nestjs/config';

@Injectable()
export class AppService {
  constructor(private configService: ConfigService) {}

  getHello(): string {
    return `Hello World!`;
  }
}

IronPDF的功能

 npm i @ironsoftware/ironpdf

建立 PDF 服務

建立一個新服務去管理 PDF 的生成。這個服務將使用 IronPDF 將 HTML 資訊轉換為 PDF。

nest generate service pdf

nest generate service pdf

在建立的 pdf.service.ts 文件中應用 PDF 生成邏輯。

// src/pdf/pdf.service.ts
import { Injectable } from '@nestjs/common';
const IronPdf = require('@ironsoftware/ironpdf');
const document = IronPdf.PdfDocument;
var config = IronPdf.IronPdfGlobalConfig;
config.setConfig({ licenseKey: '' });

@Injectable()
export class PdfService {
  async generatePdf(htmlContent: string): Promise<Buffer> {
    const pdf = await document.fromHtml(htmlContent);
    const pdfBuffer = await pdf.saveAsBuffer();
    return pdfBuffer;
  }
}

建立 PDF 控制器

建立一個控制器來公開 PDF 建立的端點。

nest generate controller pdf

nest generate controller pdf

在產生的 pdf.controller.ts 文件中建立一個端點，接收 HTML 輸入並輸出 PDF。

// src/pdf/pdf.controller.ts
import { Controller, Post, Body, Res } from '@nestjs/common';
import { PdfService } from './pdf.service';
import { Response } from 'express';

@Controller('pdf')
export class PdfController {
  constructor(private readonly pdfService: PdfService) {}

  @Post('generate')
  async generatePdf(@Body('html') htmlContent: string, @Res() res: Response) {
    const pdfBuffer = await this.pdfService.generatePdf(htmlContent);
    res.set({
      'Content-Type': 'application/pdf',
      'Content-Disposition': 'attachment; filename=generated.pdf',
      'Content-Length': pdfBuffer.length,
    });
    res.end(pdfBuffer);
  }
}

IronPDF 用來將 HTML 內容轉換成 PDF 緩衝區，然後用 PdfService 返回。 PdfService 使用 IronPDF 將 HTML 渲染為 PDF。 這種整合很容易通過 NestJS 控制器處理。 接下來的步驟是定義一個 POST 端點 /generate，用來接收來自客戶端的 HTML 內容。 使用 IronPDF 程式庫，我們在 API 內將提供的 HTML 資料轉換成 PDF。

更確切地說，我們使用 pdf.saveAsBuffer() 建立 PDF 文件的二進制緩衝區，並使用 IronPdf.fromHtml(htmlContent) 從 HTML 內容建立 PDF 物件。 接下來，該緩衝區將藉由符合 MIME 型別 (application/pdf) 返回至客戶端。 伺服器監聽在 3000 埠，並記錄任何在 PDF 建立過程中遇到的問題。 響應中，客戶端在出錯時獲得 500 狀態碼。 此設置在建立發票、報告或用於網頁應用程式的其他文件時很有幫助，因為它允許從 HTML 內容動態生成 PDF。