Kas yra DTO (duomenų perdavimo objektai) NestJS?

Question

Accepted Answer

**DTO (Data Transfer Object)** yra klasė, kuri apibrėžia **duomenų formą**, siunčiamą į jūsų API arba iš jo — dažniausiai užklausos teksto struktūrą. DTO suteikia tipo saugumą, veikia kaip aiški endpointų sutartis ir (naudojant patvirtinimo dekoratorius) leidžia automatinį įvesties patikrinimą.

## DTO apibrėžimas

```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;
}
```

DTO yra paprastas klasė, aprašanti tikėtiną duomenų rinkinį, su **patvirtinimo dekoratoriais** (iš `class-validator`), nurodančiais taisykles, kurias turi atitikti kiekvienas laukas.

## DTO naudojimas kontroleryje

```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` tipizuoja užklausos tekstą ir — kai patvirtinimo kanalas įjungtas — automatiškai patikrina jį prieš vykdant jūsų tvarkyklę.

## Automatinio patvirtinimo įjungimas

```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
}));
```

Su `ValidationPipe`, NestJS automatiškai patikrina ateinančius tekstus pagal DTO dekoratorius — grąžinant 400 klaidą su detalėmis, jei patikrinimas nepavyksta, dar prieš vykdant jūsų kodą.

## DTO vs Entitys

```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 sąmoningai skiriasi nuo duomenų bazės entitys — jie atspindi tai, ką API priima/grąžina, atsiskyrusias nuo vidinės saugojimo.

## Variacija ir pakartotinis naudojimas

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

## Kodėl tai svarbu

DTO yra svarbi NestJS šablono kurianti tipo saugumą, aiškias API sutartis ir automatinį patikrinimą jūsų endpointuose.

Jie apibrėžia tiksliai, kokius duomenis endpointas priima (užklausos formą), suteikdami jums kompiliavimo laiko tipizavimą ir veikdami kaip savaimiškai dokumentuojamos sutartys.

Žymiai, sujungus su `class-validator` dekoratoriais ir `ValidationPipe`, jie leidžia **automatinį įvesties patikrinimą** — blogai suformuoti arba klastingi užklausimai atmetami su aiškiomis klaidomis *prieš* pasiekiant jūsų verslo logiką, kas yra būtina saugumui ir patikimumui (`whitelist` parinktis taip pat pašalina netikėtas savybes).

Supratimas apie DTO, kaip pridėti patvirtinimo taisykles, kaip įjungti patvirtinimo kanalą ir svarbų principą **laikyti DTO atskirus nuo duomenų bazės entitys** (atskirianti API sutartį nuo vidinės saugojimo) yra pagrindinis dalykas kuriant saugius, gerai struktūrizuotus, palaikomus NestJS API.

DTO pasitaiko beveik kiekviename endpointe, priimančiame įvestį, todėl jie yra kasdieniai, esminiai žinios.