NestJS'de DTO'lar nedir?

Question

Accepted Answer

Bir **DTO (Veri Transfer Nesnesi)**, API'nize gönderilen veya API'den döndürülen verilerin **şeklini** tanımlayan bir sınıftır — tipik olarak bir istek gövdesinin yapısı. DTO'lar tür güvenliği sağlar, uç noktalar için açık bir sözleşme görevi görür ve (doğrulama dekoratörleriyle) otomatik giriş doğrulaması sağlar.

## DTO Tanımlama

```ts
import { IsEmail, IsString, MinLength, IsOptional, IsInt, Min } from "class-validator";

export class CreateUserDto {
  @IsEmail()                    // must be a valid email
  email: string;

@IsString()
  @MinLength(8)                 // password at least 8 chars
  password: string;

@IsOptional()                 // optional field
  @IsInt()
  @Min(0)
  age?: number;
}
```

Bir DTO, beklenen verileri açıklayan sade bir sınıftır ve **doğrulama dekoratörleriyle** (`class-validator`'dan) her alanın yerine getirmesi gereken kuralları belirtir.

## Bir denetleyicide DTO kullanma

```ts
@Post()
create(@Body() dto: CreateUserDto) {     // the body is typed AND validated as CreateUserDto
  // dto is guaranteed to be valid here (with the validation pipe enabled)
  return this.usersService.create(dto);
}
```

`@Body() dto: CreateUserDto` istek gövdesini türlendirir ve — doğrulama borusu etkinleştirilmiş olduğunda — işleyiciniz çalışmadan önce bunu otomatik olarak doğrular.

## Otomatik doğrulamayı etkinleştirme

```ts
// main.ts — turn on the global validation pipe
app.useGlobalPipes(new ValidationPipe({
  whitelist: true,              // strip properties NOT in the DTO (security)
  forbidNonWhitelisted: true,   // reject requests with extra unknown properties
  transform: true,              // auto-transform payloads to DTO instances + convert types
}));
```

`ValidationPipe` ile NestJS, DTO'nuzun dekoratörlerine karşı gelen gövdeleri otomatik olarak doğrular — doğrulama başarısız olursa kodunuz çalışmadan önce ayrıntılarla birlikte 400 hatası döndürür.

## DTO'lar vs Varlıklar

```text
DTO    → the shape of data crossing the API boundary (request/response contract)
Entity → the database model (e.g. a TypeORM entity / Prisma model)
→ Keep them SEPARATE: the API contract shouldn't be coupled to the DB schema.
  (A CreateUserDto has password+email; the User entity has id, timestamps, etc.)
```

DTO'lar kasıtlı olarak veritabanı varlıklarından farklıdır — API'nin kabul ettiği/döndürdüğü şeyi, iç depolamadan ayrı olarak temsil ederler.

## Varyasyonlar ve yeniden kullanım

```ts
import { PartialType } from "@nestjs/mapped-types";
// derive an UpdateUserDto where all fields are optional — no duplication
export class UpdateUserDto extends PartialType(CreateUserDto) {}
```

## Neden önemli

DTO'lar, tür güvenliği, açık API sözleşmeleri ve otomatik doğrulamayı uç noktalarınıza getiren önemli bir NestJS desenidir.

Bir uç noktanın kabul ettiği (istek şekli) verileri tam olarak tanımlayarak derleme zamanı yazımlaması ve kendi kendini belgeleyen sözleşmeler olarak hizmet ederler.

Önemlisi, `class-validator` dekoratörleri ve `ValidationPipe` ile birleştirildiğinde, **otomatik giriş doğrulaması** sağlarlar — hatalı biçimlendirilmiş veya kötü niyetli istekler, iş mantığınıza ulaşmadan önce açık hatalarla reddedilir; bu, güvenlik ve sağlamlık için gereklidir (`whitelist` seçeneği ayrıca beklenmeyen özellikleri çıkarır).

DTO'ları anlamak, doğrulama kurallarını nasıl ekleyeceğinizi, doğrulama borusunu nasıl etkinleştireceğinizi ve **DTO'ları veritabanı varlıklarından ayrı tutmanın** (API sözleşmesini iç depolamadan ayırmak) önemli ilkesini anlamak, güvenli, iyi yapılandırılmış, bakımlanabilir NestJS API'leri oluşturmak için temeldir.

DTO'lar neredeyse giriş kabul eden her uç noktada görünür, bu da onları günlük, gerekli bir bilgi haline getirir.