NestJS Node.js (개발자를 위한 작동 방식)

TypeScript 지원

TypeScript JavaScript 의 정적 타입 상위 집합으로, 정교한 자동 완성, 타입 안정성 및 최신 언어 기능을 제공하며, NestJS 구축에 사용됩니다. 이는 코드 유지보수성을 향상시키고 컴파일 과정에서 오류를 감지하는 데 도움이 됩니다. NestJS는 기본적으로 JavaScript 와 TypeScript 모두 지원하여 개발자에게 더 많은 자유를 제공합니다.

모듈형 건축

NestJS는 모듈 기반 코드 구성을 권장합니다. 컨트롤러, 프로바이더, 서비스와 같은 관련 구성 요소를 단일 모듈에 캡슐화하면 코드 유지 관리, 확장 및 구성이 더 쉬워집니다. 이 애플리케이션의 모듈은 다른 분야에서도 활용될 수 있어 DRY(Don't Repeat Yourself) 원칙을 장려합니다.

의존성 주입

NestJS의 주요 기능 중 하나는 정교한 의존성 주입 시스템으로, 이를 통해 의존성 관리가 더욱 쉬워집니다. NestJS는 의존성을 하드코딩하는 대신 주입하는 방식을 통해 느슨하게 연결되고 테스트 가능한 컴포넌트를 생성합니다. 이러한 스타일 덕분에 더욱 모듈화된 코드와 향상된 관심사 분리가 가능해집니다.

장식가들

NestJS에서는 클래스와 해당 멤버를 생성하고 설정하는 데 데코레이터가 많이 사용됩니다. @Controller(), @Get(), @Post(), @Injectable() 등의 데코레이터 사용은 애플리케이션의 각 구성 요소가 무엇을 하고 어떻게 작동하는지를 명확히 하여 코드의 가독성과 표현력을 향상시킵니다.

Express 및 Fastify와의 호환성

NestJS는 뛰어난 적응성 덕분에 개발자가 기본 HTTP 서버로 Fastify 또는 Express를 선택할 수 있도록 해줍니다. Fastify가 더 나은 성능을 제공하지만, Express는 사용자 친화적이고 효율적인 것으로 유명합니다. 이러한 다재다능함 덕분에 개발자는 고유한 요구 사항을 충족하도록 앱을 맞춤 설정할 수 있습니다.

미들웨어

NestJS는 Express와 유사한 미들웨어 기능을 지원합니다. 요청이 라우트 핸들러에 도달하기 전에 미들웨어가 본문 구문 분석, 인증 및 로깅과 같은 기능을 제공하여 요청을 처리할 수 있습니다. 이를 통해 요청 처리를 위한 재사용 가능한 로직을 구현할 수 있습니다.

예외 처리

NestJS는 프로그래머가 고유한 예외 필터를 만들 수 있도록 강력한 예외 처리 시스템을 갖추고 있습니다. 이러한 필터는 표준화된 방식으로 예외를 포착하고 처리함으로써 애플리케이션 전반의 오류 관리 및 응답 일관성을 향상시킬 수 있습니다.

파이프 및 보호 장치

파이프: 데이터 변환 및 유효성 검사는 파이프를 사용하여 수행됩니다. 파이프는 컨트롤러 수준, 라우트 핸들러 수준 또는 전역적으로 구현할 수 있습니다. 검증 및 변환 파이프라인이 내장되어 있으며, 사용자 지정 파이프라인도 만들 수 있습니다.

경비원: 권한 부여 및 인증 로직은 경비원에 의해 구현됩니다. 이들은 사용자 역할이나 권한 확인과 같은 특정 규칙을 활용하여 요청 승인 여부를 결정합니다.

NestJS CLI를 설치하세요

Yarn 또는 npm을 사용하여 NestJS CLI를 먼저 전역적으로 설치하십시오.

npm install -g @nestjs/cli

npm install -g @nestjs/cli

새 프로젝트 만들기

새로운 NestJS 프로젝트를 시작하려면 CLI를 사용하세요. "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 컨트롤러를 통해 쉽게 처리할 수 있습니다. 다음 단계는 클라이언트로부터 HTML 콘텐츠를 받는 POST 엔드포인트 /generate을 정의하는 것입니다. IronPDF 라이브러리를 사용하여 API 내부에서 제공된 HTML 데이터를 PDF로 변환합니다.

좀 더 구체적으로는 pdf.saveAsBuffer()를 사용하여 PDF 파일의 이진 버퍼를 만들고 IronPdf.fromHtml(htmlContent)을(를) 사용하여 HTML 콘텐츠에서 PDF 객체를 만듭니다. 그 후, 적절한 MIME 유형(application/pdf)을 사용하여 이 버퍼를 클라이언트에 반환합니다. 서버는 3000번 포트에서 수신 대기하며 PDF 생성 과정에서 발생한 모든 문제를 로그에 기록합니다. 이에 대한 응답으로 클라이언트는 오류 발생 시 500 상태 코드를 받습니다. 이 설정은 HTML 콘텐츠에서 동적 PDF를 생성할 수 있으므로 웹 애플리케이션용 송장, 보고서 또는 기타 문서를 만들 때 유용합니다.