Apa itu pengawal dalam NestJS?

Question

Accepted Answer

**Pengawal** menangani **permintaan HTTP** yang masuk dan mengembalikan respons. Mereka mendefinisikan rute aplikasi Anda dan bertindak sebagai titik masuk — menerima permintaan, mengekstrak data, mendelegasikan ke layanan, dan mengembalikan hasil. Mereka menjaga kekhawatiran perutean terpisah dari logika bisnis.

## Mendefinisikan pengawal

```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: dekorator memetakan metode ke 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 secara deklaratif mengikat metode kelas ke rute HTTP — bersih dan mudah dibaca, tanpa pendaftaran rute manual.

## Dekorator parameter mengekstrak data permintaan

```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 parameter Nest (`@Param`, `@Query`, `@Body`, `@Headers`) dengan bersih mengekstrak data yang tepat yang Anda butuhkan — tanpa penguraian manual `req`.

## Pengawal 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 pengawal agar **tipis** — mereka menangani kekhawatiran HTTP (perutean, mengekstrak data, mengembalikan respons) dan mendelegasikan semua logika bisnis ke **layanan**. Pemisahan ini membuat kode dapat diuji dan terorganisir.

## Mengapa itu penting

Pengawal adalah blok bangunan fundamental NestJS — titik masuk untuk semua permintaan HTTP dan tempat rute API Anda didefinisikan.

Memahami bagaimana dekorator (`@Controller`, `@Get`/`@Post`, `@Param`/`@Body`/`@Query`) memetakan metode ke rute dan mengekstrak data permintaan secara deklaratif adalah pengetahuan NestJS sehari-hari yang penting — itulah cara Anda membangun titik akhir apa pun.

Sama pentingnya adalah prinsip menjaga pengawal **tipis** (menangani hanya kekhawatiran HTTP dan mendelegasikan logika bisnis ke layanan yang disuntikkan), yang mewujudkan filosofi pemisahan kekhawatiran NestJS dan membuat kode dapat dipelihara dan dapat diuji.

Pengawal, bersama dengan layanan dan modul, membentuk struktur inti setiap aplikasi NestJS, menjadikannya penting untuk dipahami sejak awal.