NestJS dekoratörleri nasıl kullanır?

Question

Accepted Answer

NestJS **TypeScript dekoratörleri** etrafında inşa edilmiştir — sınıflara, metodlara ve parametrelere **metadata** ekleyen özel `@` önekli ek açıklamalar. NestJS bu metadata'yı (reflection aracılığıyla) okuyarak yönlendirme, bağımlılık enjeksiyonu, doğrulama ve daha birçok şeyi deklaratif olarak bağlar. Dekoratörler NestJS'de her yerdedir.

## Neden önemli

Dekoratörler NestJS'nin tanımlayıcı sözdizimsel özelliğidir — tüm çerçeve onlar etrafında organize edilmiştir, bu nedenle nasıl çalıştıklarını anlamak herhangi bir NestJS kodu okumak ve yazmak için gereklidir.

Bunlar **deklaratif**, metadata tabanlı bir yaklaşım sağlarlar: zorunlu yapılandırma yerine, yönlendirme (`@Controller`, `@Get`), bağımlılık enjeksiyonu (`@Injectable`), çapraz işleyen davranış (`@UseGuards`, `@UseInterceptors`) ve doğrulama (`@IsEmail`) tanımlamak için sınıfları, metodları ve parametreleri uygulandıkları yerde ek açıklamalarla işaretlersiniz — özlü ve okunabilir.

Bu metadata-via-reflection mekanizması (Angular ve Java/Spring ek açıklamalarının arkasındaki aynı fikir), NestJS'nin temiz, yapılandırılmış stilini mümkün kılar.

Kategorileri tanımlamak (sınıf, metod, parametre, özellik dekoratörleri), yaygın olanları bilmek ve özel dekoratörler oluşturabilmek temel NestJS yeterliliğidir — dekoratörler neredeyse her özelliğin ifade edildiği yoldur, bu da onları çerçevede anlaşılması gereken ilk ve en önemli şeylerden biri yapar.

## Sınıf dekoratörleri — bir sınıfın rolünü tanımla

```ts
@Controller("users")     // this class is a CONTROLLER, prefix /users
export class UsersController {}

@Injectable()            // this class is a PROVIDER (injectable)
export class UsersService {}

@Module({ ... })         // this class is a MODULE
export class UsersModule {}
```

Sınıf dekoratörleri bir sınıfın NestJS mimarisinde *ne* olduğunu (denetleyici, sağlayıcı, modül) bildirir ve onu yapılandırır.

## Metod dekoratörleri — rotaları eşle ve davranış uygula

```ts
@Get()                   // GET request handler
@Post()                  // POST handler
@Get(":id")              // GET /users/:id
@HttpCode(204)           // set the response status code
@UseGuards(AuthGuard)    // apply a guard to this route
@UseInterceptors(LoggingInterceptor)
findAll() {}
```

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

```ts
findOne(
  @Param("id") id: string,       // route parameter
  @Query("sort") sort: string,   // query string
  @Body() dto: CreateUserDto,    // request body
  @Headers("auth") auth: string, // header
) {}
```

Parametre dekoratörleri deklaratif olarak ihtiyacınız olan verileri istekten çıkarır — manual `req` ayrıştırması yoktur.

## Özellik/doğrulama dekoratörleri (DTO'lar üzerinde)

```ts
export class CreateUserDto {
  @IsEmail()                     // validation rules (class-validator)
  email: string;

@IsString()
  @MinLength(8)
  password: string;
}
```

## Neden dekoratörler? Deklaratif metadata

```text
Decorators attach METADATA that NestJS reads at runtime (via reflection) to:
  ✓ Register routes (@Get, @Controller)
  ✓ Wire dependency injection (@Injectable, @Inject)
  ✓ Apply guards/interceptors/pipes (@UseGuards, etc.)
  ✓ Validate input (@IsEmail, @IsString)
→ Behavior is declared WHERE it applies, concisely and readably.
```

## Özel dekoratörler

```ts
// you can create your own — e.g. extract the current user from the request
export const CurrentUser = createParamDecorator((data, ctx) =>
  ctx.switchToHttp().getRequest().user
);
// usage: findProfile(@CurrentUser() user: User) {}
```