Τι είναι Controllers στο NestJS;

Question

Accepted Answer

**Controllers** χειρίζονται εισερχόμενα **HTTP requests** και επιστρέφουν απαντήσεις. Ορίζουν τις διαδρομές της εφαρμογής σας και λειτουργούν ως σημείο εισόδου — λαμβάνουν αιτήματα, εξάγουν δεδομένα, εντέλλονται σε services και επιστρέφουν αποτελέσματα. Διατηρούν τις ανησυχίες δρομολόγησης ξεχωριστές από την επιχειρηματική λογική.

## Ορισμός ενός controller

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

## Πώς λειτουργεί: τα decorators χαρτογραφούν τις μεθόδους στις διαδρομές

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

Τα decorators δεσμεύουν δηλωτικά τις μεθόδους κλάσης σε HTTP διαδρομές — καθαρές και ευανάγνωστες, χωρίς χειροκίνητη καταχώρηση διαδρομών.

## Τα decorators παραμέτρων εξάγουν δεδομένα αιτήματος

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

Τα decorators παραμέτρων του Nest (`@Param`, `@Query`, `@Body`, `@Headers`) εξάγουν καθαρά ακριβώς τα δεδομένα που χρειάζεστε — χωρίς χειροκίνητη ανάλυση του `req`.

## Τα Controllers πρέπει να είναι ΛΕΠΤΑ

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

Άριστη πρακτική: κρατήστε τα controllers **λεπτά** — χειρίζονται HTTP ανησυχίες (δρομολόγηση, εξαγωγή δεδομένων, επιστροφή απαντήσεων) και εντέλλονται όλη την επιχειρηματική λογική σε **services**. Αυτή η διαχώρηση κρατά τον κώδικα δοκιμάσιμο και οργανωμένο.

## Γιατί έχει σημασία

Τα Controllers είναι ένα θεμελιώδες δομικό στοιχείο του NestJS — το σημείο εισόδου για όλα τα HTTP αιτήματα και το σημείο όπου ορίζονται οι διαδρομές του API σας.

Η κατανόηση του τρόπου με τον οποίο τα decorators (`@Controller`, `@Get`/`@Post`, `@Param`/`@Body`/`@Query`) χαρτογραφούν τις μεθόδους σε διαδρομές και εξάγουν δηλωτικά τα δεδομένα αιτήματος είναι ουσιώδης καθημερινή γνώση NestJS — έτσι δημιουργείτε οποιοδήποτε endpoint.

Εξίσου σημαντική είναι η αρχή της διατήρησης των controllers **λεπτών** (χειρισμό μόνο HTTP ανησυχιών και ανάθεση της επιχειρηματικής λογικής σε εγχεδυμένα services), η οποία ενσωματώνει τη φιλοσοφία separation-of-concerns του NestJS και κρατά τον κώδικα συντηρήσιμο και δοκιμάσιμο.

Τα Controllers, μαζί με τα services και modules, αποτελούν τη βασική δομή κάθε εφαρμογής NestJS, κάνοντάς τα απαραίτητα να κατανοήσετε από την αρχή.