Cad iad DTOs i NestJS?

Question

Accepted Answer

Is é **DTO (Data Transfer Object)** ná rang a shainmhíníonn **cruth an dáta** a sheoltar chuig do API nó ó do API — de ghnáth struchtúr an bhreac-chuntas a iarrtar. Cuireann DTOs slándáil chineál ar fáil, feidhmíonn siad mar chonradh soiléir do thoirbhirtí, agus (le deoir bhailíochta) cumasaíonn siad bailíochtú ionchur uathoibríoch.

## DTO a Shainmhíniú

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

Is rang simplí a bhíonn i DTO ag cur síos ar an dáta a bhítear ag súil leis, le **deoir bhailíochta** (ó `class-validator`) a shonraíonn na rialacha a chaithfidh gach réimse a shásamh.

## DTO a Úsáid i Rialtóir

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

Déanann `@Body() dto: CreateUserDto` an breac-chuntas a iarrtar a dhíotáil agus — nuair a bhíonn an píopa bailíochta cumasaithe — bailíonn sé go huathoibríoch sula rithfidh do láimhseoir.

## Bailíochtú Uathoibríoch a Chumasú

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

Leis an `ValidationPipe`, bailíonn NestJS tíortha isteach i gcoinne deoir bhailíochta an DTO go huathoibríoch — ag filleadh earráid 400 le sonraí má theipeann ar bhailíochtú, sula rithfidh do chód.

## DTOs i Gcoinne Aonán

```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.)
```

Atá DTOs athrú go fírinneach ó aonáin bhunachar sonraí — ionadaíonn siad cad a nglacann/a fhilleann an API, scartha ó stóráil inmheánach.

## Athruithe agus Athúsáid

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

## Cén fáth a bhíonn sé tábhachtach

Is patrún tábhachtach NestJS iad DTOs a thugann slándáil chineál, conarthaí API soiléire, agus bailíochtú uathoibríoch do do thoirbhirtí.

Sainmhíníonn siad go díreach cad an dáta a nglacann toirbhirt (an cruth a iarrtar), ag soláthar duit clóchur ama-cóipleála agus feidhmíonn siad mar chonarthaí féin-dhocúmhentaithe.

Go criticiúil, i gcomhpháirt le deoir `class-validator` agus an `ValidationPipe`, cumasaíonn siad **bailíochtú ionchur uathoibríoch** — diúltaítear iarraidh mhíchruinn nó dhrochmhéinmneach le hearráidí soiléire *sula sroichfidh siad do dhramhchód a bhíonn, atá riachtanach do shlándáil agus do bhunchostas (stríopann an rogha `whitelist` maoin gan súil leo freisin).

Tá tuiscint ar DTOs, conas rialacha bailíochta a chur leis, conas an píopa bailíochta a chumasú, agus an prionsabal tábhachtach **DTOs a choinneáil scartha ó aonáin bhunachair sonraí** (scarúchán an conarthaí API ó stóráil inmheánach) bunúsach do API NestJS slán, struchtúrtha, inchothrománach a thógáil.

Tuirlingíonn DTOs i gach toirbhirt beagnach a nglacann ionchur, ag déanamh eolais laethúil, riachtanach díobh.