Mit jelent a pipe (cső) és hogyan működik az validáció?

Question

Accepted Answer

**A pipe-ok** olyan osztályok, amelyek **átalakítják vagy validálják** a bemeneti adatokat, mielőtt azok elérnék a route handlert. A kontrollermetódusok argumentumaira hatnak — vagy átalakítják azokat (pl. string → szám), vagy validálják őket (elutasítanak érvénytelen adatokat). A NestJS validációja pipe-okra épül.

## Beépített átalakítási pipe-ok

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

Az átalakítási pipe-ok a bemenetet a helyes típusra konvertálják (a route paraméterek/query-k mindig stringek), és 400-as hibát adnak vissza, ha az átalakítás nem lehetséges.

## A ValidationPipe — automatikus DTO validáció

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

A `ValidationPipe` beolvassa a DTO `class-validator` dekorátorait és automatikusan validálja a bejövő adatokat — részletes 400-as hibát ad vissza hiba esetén, így a handler csak érvényes adatokat fog kapni.

## Hogyan illeszkednek a pipe-ok a kérés folyamatába

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

## Egyéni pipe-ok

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

A `PipeTransform` `transform()` metódusát implementálja az egyéni validációs/átalakítási logikához.

## Pipe-ok alkalmazása különböző szinteken

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

## Miért fontos ez

A pipe-ok a NestJS kulcsfontosságú funkciója a bemenet biztonságos kezeléséhez, és a keretrendszer **validációs rendszerének** az alapja.

Ez azért lényeges, mert gyakorlatilag minden API endpoint-nak validálnia és átalakítania kell a bemenetet: az átalakítási pipe-ok (`ParseIntPipe` stb.) biztosítják, hogy a paraméterek helyes típusúak, és — legfontosabbak — a **`ValidationPipe`** a DTO-kkal kombinálva automatikus, deklaratív validációt nyújt a request body-k számára a `class-validator` szabályok alapján, elutasítva az érvénytelen vagy rosszindulatú bemenetet világos hibákkal, *mielőtt* azok elérnék az üzleti logikát.

Ez kritikus fontosságú a biztonság (nem megbízható bemenet validálása/tisztítása, váratlan tulajdonságok eltávolítása) és robusztusság (handlerek csak érvényes adatokat kapnak) szempontjából.

Annak ismerete, hogyan kell engedélyezni a globális validációs pipe-ot megfelelő beállításokkal (`whitelist`, `transform`), beépített átalakítási pipe-ok használata, és egyéni pipe-ok írása alapvető a biztonságos, jól strukturált NestJS API-k létrehozásához — a pipe-ok és validáció minden nap, nélkülözhetetlen fogalmak a keretrendszerben.