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

TypeScript Destegi

TypeScript, gelişmiş otomatik tamamlama, tip guvenligi ve modern dil özellikleri sunan JavaScript'in statik tipli bir alt seti, NestJS'nin insasinda kullanilir. Bu, kodun surdurulebilirligini arttirir ve derleme sirasinda hatalrin tespitini yardimci olur. NestJS, TypeScript'in yani sira JavaScript'i de varsıyılan olarak destekleyerek, geliştiricilere daha fazla ozgurluk saglar.

Moduler Mimari

NestJS, moduler tabanli kod organizasyonunu tesvik eder. Kontrolcüler, saglayicılar ve hizmetler gibi ilgili bilesenler tek bir modulde kapsamlandiginda, kodun surdurulmesi, genişletilmesi ve organize edilmesi daha kolay hale gelir. Uygulama modulleri, baska alanlarda kullanilabilir ve DRY (Don't Repeat Yourself) felsefesini tesvik eder.

Bagimli Enjeksiyon

NestJS'nin en buyuk özelliklerinden biri olan gelişmiş bagimli enjeksiyon sistemi, bagimliliklarin yonetimini kolaylastirir. NestJS, bagimliliklari sert kodlama yerine enjekte ederek, gevsek baglantili ve test edilebilir bilesenler yaratir. Bu tarz ayrica, daha moduler kod ve geliştirilmis ilgi ayirimi saglar.

Dekoratorler

NestJS'de siniflarin ve bunlarin uyelerinin oluşturulmasi ve ayarlanmasi icin dekoratorler genis oranda kullanilir. Dekoratörlerin, örneğin @Controller(), @Get(), @Post(), @Injectable() ve diğerleri, kullanımı, uygulamanın her bir bileşeninin ne yaptığını ve nasıl davrandığını ortaya koyarak kodun okunabilirliğini ve ifade edilebilirliğini artırır.

Express ve Fastify ile Uyumluluk

Uyarlanabilirligi nedeniyle, NestJS, geliştiricilere altdaki HTTP sunucusu olarak Fastify veya Express'i kullanma secenegi sunar. Fastify daha iyi performans sunarken, Express, kullanıcı dostu ve etkili olmasi ile unlu. Bu çok yonluluk, geliştiricilerin uygulamalarini ozgu gereksinimlere uygun hale getirmelerine izin verir.

Ara Yazilim

NestJS, Express gibi ara yazilim islevselliklerini destekler. Ara yazilimlar, istekler tanimli rotalarina ulasmadan once ele alinabilir ve bu da govde ayrimi, kimlik doğrulama ve kayıt tutma gibi özellikleri saglar. Bu, yineleyen mantiklarini yazmak icin istekler icin kullanilabilir.

Istisna Yonetimi

NestJS, programcilarin ozel istisna filtreleri oluşturmasina olanak tanıyan guclu bir istisna yonetimi sistemine sahiptir. Bu filtreler, standart bir bicimde istisnalari yakalayarak ve yoneterek uygulama genelinde hatalarin yonetimini düzeltebilir ve yanit tutarliligini Arttırabilir.

Borular ve Koruyucular

Borular: Veri donusumu ve doğrulama, borular kullanilarak yapilir. Borular, kontrolcu duzeyinde, rota yoneticisi duzeyinde veya genel olarak uygulanabilir. Doğrulama ve donusum borulari dahildir ve ozel borular da yapilabilir.

Koruyucular: Koruyucular, yetkilendirme ve kimlik doğrulama icin mantigi uygular. Kullanıcı rolleri veya izinlerini kontrol etmek gibi ozel kurallar kullanarak bir istemin onaylanip onaylanmayacagina karar verirler.

NestJS CLI'yi Yukleyin

Yarn veya npm ile global olarak ilk olarak NestJS CLI'yi yukleyin.

npm install -g @nestjs/cli

npm install -g @nestjs/cli

Yeni Bir Proje Oluşturun

Yeni bir NestJS projesi başlatmak icin CLI kullanin. "my-nest-app"'i istediginiz projenin adina değiştirin.

nest new my-nest-app

nest new my-nest-app

Proje Yapisi

Standart proje yapisi kisa bir ozetidir:

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: Uygulamanin ana kontrolcusunu icerir.
• app.service.ts: Uygulamanin ana hizmetini icerir.
• app.module.ts: Uygulamanin kok module.
• main.ts: Uygulamanin giris noktasi.

Yapılandırma Modulu

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

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 degiskenlerine erişim icin yapılandırma saglayicisini kullanin.

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

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

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

IronPDF'nin Özellikleri

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

Bir PDF Hizmeti Oluşturun

PDF'lerin oluşturulmasını yönetmek için yeni bir hizmet oluşturun. Bu hizmet, IronPDF'yi kullanarak HTML bilgilerini 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;
  }
}

Bir PDF Kontrolcusu Oluşturun

PDF oluşturma icin bir son nokta sunmak icin bir kontrolcu oluşturun.

nest generate controller pdf

nest generate controller pdf

HTML girişi alıp PDF çıktısı veren bir uç nokta oluşturun ve bunu sonuçlanan pdf.controller.ts dosyasında yapın.

// 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 arabelleğine dönüştürmek için kullanılır ve ardından PdfService kullanılarak geri döndürülür. PdfService, HTML'i PDF olarak önderirlemek için IronPDF kullanır. Bu entegrasyon, NestJS kontrolcusu araciligiyla kolayca yonetilir. Bir sonraki adım, istemciden HTML içeriğini almak için bir POST uç noktası /generate tanımlamaktır. IronPDF kutuphanesini kullanarak, saglanan HTML verilerini API icinde bir PDF'ye dönüştüruyoruz.

Daha net olmak gerekirse, pdf.saveAsBuffer() kullanarak PDF dosyasının bir ikili arabelleğini oluşturuyor ve IronPdf.fromHtml(htmlContent) kullanarak HTML içeriğinden bir PDF nesnesi oluşturuyoruz. Bunu takiben, bu arabellek uygun MIME türüyle (application/pdf) istemciye geri döndürülür. Sunucu, PDF oluşturma işlemi sirasinda karsilasilan sorunlari kaydederek port 3000 üzerinden dinler. Yanitta, hata durumunda istemciye 500 durum kodu verilir. Bu ayarlama, web uygulamasi icin faturalar, raporlar veya diğer belgeler oluştururken faydalidir, cunku HTML iceriginden dinamik PDF'ler oluşturulmasina izin verir.