Cad iad píopaí agus conas a oibríonn bailíochtú?

Question

Accepted Answer

**Píopaí** ar classes iad a **chlaochlaíonn nó a bhailíonn** sonraí ionchuir sula sroichidh siad láimhseálaí bealaigh. Oibrím siad ar argóintí modhanna rialaitheora — ag claochladh a dhéanann orthu (m.sh. teanga → uimhir) nó ag fíorú a ndílonrú iad (ag diúltú do shonraí neamhbhailí). Tógtar bailíochtú i NestJS ar phíopaí.

## Píopaí claochlaithe ionsuite

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

Athrú píopaí claochlaithe ionchuir chuig an gcineál ceart (bíonn paraiméadair bealaigh/ceiste i gcónaí i teanga), ag teip le 400 mura féidir athrú a dhéanamh.

## An ValidationPipe — bailíochtú DTO uathoibríoch

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

Léann an `ValidationPipe` mairnéalaigh `class-validator` an DTO agus bailíonn sé sonraí ionchuir go huathoibríoch — ag filleadh earráid 400 mionsonraithe ar theipeal, ionas nach bhfaigheann do láimhseálaí ach sonraí bailí i gcónaí.

## Conas a bhíonn píopaí oiriúnach sa sreabh iarratais

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

## Píopaí saincheaptha

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

Cuireadh i bhfeidhm agat modh `transform()` an `PipeTransform` chun loighic bhailíochtaithe/chlaochlaithe saincheaptha a dhéanamh.

## Píopaí a chur i bhfeidhm ar leibhéil dhifriúla

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

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

Is gné ríthábhachtach PIopaí NestJS do ionchur a láimhseáil go sábháilte, agus tá siad mar bhunús **chóras bailíochtaithe** an chreat oibre.

Tá sé riachtanach a thuiscint go bhfuil gá ag beagnach gach crìoch API sonraí a bhailíochtú agus a chlaochlú: cinntíonn píopaí claochlaithe (`ParseIntPipe`, srl.) go bhfuil paraiméadair den chineál ceart, agus — go tábhachtach — cuireann an **`ValidationPipe`** in éineacht le DTOs bailíochtú uathoibríoch, fógarthach de bhalaí iarratais i gcoinne rialacha `class-validator`, ag diúltú do bhonneoga neamhbhailí nó éachtacha a bhí ann le soiléire earráidí *sula* dtéann sé ar ais go do loighic gnó.

Tá sé seo fíorchriticiúil do bhothúchán agus do dhrochghearradh araon (sonraí ionchuir gan mhuinín a bhailíochtú/a ghlanadh, airíonna gan súil a bhaint), agus do dhúthracht (ní fhaigheann láimhseálaithe ach sonraí bailí).

A fhios a bheith agat conas an píopaí bailíochtaithe domhanda a chumasú le roghanna ciallmhara (`whitelist`, `transform`), píopaí claochlaithe ionsuite a úsáid, agus píopaí saincheaptha a scríobh is bunúsach do APIs NestJS sábháilte, struchtúrtha a thógáil — píopaí agus bailíochtú is coincheapa laethúla, ní mór a bheith ar eolas, sa chreat oibre.