NestJS Node.js (開発者向けのしくみ)

TypeScriptサポート

JavaScriptの静的型付きサブセットであるTypeScriptは、洗練されたオートコンプリート、型安全性、そしてモダンな言語機能を提供し、NestJSの構築に使用されています。 これにより、コードの保守性が向上し、コンパイル時にエラーを検出するのに役立ちます。 NestJSはデフォルトでJavaScriptだけでなくTypeScriptもサポートし、開発者により多くの自由を与えます。

モジュラーアーキテクチャ

NestJSはモジュールベースのコード管理を奨励します。 コントローラ、プロバイダー、およびサービスのような関連するコンポーネントを1つのモジュールでカプセル化することで、コードの保守、スケール、組織化が容易になります。 アプリケーションのモジュールは他のエリアでも使用可能で、DRY（Don't Repeat Yourself）哲学を促進します。

依存注入

依存管理を容易にするNestJSの主な特徴の1つが洗練された依存注入システムです。 依存関係をハードコーディングせずに注入することにより、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コントローラーを介して簡単に扱えます。 次のステップは、クライアントからHTMLコンテンツを受信するPOSTエンドポイント、/generateを定義することです。 プロバイドされたHTMLデータをAPIの内部でPDFに変換するためにIronPDFライブラリを使用します。

より具体的には、pdf.saveAsBuffer()を使用してPDFファイルのバイナリバッファーを作成し、IronPdf.fromHtml(htmlContent)を使用してHTMLコンテンツからPDFオブジェクトを作成します。 その後、このバッファーはクライアントに適切なMIMEタイプ（application/pdf）で返されます。 サーバーはポート3000でリッスンし、PDF作成プロセス中に遭遇した問題をログに記録します。 エラーが発生した場合、クライアントにはステータスコード500が返されます。 この設定により、ウェブアプリケーションのインボイス、レポート、またはその他のドキュメントを作成する際に、HTMLコンテンツから動的なPDFを作成できるからです。