Mitä ovat Pipes ja miten validointi toimii?

Question

Accepted Answer

**Pipes** ovat luokkia, jotka **muuntavat tai validoivat** syöttötietoja ennen kuin ne saavuttavat reitityksen käsittelijän. Ne toimivat ohjausmetodin argumenteilla — joko muuntamalla ne (esim. string → number) tai validoimalla ne (hylkäämällä virheelliset tiedot). Validointi NestJS:ssä on rakennettu pipesille.

## Sisäänrakennetut muunnosputket

```ts
@Get(":id")
findOne(@Param("id", ParseIntPipe) id: number) {    // transforms "5" (string) → 5 (number)
  // id is guaranteed to be a number; non-numeric input → 400 error automatically
  return this.usersService.findOne(id);
}
// other built-ins: ParseBoolPipe, ParseUUIDPipe, ParseArrayPipe, DefaultValuePipe
```

Muunnosputket muuntavat syöttötiedot oikeaan tyyppiin (reittiparametrit/kyselyt ovat aina stringejä), epäonnistuvat 400:lla, jos muuntaminen ei ole mahdollista.

## ValidationPipe — automaattinen DTO-validointi

```ts
// enable globally in main.ts
app.useGlobalPipes(new ValidationPipe({
  whitelist: true,              // remove properties not declared in the DTO
  forbidNonWhitelisted: true,   // throw if unknown properties are present
  transform: true,              // turn plain objects into DTO instances, convert types
}));
```

```ts
// with a DTO using class-validator decorators:
export class CreateUserDto {
  @IsEmail() email: string;
  @MinLength(8) password: string;
}

@Post()
create(@Body() dto: CreateUserDto) {   // ValidationPipe validates the body automatically
  // if invalid → 400 with details, BEFORE this runs
}
```

`ValidationPipe` lukee DTO:n `class-validator` -koristimia ja validoi saapuvat tiedot automaattisesti — palauttaa yksityiskohtaisen 400-virheen epäonnistuessa, jotta käsittelijäsi saa vain kelvollisia tietoja.

## Kuinka putket sopivat pyyntövirtaan

```text
Request → ...middleware/guards/interceptors... → PIPES (transform/validate) → Handler
Pipes run JUST BEFORE the route handler, operating on its method arguments.
```

## Mukautetut putket

```ts
@Injectable()
export class TrimPipe implements PipeTransform {
  transform(value: any) {
    return typeof value === "string" ? value.trim() : value;   // custom transformation
  }
}
// usage: @Body(TrimPipe) ...
```

You toteuttavat `PipeTransform`in `transform()` -menetelmän mukautetulle validointi-/muunnoslogiikalle.

## Putkien soveltaminen eri tasoilla

```ts
@UsePipes(new ValidationPipe())      // method or controller level
@Param("id", ParseIntPipe)            // parameter level
app.useGlobalPipes(new ValidationPipe())   // global (most common for validation)
```

## Miksi tämä on tärkeää

Putket ovat keskeinen NestJS-ominaisuus turvalliseen syötteiden käsittelyyn, ja ne ovat kehyksen **validointijärjestelmän** perusta.

Niiden ymmärtäminen on olennaista, koska lähes jokainen API-päätepiste tarvitsee validoida ja muuntaa syötteen: muunnosputket (`ParseIntPipe` jne.) varmistavat, että parametrit ovat oikeaa tyyppiä, ja — mikä tärkeintä — **`ValidationPipe`** yhdistettynä DTO-tietoihin tarjoaa automaattisen, julistuksellisen validoinnin pyyntörungoista `class-validator` -sääntöjä vastaan, hylkäämällä virheelliset tai pahalliset syötteet selkeillä virheillä *ennen* kuin ne saavuttavat liiketoimintalogiikan.

Tämä on kriittistä sekä turvallisuuden (epäluotettavan syötteen validointi/puhdistaminen, odottamattomien ominaisuuksien poistaminen) että kestävyyden (käsittelijät saavat vain kelvollisia tietoja) kannalta.

Tietäminen globaalin validointiputken ottamisesta käyttöön järkevillä asetuksilla (`whitelist`, `transform`), sisäänrakennettujen muunnosputkien käyttäminen ja mukautettujen putkien kirjoittaminen on perustavanlaatuista turvallisten, hyvin strukturoitujen NestJS API-sovellusten rakentamiseksi — putket ja validointi ovat päivittäisiä, välttämättömiä käsitteitä kehyksessä.