Apa itu controllers dalam NestJS?

Question

Accepted Answer

**Controllers** menangani **HTTP requests** yang masuk dan mengembalikan responses. Mereka mendefinisikan routes aplikasi Anda dan bertindak sebagai titik masuk — menerima permintaan, mengekstrak data, mendelegasikan ke services, dan mengembalikan hasil. Mereka menjaga routing concerns terpisah dari business logic.

## Mengapa ini penting

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

## Cara kerjanya: decorators memetakan methods ke routes

```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 secara deklaratif mengikat class methods ke HTTP routes — bersih dan mudah dibaca, tanpa pendaftaran route manual.

## Parameter decorators mengekstrak data request

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

Parameter decorators Nest (`@Param`, `@Query`, `@Body`, `@Headers`) dengan bersih mengekstrak tepat data yang Anda butuhkan — tidak ada parsing manual dari `req`.

## Controllers harus TIPIS

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

Praktik terbaik: jaga controllers **tipis** — mereka menangani HTTP concerns (routing, mengekstrak data, mengembalikan responses) dan mendelegasikan semua business logic ke **services**. Pemisahan ini menjaga kode tetap testable dan terorganisir.

## Mengapa ini penting

Controllers adalah building block fundamental NestJS — titik masuk untuk semua HTTP requests dan tempat routes API Anda didefinisikan.

Memahami bagaimana decorators (`@Controller`, `@Get`/`@Post`, `@Param`/`@Body`/`@Query`) memetakan methods ke routes dan mengekstrak data request secara deklaratif adalah pengetahuan NestJS sehari-hari yang penting — ini adalah bagaimana Anda membangun endpoint apa pun.

Sama pentingnya adalah prinsip menjaga controllers **tipis** (menangani hanya HTTP concerns dan mendelegasikan business logic ke injected services), yang mewujudkan filosofi separation-of-concerns NestJS dan menjaga kode tetap maintainable dan testable.

Controllers, bersama dengan services dan modules, membentuk struktur inti setiap aplikasi NestJS, menjadikannya penting untuk dipahami sejak awal.