新的 NestJS Swagger 生成器比以往更强大

新的 NestJS Swagger 生成器

import { NestiaSwaggerComposer } from "@nestia/sdk";
import { INestApplication } from "@nestjs/common";
import { NestFactory } from "@nestjs/core";
import { SwaggerModule } from "@nestjs/swagger";

const main = async (): Promise<void> => {
  const app: INestApplication = await NestFactory.create(ApplicationModule);
  const document = await NestiaSwaggerComposer.document(app, {
    openapi: "3.1",
    servers: [
      {
        url: "http://localhost:3000",
        description: "Localhost"
      }
    ]
  });
  SwaggerModule.setup("api", app, document as any);
  await app.listen(3_000);
};
main().catch(console.error);

OpenAPI (Swagger) 文档生成器在 NestJS 中有了新的进化。

@nestia/sdk 自动分析 NestJS 源代码，在编译级别生成 OpenAPI 文档，无需像 @nestjs/swagger 装饰器函数调用那样额外操作。