Mitä ovat DTOt NestJS:ssä?

Question

Accepted Answer

**DTO (Data Transfer Object)** on luokka, joka määrittelee **datan muodon**, joka lähetetään API:sta tai API:iin — tyypillisesti pyynnön rungon rakenne. DTOt tarjoavat tyypin turvallisuuden, toimivat selkeänä sopimusmuotona päätepisteille, ja (validointikorjaajien kanssa) mahdollistavat automaattisen tulojen validoinnin.

## DTOn määrittäminen

```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 on tavallinen luokka, joka kuvaa odotettua dataa **validointikorjaajilla** (`class-validator`-pakkauksesta), jotka määrittelevät säännöt, jotka jokaisen kentän on täytettävä.

## DTOn käyttäminen kontrollerissa

```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` kirjoittaa pyynnön rungon ja — kun validointisarja on käytössä — validoi sen automaattisesti ennen kuin käsittelijäsi ajetaan.

## Automaattisen validoinnin ottaminen käyttöön

```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`-palvelu validoi saapuvia runkoja DTOn korjaajia vastaan automaattisesti — palauttaen 400-virheen yksityiskohtien kanssa, jos validointi epäonnistuu, ennen kuin koodisi ajetaan.

## DTOt vs entiteetit

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

DTOt eroavat tarkoituksella tietokantaentiteeteistä — ne edustavat, mitä API hyväksyy/palauttaa, eriytettyinä sisäisestä tallennuksesta.

## Vaihtelut ja uudelleenkäyttö

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

## Miksi sillä on merkitystä

DTOt ovat tärkeä NestJS-kuvio, joka tuo tyypin turvallisuuden, selkeät API-sopimukset ja automaattisen validoinnin päätepisteillesi.

Ne määrittelevät täsmälleen, mitä dataa päätepisteesi hyväksyy (pyynnön muoto), antaen sinulle käännösaikaisen kirjoituksen ja toimien itsestään dokumentoivina sopimuksina.

Ratkaisevasti, yhdessä `class-validator`-korjaajien ja `ValidationPipe`-palvelun kanssa, ne mahdollistavat **automaattisen tulojen validoinnin** — väärät muodostetut tai pahalliset pyynnöt hylätään selkeillä virheillä *ennen kuin* ne saavuttavat liiketoimintalogiikkaa, mikä on olennaista turvallisuudelle ja kestävyydelle (`whitelist`-vaihtoehto poistaa myös odottamattomia ominaisuuksia).

DTOiden ymmärtäminen, kuinka lisätä validointisääntöjä, kuinka ottaa validointisarja käyttöön, ja tärkeä periaate **DTOiden pitämisestä erillään tietokantaentiteeteista** (API-sopimuksen eristäminen sisäisestä tallennuksesta) on perustavanlaatuista turvallisten, hyvin strukturoitujen, ylläpidettävien NestJS-sovellusliittymien rakentamista varten.

DTOt esiintyvät lähes jokaisessa päätepisteessä, joka hyväksyy syöttöä, mikä tekee niistä jokapäiväistä, olennaista tietoa.