X'inhuma l-kontrolli f'NestJS?

Question

Accepted Answer

**Il-kontrolli** jappuprcessaw **talbiet HTTP** iddaħħla u jirritornaw rispons. Huma jiddefinixxu r-roti tal-applikazzjoni tiegħek u jaġixxu bħala punt ta' dħul — jirċievi talbiet, jestraġu data, jiddellegaw lill-servizzi, u jirritornaw riżultati. Jippreservaw il-concerns ta' ruting separati mill-loġika tan-negozju.

## Tad-definizzjoni ta' kontrollor

```ts
import { Controller, Get, Post, Body, Param } from "@nestjs/common";

@Controller("users")          // the route PREFIX → all routes start with /users
export class UsersController {
  constructor(private usersService: UsersService) {}   // inject a service via DI

@Get()                       // GET /users
  findAll() {
    return this.usersService.findAll();
  }

@Get(":id")                  // GET /users/:id
  findOne(@Param("id") id: string) {        // extract the route param
    return this.usersService.findOne(id);
  }

@Post()                      // POST /users
  create(@Body() dto: CreateUserDto) {       // extract the request body
    return this.usersService.create(dto);
  }
}
```

## Kif taħdem: dekoraturiet imappaw metodi għal roti

```text
@Controller("users") → route prefix /users
@Get() / @Post() / @Put() / @Patch() / @Delete() → HTTP method + sub-path
Combined: @Get(":id") inside @Controller("users") → GET /users/:id
```

Id-dekoraturiet jibindaw b'mod dikjarattiv metodi tal-klassi għal roti HTTP — nadif u faċli biex jinqraw, mingħajr reġistrazzjoni manwali tal-roti.

## Id-dekoraturiet tal-parametru jestraġu data tat-talba

```ts
@Get(":id")
example(
  @Param("id") id: string,        // route parameter (/users/:id)
  @Query("sort") sort: string,    // query string (?sort=name)
  @Body() body: CreateUserDto,    // request body
  @Headers("authorization") auth: string,  // a header
  @Req() req: Request,            // the raw request object (rarely needed)
) {}
```

Id-dekoraturiet tal-parametru ta' Nest (`@Param`, `@Query`, `@Body`, `@Headers`) jiestraġu b'mod nadif eżatt id-data li jkun għandek bżonn — mingħajr parsing manwali ta' `req`.

## Il-kontrolli għandhom ikunu ĦOXNIN

```ts
// ✅ controller delegates to a service — stays thin
@Post()
create(@Body() dto: CreateUserDto) {
  return this.usersService.create(dto);   // business logic lives in the SERVICE
}
// ❌ don't put database queries / business logic directly in the controller
```

Aħjar prattika: żomm il-kontrolli **ħoxnin** — huma jittrattaw il-concerns HTTP (ruting, estrazzjoni ta' data, ritorn ta' rispons) u jiddellegaw il-loġika tan-negozju kollha lill-**servizzi**. Din is-separazzjoni żomm il-kod iċċejjeqbil u organizzat.

## Għaliex huwa importanti

Il-kontrolli huma blokk fundamentali ta' kostruzzjoni ta' NestJS — il-punt ta' dħul għall-talbiet HTTP kollha u fejn ir-roti tal-API tiegħek huma definiti.

Il-fhem ta' kif id-dekoraturiet (`@Controller`, `@Get`/`@Post`, `@Param`/`@Body`/`@Query`) jimappaw metodi għal roti u jestraġu data tat-talba b'mod dikjarattiv huwa għarfien essenzjali ta' kuljum NestJS — dan huwa kif tibni kwalunkwe endpoint.

Bħala importanti huwa l-prinċipju tal-ħolqien tal-kontrolli **ħoxnin** (ittrattaxxejn biss il-concerns HTTP u jiddellegaw il-loġika tan-negozju lill-servizzi injettati), li jembodda l-filosofija ta' separazzjoni tal-concerns ta' NestJS u żomm il-kod iżomannjabbli u iċċejjeqbil.

Il-kontrolli, flimkien mas-servizzi u l-moduli, jiffurmaw l-istruttura ċentrali ta' kull applikazzjoni NestJS, u jagħmluhom essenzjali biex tifhimhom mill-bidu.