NestJS Node.js（开发者如何使用）

TypeScript支持

TypeScript是JavaScript的静态类型超集，提供了高级的自动补全、类型安全和现代语言特性，被用于构建NestJS。 这提高了代码的可维护性，并有助于在编译期间检测错误。 NestJS默认支持JavaScript和TypeScript，为开发人员提供了更大的自由度。

模块化架构

NestJS鼓励基于模块的代码组织。 当将相关组件如控制器、提供者和服务封装在一个模块中时，代码更易于维护、扩展和组织。 应用程序的模块可以在其他区域中使用，促进DRY（不要重复自己）理念。

依赖注入

NestJS的主要功能之一是复杂的依赖注入系统，使得管理依赖关系更加简单。 通过使用注入依赖而不是硬编码它们，NestJS创建松散耦合且可测试的组件。 这种风格还使得更加模块化的代码和更好的关注点分离成为可能。

装饰器

NestJS中大量使用装饰器来创建和设置类及其成员。 使用@Controller()、@Get()、@Post()、@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

创建新项目

使用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内容。 用IronPDF库，在API内部转换所提供的HTML数据为PDF。

更精确地说，通过使用pdf.saveAsBuffer()创建PDF文件的二进制缓冲区，并使用IronPdf.fromHtml(htmlContent)从HTML内容创建PDF对象。 随后，该缓冲区以适当的MIME类型（application/pdf）返回给客户端。 服务器监听在端口3000上，并记录在PDF创建过程中遇到的任何问题。 在响应中，客户端在出错时获得一个500状态码。 此设置有益于为Web应用程序创建发票、报告或其他文档，因为它允许动态创建来自HTML内容的PDF。