Çfarë janë kontrollerët në NestJS?

Question

Accepted Answer

**Kontrollerët** trajtojnë **kërkesa HTTP** të ardhura dhe kthejnë përgjigje. Ata përcaktojnë rutët e aplikacionit tuaj dhe veprojnë si pika hyrëse — duke marrë kërkesa, ekstraktuar të dhëna, duke deleguar në shërbime dhe kthyer rezultate. Ata mbajnë problematikat e rrugëzimit të ndara nga logjika e biznesit.

## Përcaktimi i një kontroleri

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

## Si funksionon: dekoratorët hartëzojnë metodat në rute

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

Dekoratorët lidhtin në mënyrë deklarative metodat e klasës me rutë HTTP — të pastër dhe të lehtë për t'u lexuar, pa regjistrim manual të rutëve.

## Dekoratorët e parametrave ekstraktojnë të dhëna kërkese

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

Dekoratorët e parametrave të Nest (`@Param`, `@Query`, `@Body`, `@Headers`) ekstraktojnë në mënyrë të pastër saktësisht të dhënat që ju nevojiten — pa analizim manual të `req`.

## Kontrollerët duhet të jenë të HOLLË

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

Praktikat më të mira: mbajeni kontrollerët **të hollë** — ata trajtojnë përgjegjësitë HTTP (rrugëzim, ekstraktim të dhënash, kthim përgjigje) dhe delegojnë të gjithë logjikën e biznesit në **shërbime**. Ky ndarje mbajnë kodin të testueshmë dhe të organizuar.

## Pse ka rëndësi

Kontrollerët janë një bllok themelor i NestJS — pika hyrëse për të gjitha kërkesa HTTP dhe vendi ku përcaktohen rutët e API-t tuaj.

Kuptimi se si dekoratorët (`@Controller`, `@Get`/`@Post`, `@Param`/`@Body`/`@Query`) hartëzojnë metodat në rute dhe ekstraktojnë të dhëna kërkese në mënyrë deklarative është njohuri esenciale përditë në NestJS — kjo është se si ndërtoni çdo endpoint.

Njësoj e rëndësishme është parimi i mbajnit të kontrollerëve **të hollë** (trajtim vetëm i përvojave HTTP dhe delegim të logjikës së biznesit në shërbime të injektuar), i cili përfaqëson filozofinë e ndarjes së preokupimet në NestJS dhe mbajnë kodin të mirëmbajtshëm dhe testueshmë.

Kontrollerët, së bashku me shërbimet dhe modulet, formojnë strukturën bazë të çdo aplikacioni NestJS, duke i bërë ato thelbësore për të kuptuar që në fillim.