NestJS Node.js (Geliştiriciler İçin Nasıl Çalışır)

TypeScript Desteği

NestJS'in yapımında, JavaScript'in statik tipli bir üst kümesi olan ve gelişmiş otomatik tamamlama, tip güvenliği ve modern dil özellikleri sunan TypeScript kullanılır. Bu, kodun sürdürülebilirliğini artırır ve derleme sırasında hataların tespit edilmesine yardımcı olur. NestJS, geliştiricilere daha fazla özgürlük sunarak varsayılan olarak JavaScript'in yanı sıra TypeScript'i de destekler.

Modüler Mimari

NestJS tarafından modül tabanlı kod organizasyonu teşvik edilmektedir. İlgili bileşenler, kontrolörler, sağlayıcılar ve hizmetler gibi tek bir modülde kapsüllendiğinde, kodu sürdürmek, ölçeklemek ve organize etmek daha kolaydır. Uygulamanın modülleri, başka alanlarda da kullanılabilir, bu da DRY (Kendini Tekrarlama) felsefesini teşvik eder.

Bağımlılık Enjeksiyonu

NestJS'in bağımlılıkları yönetmeyi kolaylaştıran ana özelliklerinden biri gelişmiş bir bağımlılık enjeksiyon sistemidir. Bağımlılıkları doğrudan kodlamak yerine enjekte ederek kullanmak suretiyle, NestJS gevşek bağlı ve test edilebilir bileşenler oluşturur. Bu stil, daha modüler kod ve geliştirilmiş ilgi ayrımını da mümkün kılar.

Dekoratörler

Dekoratörler, sınıfları ve üyelerini oluşturmak ve yapılandırmak için NestJS'de yoğun bir şekilde kullanılır. Uygulamanın her bileşeninin ne yaptığını ve nasıl davrandığını açıkça belirtmelerini sağlayarak @Controller(), @Get(), @Post(), @Injectable() gibi dekoratörlerin kullanımı, kodun okunabilirliğini ve ifadeliğini artırır.

Express ve Fastify ile Uyumluluk

Uyarlanabilirliği sayesinde, NestJS, geliştiricilere Fastify veya Express'i altındaki HTTP sunucusu olarak kullanma seçeneği sunar. Fastify daha iyi performans sağlarken, Express kullanıcı dostu ve verimli olmasıyla ünlüdür. Bu çok yönlülük sayesinde, geliştiriciler uygulamalarını benzersiz gereksinimlere göre uyarlayabilirler.

Ara Katman Yazılımı (Middleware)

NestJS, Express benzeri middleware işlevselliklerini destekler. İstekler rota işleyicilerine ulaşmadan önce, ara katman onları işleyebilir ve gövde ayrıştırma, kimlik doğrulama ve loglama gibi özellikler sunar. Bu, istekleri işlemek için yeniden kullanılabilir mantığın uygulanmasını kolaylaştırır.

İstisna Yönetimi

NestJS, programcıların özel istisna filtreleri oluşturmasına olanak tanıyan güçlü bir istisna yönetim sistemine sahiptir. Bu filtreler, istisnaları standart bir şekilde yakalayarak ve işleyerek uygulama genelinde hata yönetimini ve yanıt birliğini iyileştirebilir.

Boru Hatları ve Koruyucular

Boru Hatları: Veri dönüşümü ve doğrulaması, boru hatları kullanılarak gerçekleştirilir. Bunlar, kontrolör seviyesinde, rota işlemcisi seviyesinde veya genel olarak uygulanabilir. Doğrulama ve dönüşüm boruları yerleşik olarak gelir ve özel borular da oluşturulabilir.

Koruyucular: Yetkilendirme ve kimlik doğrulama mantığı, koruyucular tarafından uygulanır. Bir isteği onaylayıp onaylamamaya karar vermek için, kullanıcı rolleri veya izinleri doğrulama gibi belirli kuralları kullanırlar.

NestJS CLI'yi Kurun

NestJS CLI'yi global olarak kurmak için önce Yarn veya npm kullanın.

npm install -g @nestjs/cli

npm install -g @nestjs/cli

Yeni Bir Proje Oluşturun

Yeni bir NestJS projesi başlatmak için CLI kullanın. "my-nest-app" ifadesini istediğiniz proje adını olacak şekilde değiştirin.

nest new my-nest-app

nest new my-nest-app

Proje Yapısı

Bu, standart proje yapısının kısa bir özetidir:

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: Uygulamanın ana denetleyicisini içerir. app.service.ts: Uygulamanın ana hizmetini içerir.
• app.module.ts: Uygulamanın kök modülü.
• main.ts: Uygulamanın giriş noktası.

Yapılandırma Modülü

Yapılandırmaları yönetmek için @nestjs/config paketini kurun.

npm install @nestjs/config

npm install @nestjs/config

Yapılandırma modülünü app.module.ts dosyasına ekleyin.

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 {}

Ortam değişkenlerine erişmek için yapılandırma hizmetini kullanın.

import { Injectable } from '@nestjs/common';
import { ConfigService } from '@nestjs/config';

@Injectable()
export class AppService {
  constructor(private configService: ConfigService) {}

  getHello(): string {
    return `Hello World!`;
  }
}

IronPDF Özellikleri

npm i @ironsoftware/ironpdf

Bir PDF Servisi Oluşturun

PDF'lerin oluşturulmasını yönetmek için yeni bir servis oluşturun. Bu servis, HTML bilgilerini IronPDF kullanarak PDF'lere dönüştürecektir.

nest generate service pdf

nest generate service pdf

Oluşturulan pdf.service.ts dosyasında PDF oluşturma mantığını uygulayın.

// 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 Kontrolcüsü Oluştur

PDF'lerin oluşturulması için bir uç nokta kullanılabilir yapmak adına bir denetleyici oluşturun.

nest generate controller pdf

nest generate controller pdf

HTML girişi alıp bir PDF çıktısı veren bir uç noktayı sonuç pdf.controller.ts dosyasında oluşturun.

// 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 içeriğini bir PDF tamponuna dönüştürmek için kullanılır ve ardından PdfService kullanılarak geri döndürülür. PdfService, IronPDF kullanarak HTML'yi bir PDF olarak render eder. Bu entegrasyon, NestJS denetleyicisi aracılığıyla kolayca yönetilir. Bir sonraki adım, istemciden HTML içeriği almak için bir POST uç noktası, /generate, tanımlamaktır. IronPDF kütüphanesini kullanarak, sağlanan HTML verilerini API içinde PDF'e dönüştürüyoruz.

Daha kesin olmak gerekirse, PDF dosyasının bir ikili tamponunu pdf.saveAsBuffer() kullanarak oluşturur ve HTML içeriğinden bir PDF nesnesi IronPdf.fromHtml(htmlContent) kullanarak oluştururuz. Ardından bu tampon, uygun MIME türü (application/pdf) ile istemciye geri döndürülür. Sunucu, 3000 portunda dinler ve PDF oluşturma işlemi sırasında karşılaşılan herhangi bir sorunu kaydeder. Müşteri, hata durumunda 500 durum kodu alır. Bu kurulum, HTML içeriğinden dinamik PDF'ler oluşturulmasına izin verdiği için bir web uygulaması için faturalar, raporlar veya diğer belgeler oluştururken yardımcı olur.