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

TypeScript 支持

NestJS 的構建使用了 TypeScript，一種靜態型別的 JavaScript 超集，提供先進的自動完成功能、型別安全性和現代語言功能。 這增加了程式碼的可維護性，並幫助在編譯過程中檢測錯誤。 NestJS 預設支持 JavaScript 和 TypeScript，給予開發人員更多自由。

模組化架構

NestJS 鼓勵使用基於模組的代碼組織。 當相關組件（如控制器、提供者和服務）封裝在一個模組中時，代碼更容易維護、擴展和組織。 應用程式的模組可以在其他區域中使用，鼓勵 DRY（Don't Repeat Yourself）原則。

依賴注入

NestJS 的主要特徵之一是具有複雜的依賴注入系統，使得依賴管理變得更容易。 通過使用注入而不是硬編碼依賴關系，NestJS 創建了鬆耦合且可測試的組件。 這種風格還使更模組化的代碼和改進的關心分離成為可能。

裝飾器

在 NestJS 中廣泛使用裝飾器來創建和設置類及其成員。 通過使用如 @Controller()、@Get()、@Post()、@Injectable() 等裝飾器，使程式碼的可讀性和表達性得到提升，因為每個應用程式組件的作用及其行為都變得清晰明了。

與 Express 和 Fastify 的兼容性

由於其適應性，NestJS 為開發人員提供使用 Fastify 或 Express 作為底層 HTTP 伺服器的選項。 雖然 Fastify 提供更好的性能，但 Express 因其易於使用和高效而聞名。 由於這種靈活性，開發人員可以根據具體需求自訂其應用程式。

中間件

NestJS 支持 Express 類似的中間件功能。 中間件可以在請求到達路由處理器之前處理它們，提供如主體解析、身份驗證和日誌記錄等功能。 這促進了可重用策略在處理請求中的實施。

例外處理

NestJS 具有強大的例外處理系統，允許程序員創建自定義的例外篩選器。 這些篩選器可以通過以標準化的方式捕獲並處理例外，提高應用程式的錯誤管理和響應一致性。

Pipes 和 Guards

Pipes: Pipes 用於實現數據轉換和驗證。它們可以在控制器級別、路由處理器級別或全局實施。 內置了驗證和轉換 Pipes，也可以製作自定義的 Pipes。

Guards: Guards 實現許可和認證的邏輯。 它們利用特定的規則來決定是否允許某請求，例如檢查用戶角色或許可權。

安裝 NestJS CLI

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

npm install -g @nestjs/cli

npm install -g @nestjs/cli

創建新專案

使用 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 install @ironsoftware/ironpdf

npm install @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 內容。 在 API 中，我們使用 IronPDF 庫將提供的 HTML 資料轉換為 PDF。

更具體地，我們使用 pdf.saveAsBuffer() 創建 PDF 文件的二進製緩衝區，並使用 IronPdf.fromHtml(htmlContent) 從 HTML 內容創建 PDF 對象。 隨後，這個緩衝區以相應的 MIME 類型 (application/pdf) 返回給客戶端。 伺服器監聽在端口 3000 上，並記錄 PDF 創建過程中遇到的任何問題。 客戶端在錯誤時收到 500 狀態碼作為回應。 這個設置有助於創建發票、報表或其他文檔的Web應用程式，因為它允許從 HTML 內容動態創建PDF。