NestJS'te controller'lar nedir?

Question

Accepted Answer

**Controller'lar** gelen **HTTP isteklerini** işler ve yanıtlar dönerler. Uygulamanızın rotalarını tanımlarlar ve giriş noktası olarak hareket ederler — istekleri alırlar, verileri çıkarırlar, hizmetlere devrederler ve sonuçları dönerler. Yönlendirme kaygılarını iş mantığından ayrı tutarlar.

## Controller tanımlama

```ts
import { Controller, Get, Post, Body, Param } from "@nestjs/common";

@Controller("users")          // the route PREFIX → all routes start with /users
export class UsersController {
  constructor(private usersService: UsersService) {}   // inject a service via DI

@Get()                       // GET /users
  findAll() {
    return this.usersService.findAll();
  }

@Get(":id")                  // GET /users/:id
  findOne(@Param("id") id: string) {        // extract the route param
    return this.usersService.findOne(id);
  }

@Post()                      // POST /users
  create(@Body() dto: CreateUserDto) {       // extract the request body
    return this.usersService.create(dto);
  }
}
```

## Nasıl çalışır: dekoratörler metotları rotalara eşler

```text
@Controller("users") → route prefix /users
@Get() / @Post() / @Put() / @Patch() / @Delete() → HTTP method + sub-path
Combined: @Get(":id") inside @Controller("users") → GET /users/:id
```

Dekoratörler bildirimsel olarak sınıf metotlarını HTTP rotalarına bağlarlar — temiz ve okunabilir, manuel rota kaydı yok.

## Parametre dekoratörleri istek verilerini çıkarır

```ts
@Get(":id")
example(
  @Param("id") id: string,        // route parameter (/users/:id)
  @Query("sort") sort: string,    // query string (?sort=name)
  @Body() body: CreateUserDto,    // request body
  @Headers("authorization") auth: string,  // a header
  @Req() req: Request,            // the raw request object (rarely needed)
) {}
```

Nest'in parametre dekoratörleri (`@Param`, `@Query`, `@Body`, `@Headers`) ihtiyacınız olan verileri temizce çıkarırlar — `req` için manuel ayrıştırma yok.

## Controller'lar İNCE olmalı

```ts
// ✅ controller delegates to a service — stays thin
@Post()
create(@Body() dto: CreateUserDto) {
  return this.usersService.create(dto);   // business logic lives in the SERVICE
}
// ❌ don't put database queries / business logic directly in the controller
```

En iyi uygulama: controller'ları **ince** tutun — HTTP kaygılarını (yönlendirme, veri çıkarma, yanıt döndürme) idare ederler ve tüm iş mantığını **hizmetlere** devrederler. Bu ayrım kodu test edilebilir ve organize tutar.

## Neden önemli

Controller'lar NestJS'nin temel bir yapı taşıdır — tüm HTTP isteklerine giriş noktası ve API'nizin rotalarının tanımlandığı yerdir.

Dekoratörlerin (`@Controller`, `@Get`/`@Post`, `@Param`/`@Body`/`@Query`) metotları rotalara nasıl eşlediğini ve istek verilerini bildirimsel olarak nasıl çıkardığını anlamak, her gün kullanılan temel NestJS bilgisidir — herhangi bir endpoint oluştururken bunu kullanırsınız.

Eşit derecede önemli olan, controller'ları **ince** tutma ilkesidir (yalnızca HTTP kaygılarını idare edin ve iş mantığını enjekte edilen hizmetlere devredin), bu da NestJS'nin endişelerin ayrılması felsefesini somutlaştırır ve kodu bakımı yapılabilir ve test edilebilir tutar.

Controller'lar, hizmetler ve modüller ile birlikte, her NestJS uygulamasının temel yapısını oluştururlar ve bunları başından itibaren anlamak zorunludur.