NestJS'te routing nasıl çalışır?

Question

Accepted Answer

**Routing** NestJS'te **decorator tabanlıdır**: URL yollarını ve HTTP yöntemlerini dekoratörleri kullanarak denetleyici yöntemlerine eşlersiniz. Rota öneki `@Controller()` öğesinden ve belirli yol + HTTP fiili `@Get()` gibi yöntem dekoratörlerinden gelir — bunlar birleşerek tam rotayı oluştururlar.

## Rotalar nasıl oluşturulur

```ts
@Controller("users")          // PREFIX: all routes start with /users
export class UsersController {
  @Get()                       // GET /users
  findAll() {}

@Get("active")               // GET /users/active
  findActive() {}

@Get(":id")                  // GET /users/:id (dynamic parameter)
  findOne(@Param("id") id: string) {}

@Post()                      // POST /users
  create(@Body() dto: CreateUserDto) {}

@Put(":id")                  // PUT /users/:id
  update(@Param("id") id: string, @Body() dto: UpdateUserDto) {}

@Delete(":id")               // DELETE /users/:id
  remove(@Param("id") id: string) {}
}
```

Denetleyici öneki + yöntem dekoratörünün yolu birleştirilir: `@Controller("users")` içindeki `@Get(":id")` → `GET /users/:id`. Her HTTP fiilinin kendi dekoratörü vardır (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Rota parametreleri ve sorgu dizeleri

```ts
@Get(":id")
example(
  @Param("id") id: string,        // path param: /users/123 → id = "123"
  @Query("sort") sort: string,    // query: /users?sort=name → sort = "name"
  @Query() allQuery: any,         // the whole query object
) {}
```

## İç içe/joker rotalar ve alt yollar

```ts
@Controller("users")
export class UsersController {
  @Get(":id/posts")              // GET /users/:id/posts (nested resource)
  getUserPosts(@Param("id") id: string) {}

@Get("search/*")               // wildcard matching
  search() {}
}
```

## Rota sırası önemlidir

```ts
@Get("active")    // ✅ specific route FIRST
findActive() {}
@Get(":id")        // dynamic route AFTER — else "active" would match :id
findOne() {}
```

Belirli (statik) rotalar, dinamik (`:param`) olanlardan önce bildirilmelidir, aksi takdirde dinamik rota bunları yakalayabilir.

## Küresel önek ve sürüm oluşturma

```ts
app.setGlobalPrefix("api/v1");   // all routes become /api/v1/...
// NestJS also supports API versioning (URI, header, media-type based)
```

Küresel bir önek (ör. `/api/v1`) tüm rotalar için geçerlidir — API kuralları için yaygındır.

## Neden önemli

Routing temeldir — API'nizin URL yapısını tanımlar ve her istek doğru işleyiciye nasıl ulaşacağını belirler.

NestJS'te **decorator tabanlı routing** anlayışı (`@Controller` öneki `@Get`/`@Post`/vb. yöntem dekoratörleriyle birleşerek tam rotalar oluşturu ve `@Param`/`@Query` veriyi çıkarmak için) bu temel, günlük bilgidir — bu her bitiş noktasının nasıl oluşturulacağıdır ve bildirime dayalı stil, manuel rota kaydına kıyasla routing'i temiz ve okunabilir tutar.

Praktik ayrıntıları bilmek — önekleri ve yolları birleştirme, rota parametrelerini ve sorgu dizelerini işleme, iç içe kaynak rotaları, **rota sırası** (dinamikten önce statik) önemini ve API kuralları için küresel önekler/sürüm oluşturma — NestJS'te iyi yapılandırılmış REST API'leri oluşturmak için gereklidir.

Routing, denetleyiciler ve parametre dekoratörleri birlikte çerçevenin istek işleme temelini oluştururlar, bu da bunu her NestJS geliştirici için temel, bilmesi gereken bir konu haline getirir.