Cad iad an controllers i NestJS?

Question

Accepted Answer

**Controllers** a dhéanann láimhseáil ar **HTTP requests** atá ag teacht isteach agus toradh a thabhairt ar ais. Sainmhíníonn siad ar bhealach do d'fheidhmchláir agus gníomhaíonn siad mar an bpointe isteach — ag fáil ar bhailiúchán, ag bailiú sonraí, ag foluain do sheirbhísí, agus ag tabhairt torthaí ar ais. Coinníonn siad ábhair ina bhealach ar leataoibh ó dhúchas gnó.

## Cén fáth a bhfuil sé tábhachtach

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

## Conas a oibríonn sé: décorateurs a mhapáil ar mhodh ar bhealach

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

Ŕféadann décorateurs modh ranga a cheangal go soiléir ar bhealach HTTP — geal agus inléite, gan an clárúchán bhealach a dhéanamh de láimh.

## Paramádar décorateurs a bhaint sonraí ó iarratas

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

Décorateurs paramádar Nest (`@Param`, `@Query`, `@Body`, `@Headers`) a bhaint go soiléir go díreach ar na sonraí a bhíonn de dhíth ort — gan parsáil láimh ar `req`.

## Ba chóir do Chontrollers a bheith TANAÍ

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

An cleachtadh is fearr: coinní controllers **tanaí** — baineann siad le hábhair HTTP (bealaighin, sonraí a bhaint, torthaí a thabhairt ar ais) agus foluaineacha a dhéanamh ar gach rud gnó ar **seirbhísí**. Coimeádann an scaradh seo an cód tástála agus eagraithe.

## Cén fáh a bhfuil sé tábhachtach

Is builín bhunúsach NestJS iad controllers — an pointe isteach do gach HTTP request agus iad siúd ina bhfuil bealaithe do d'API sainmhínithe.

Tá sé riachtanach an tuigbheáil conas a dhéanann décorateurs (`@Controller`, `@Get`/`@Post`, `@Param`/`@Body`/`@Query`) modh ar bhealach agus sonraí a bhaint ó iarratas go soiléir eolas riachtanach NestJS laethúil — is é seo an chaoi a dhéanann tú aon endpoint.

Tá an prionsabal go mór tábhachtach freisin de controllers a coinneáil **tanaí** (ag déileáil le hábhair HTTP amháin agus gnó ar seirbhísí a ionadaítear), ar ionadaítear coincheap NestJS ar scaradh-imní agus an cód sochar agus tástála a choinneáil.

Controllers, i dteannta seirbhísí agus modúl, an struchtúr príomhúil ar gach feidhmchláir NestJS a dhéanamh, ionad riachtanach iad a thuiscint ó thúin.