https://ozgurvurgun.github.io/nestjs/Recent content in NestJS on @ozgurvurgunHugo -- gohugo.ioen-usozgurvurgunThu, 31 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/1-what-is-nestjs/Tue, 29 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/1-what-is-nestjs/NestJS’e Giriş: Neden Yeni Bir Şeye Daha İhtiyacımız Var? Node.js harika. JavaScript’in gücünü sunucu tarafına taşıdı, “Aynı dili hem frontend’de hem backend’de kullanma” rüyasını gerçeğe dönüştürdü. Ama ne zaman ki işler büyüdü, bu özgürlük başımıza bela olmaya başladı. Çünkü: Herkes her şeyi her yerde yapabiliyordu. Proje büyüdükçe dosyalar çöplüğe dönebiliyordu. Kod tekrarları, karışık business logic, zor test edilebilir yapılar ortaya çıkıyordu. İşte NestJS burada sahneye çıkıyor. NestJS Nedir? NestJS, TypeScript ile yazılmış, modüler bir backend framework’üdür.https://ozgurvurgun.github.io/nestjs/2-ilk-nestjs-uygulamasi/Tue, 29 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/2-ilk-nestjs-uygulamasi/NestJS Projesine İlk Adım Artık teoriyi kenara bırakıp işe girişme zamanı. Bu yazıda, sıfırdan bir NestJS projesi oluşturup çalıştıracağız. “Hello World” endpoint’imizi yazacak, klasörleri tanıyacak, ve uygulamanın yaşam döngüsünü anlayacağız. Amaç: NestJS’e dair temel taşları yerine oturtmak. Ezberlemeden, sindirerek ilerlemek. 1. NestJS CLI ile Proje Oluşturma NestJS, Angular’dan esinlenmiş bir yapı sunduğu için, benzer şekilde bir CLI (Command Line Interface) aracı sunar. Kurulum: npm i -g @nestjs/cli Yeni proje oluştur:https://ozgurvurgun.github.io/nestjs/3-nestjs-mimarisi-temel-kavramlar-1/Tue, 29 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/3-nestjs-mimarisi-temel-kavramlar-1/Neden Modül? Küçük projelerde her şeyi tek dosyada yazmak kolaydır. Ama işler büyüyünce işler sarpa sarar. Kod karmaşıklaşır, neyin nerede olduğunu bulmak zorlaşır. İşte burada modüller devreye girer. NestJS, Angular’dan aldığı ilhamla “her şey bir modülün içinde” prensibiyle çalışır. Bir modül, belirli bir işlevi yerine getiren yapıları gruplar: controller’lar, service’ler, provider’lar… 1. Modül Nedir? NestJS’te her yapı bir modülün içinde yaşar. Modül; bağımsız, izole, bir iş parçasını temsil eden bir yapıdır.https://ozgurvurgun.github.io/nestjs/4-nestjs-mimarisi-temel-kavramlar-2/Tue, 29 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/4-nestjs-mimarisi-temel-kavramlar-2/Modüller Arası İletişim Neden Önemlidir? Modülleri ayırdık ama gerçek hayatta işler böyle izole ilerlemez. Örneğin: Kullanıcı kaydı yapılınca log’a bir şey yazmak isteyebilirsin. Bir ödeme alınınca stok sistemini bilgilendirmek isteyebilirsin. Yani modüllerin birbiriyle konuşması gerekir. NestJS bunu imports, exports ve dependency injection sistemleriyle sağlar. Temel Kurgu: Service Kullanmak Senaryomuz şu: UserService adında bir servisimiz var (UserModule içinde) AuthModule bu servisi kullanmak istiyor (örneğin kullanıcıyı veritabanında sorgulamak için) Şöyle bir şey yapmak istiyoruz:https://ozgurvurgun.github.io/nestjs/5-nestjs-mimarisi-temel-kavramlar-3/Tue, 29 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/5-nestjs-mimarisi-temel-kavramlar-3/Dinamik Modül Nedir? Normal modüller sabittir. İçine neyi yazdıysan, sistem onu kullanır. Ama bazen bir modülün kurulum aşamasında parametre alması gerekir. Yani modülün davranışı dışarıdan gelen bir yapılandırmaya göre değişmelidir. İşte burada dinamik modül devreye girer. Gerçek Hayat Senaryosu Diyelim ki bir MailerModule yazıyorsun. Geliştirme ortamında log’a yazmasını, Gerçek ortamda ise SMTP sunucusuna mail atmasını istiyorsun. Yani modül şunu demeli: “Ben dışarıdan bana nasıl davranacağım söylensin istiyorum.” Nasıl Tanımlanır? Dinamik modül, static register() veya static registerAsync() metotlarıyla tanımlanır.https://ozgurvurgun.github.io/nestjs/6-nestjs-mimarisi-temel-kavramlar-4/Tue, 29 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/6-nestjs-mimarisi-temel-kavramlar-4/Global Modül Nedir? NestJS’te bir modül normalde sadece import edildiği yerde kullanılır. Yani UserModule içinde tanımlı bir UserService, sadece onu import eden modüller tarafından erişilebilir. Ama bazı modüller vardır ki: “Beni her yerden erişilebilir yap” demek ister. İşte bu tür modüller için global modül kavramı vardır. Nasıl Tanımlanır? Bir modülü global yapmak için @Global() dekoratörünü kullanırız. // logger.module.ts @Global() @Module({ providers: [LoggerService], exports: [LoggerService], }) export class LoggerModule {} Artık bu modülü AppModule‘de bir kez import etmek yeterlidir:https://ozgurvurgun.github.io/nestjs/7-nestjs-mimarisi-temel-kavramlar-5/Tue, 29 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/7-nestjs-mimarisi-temel-kavramlar-5/Controller Nedir? NestJS’te Controller, gelen HTTP isteklerini karşılayan yapıdır. Yani dış dünyadan gelen tüm GET, POST, PUT, DELETE istekleri burada karşılanır. Kısaca: Controller = API’nin giriş noktasıdır. Router mı bu? Express kullanmış olanlar için şöyle bir benzetme yapalım: // Express app.get('/users', handler); // NestJS @Controller('users') export class UserController { @Get() getAll() { return 'user listesi'; } } Arka planda aslında Express (veya Fastify) hala çalışıyor. Ama NestJS bunu sınıflar ve dekoratörlerle daha okunabilir ve organize bir hâle getiriyor.https://ozgurvurgun.github.io/nestjs/8-nestjs-mimarisi-temel-kavramlar-6/Tue, 29 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/8-nestjs-mimarisi-temel-kavramlar-6/NestJS’te Request ve Response Nesneleri NestJS, altında Express (veya Fastify) kullanır. Yani istersen alışılagelmiş req, res nesnelerine erişebilirsin. Ama NestJS bunun yerine decorator temelli bir yaklaşım sunar. Yani doğrudan req.body yerine @Body() kullanırsın. res.send() yerine doğrudan return yaparsın. Peki nasıl ve neden? @Req() ve @Res() Nedir? @Req(): HTTP isteğini temsil eden Request objesini verir. (Express tipindedir) @Get() handleRequest(@Req() req: Request) { console.log(req.headers['user-agent']); return 'Gelen istek işlendi'; } @Res(): Manuel olarak yanıt oluşturmak istediğinde kullanılır.https://ozgurvurgun.github.io/nestjs/9-nestjs-mimarisi-temel-kavramlar-7/Tue, 29 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/9-nestjs-mimarisi-temel-kavramlar-7/HTTP Status Code Nedir? Neden Önemlidir? Bir API sadece veri döndürmez. Her cevabın bir anlamı olmalıdır. Bu anlamı taşıyan şey de status code’tur. return { message: 'Başarılı!' }; Bu cevap 200 OK ile gelir mi? 201 Created mi? Yoksa 400 Bad Request mi? İşte bu çok kritik. Çünkü: Status code = İstemciye ne olduğunu anlatan işaret lambasıdır. NestJS’te Status Code Nasıl Yönetilir? En sade yol: @HttpCode() dekoratörüdür. @Post() @HttpCode(201) createUser() { return { message: 'Kullanıcı oluşturuldu' }; } Bu örnekte POST /users isteğine dönüş 201 Created olacaktır.https://ozgurvurgun.github.io/nestjs/10-nestjs-mimarisi-temel-kavramlar-8/Wed, 30 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/10-nestjs-mimarisi-temel-kavramlar-8/Hata Fırlatmak Yetmez, Yakalamak da Gerekir Hatalar kaçınılmaz. Ama kontrolsüz hata = üretimde patlayan sistem = sinirli müşteri = uykusuz geliştirici. NestJS bu durumu çözmek için merkezî bir hata yakalama mekanizması sunar: Global Exception Filter Şimdiye Kadar Ne Yaptık? Şöyle kodlar yazdık: if (!userExists(id)) { throw new NotFoundException('Kullanıcı bulunamadı'); } Ve Nest bunu alıp güzelce 404 yanıtıyla döndü. Harika. Ama ya özel bir hata sınıfı yazmak istiyorsan? Ya da her hatayı { status, errorCode, message, timestamp } gibi özel bir formatta döndürmek istiyorsan?https://ozgurvurgun.github.io/nestjs/11-nestjs-mimarisi-temel-kavramlar-9/Wed, 30 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/11-nestjs-mimarisi-temel-kavramlar-9/HTTP İsteği Sadece Body’den İbaret Değil API’ye gelen her istek 3 temel veri kaynağı taşır: Body -> İçerik, payload Query -> Filtre, arama, sayfalama gibi şeyler Headers -> Kimlik, token, dil bilgisi, içerik türü Ve bunların her biri farklı ihtiyaçlara hizmet eder. NestJS bu üçüne de ayrı dekoratörler sunar. Bu bölümde @Query() ve @Headers() üzerinde duracağız. @Query() - Sorgu Parametrelerini Okumak Örnek URL: GET /products?page=2&limit=10&sort=price Bu URL’deki page, limit ve sort kısmı query parametresidir.https://ozgurvurgun.github.io/nestjs/12-nestjs-mimarisi-temel-kavramlar-10/Wed, 30 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/12-nestjs-mimarisi-temel-kavramlar-10/Rota Yönetiminde Bir Seviye Yukarı: Wildcard ve Prefix Kullanımı Normalde rotaları şöyle tanımlarız: @Controller('users') export class UserController { @Get() getAll() { ... } @Get(':id') getById(@Param('id') id: string) { ... } } Ama bazı durumlarda daha esnek tanımlamalar gerekebilir: Tüm istekleri karşılayan bir “catch-all” route Belirli bir grup route’a ön ek tanımlama Statik dosyalar, client-side SPA fallback gibi durumlar İşte burada wildcard ve prefix kavramları devreye giriyor. 1. Route Prefix Nedir? Prefix, bir grup route’un başına otomatik olarak eklenen ortak path’tir.https://ozgurvurgun.github.io/nestjs/13-nestjs-mimarisi-temel-kavramlar-11/Thu, 31 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/13-nestjs-mimarisi-temel-kavramlar-11/NestJS’te Her Şey Bir Provider’dır NestJS’te controller, service, guard, pipe, hatta resolver… Bunların hepsi özünde birer provider’dır. Provider = Nest container’ına tanıtılan ve başka yerlerden inject edilebilen bir “şey”dir. Sen bir service yazarsın, onu @Injectable() yaparsın - bu, Nest’e şunu demektir: “Bunu bir yerde kullanmak isteyeceğim, lütfen enjekte edilebilir hale getir.” En Temel Kullanım: Servis Olarak Provider @Injectable() export class UserService { findAll() { return ['Ali', 'Ayşe']; } } Bu sınıf bir provider olur.https://ozgurvurgun.github.io/nestjs/14-nestjs-mimarisi-temel-kavramlar-12/Thu, 31 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/14-nestjs-mimarisi-temel-kavramlar-12/Controller İş Yapar, Service İşletir NestJS mimarisinde Controller, dış dünyayla konuşan yerdir. Ama işin mantığı, hesaplama, veri işleme gibi şeyler Service içinde olmalıdır. Controller = sekreter. Çağrıyı alır, ilgili departmana yönlendirir. Service = departman. Gerçek işi yapar. Eğer her şeyi controller içinde yaparsan: Test yazmak zorlaşır Kod tekrar eder Modülerlik kaybolur API karmaşıklaşır Service Tanımlamak: En Temel Hali @Injectable() export class UserService { private users = ['Ayşe', 'Fatma', 'Hayriye']; findAll() { return this.https://ozgurvurgun.github.io/nestjs/15-nestjs-mimarisi-temel-kavramlar-13/Thu, 31 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/15-nestjs-mimarisi-temel-kavramlar-13/“Business Logic” Ne Demek? Kodda her şey teknik olmak zorunda değil. Bir de işin iş tarafı (business) var. Kullanıcı kayıt olurken e-posta eşsiz olmalı Bir ürün stoğu sıfırsa sepete eklenememeli Hafta sonu sipariş geçersiz sayılmalı Bunlar framework’le değil, iş modeliyle ilgili kurallardır. Ve işte bunlara business logic denir. Peki Bu Kurallar Nereye Yazılır? Controller’a yazarsan: Kodun şişer. Test yazmak eziyet olur. Entity’ye yazarsan: Veritabanına fazla sorumluluk yüklersin. Pipe’a yazarsan: Genellikle sadece doğrulama yapılır.https://ozgurvurgun.github.io/nestjs/16-nestjs-mimarisi-temel-kavramlar-14/Thu, 31 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/16-nestjs-mimarisi-temel-kavramlar-14/Provider Ne Demekti? NestJS’de bir class veya değer, “provider” olarak tanımlanırsa constructor() içinde @Inject() ile enjekte edilebilir. Yani dependency injection sistemine kayıtlı olur. Ama bu provider illa bir class olmak zorunda değil. İşte tam burada 3 farklı yol devreye giriyor: Tür Ne Sağlar? Ne Zaman Kullanılır? Value Provider Sabit bir değer (obj, string, sayı) Config, sabit ayarlar, env verileri Class Provider Alternatif class tanımı Mock servis, farklı implementasyonlar Factory Provider Fonksiyonla üretilen provider Dinamik yapı, config’e bağlı servis üretimi 1.https://ozgurvurgun.github.io/nestjs/17-nestjs-mimarisi-temel-kavramlar-15/Thu, 31 Jul 2025 00:00:00 +0000https://ozgurvurgun.github.io/nestjs/17-nestjs-mimarisi-temel-kavramlar-15/Bir Servis, Herkes İçin Aynı mıdır? NestJS’te @Injectable() bir sınıf tanımladığında, varsayılan olarak bu servis singleton olur: Tüm uygulama boyunca sadece 1 kez oluşturulur ve herkes aynı örneği kullanır. Ama bu her zaman ideal değildir. Bazı durumlarda: Her HTTP isteği için yeni bir örnek gerekebilir (örneğin kullanıcıya özel veri taşımak) Her dependency injection noktası farklı bir örnek almalıdır İşte burada scope kavramı devreye girer. 3 Temel Scope Türü Scope Yaşam Süresi Kullanım Senaryosu SINGLETON Tüm uygulama boyunca 1 örnek Varsayılan, çoğu servis bu olur REQUEST Her HTTP isteği için yeni Kullanıcıya özel veri tutan servisler TRANSIENT Her kullanımda yeni örnek Paylaşılmaması gereken servisler (stateless) 1.