Controller trong NestJS là gì?

Question

Accepted Answer

**Controller** xử lý các **HTTP request** đến và trả về response. Chúng định nghĩa các route của ứng dụng và đóng vai trò là điểm vào — nhận request, trích xuất dữ liệu, ủy thác cho service, và trả về kết quả. Chúng giữ cho mối quan tâm về routing tách biệt khỏi business logic.

## Định nghĩa một controller

```ts
import { Controller, Get, Post, Body, Param } from "@nestjs/common";

@Controller("users")          // TIỀN TỐ route → tất cả route bắt đầu bằng /users
export class UsersController {
  constructor(private usersService: UsersService) {}   // inject một service qua DI

@Get()                       // GET /users
  findAll() {
    return this.usersService.findAll();
  }

@Get(":id")                  // GET /users/:id
  findOne(@Param("id") id: string) {        // trích xuất route param
    return this.usersService.findOne(id);
  }

@Post()                      // POST /users
  create(@Body() dto: CreateUserDto) {       // trích xuất request body
    return this.usersService.create(dto);
  }
}
```

## Cách hoạt động: decorator ánh xạ method tới route

```text
@Controller("users") → tiền tố route /users
@Get() / @Post() / @Put() / @Patch() / @Delete() → HTTP method + sub-path
Kết hợp: @Get(":id") bên trong @Controller("users") → GET /users/:id
```

Decorator gắn các method của class với route HTTP một cách khai báo (declarative) — sạch sẽ và dễ đọc, không cần đăng ký route thủ công.

## Decorator tham số trích xuất dữ liệu 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,  // một header
  @Req() req: Request,            // đối tượng request thô (hiếm khi cần)
) {}
```

Các decorator tham số của Nest (`@Param`, `@Query`, `@Body`, `@Headers`) trích xuất gọn gàng đúng dữ liệu bạn cần — không cần parse `req` thủ công.

## Controller nên MỎNG (THIN)

```ts
// ✅ controller ủy thác cho service — giữ cho mỏng
@Post()
create(@Body() dto: CreateUserDto) {
  return this.usersService.create(dto);   // business logic nằm trong SERVICE
}
// ❌ đừng đặt truy vấn database / business logic trực tiếp trong controller
```

Thông lệ tốt nhất: giữ cho controller **mỏng** — chúng xử lý các mối quan tâm về HTTP (routing, trích xuất dữ liệu, trả về response) và ủy thác toàn bộ business logic cho **service**. Sự phân tách này giữ cho code dễ test và có tổ chức.

## Tại sao điều này quan trọng

Controller là một thành phần cơ bản của NestJS — điểm vào cho tất cả HTTP request và là nơi định nghĩa các route của API.

Hiểu cách decorator (`@Controller`, `@Get`/`@Post`, `@Param`/`@Body`/`@Query`) ánh xạ method tới route và trích xuất dữ liệu request một cách khai báo là kiến thức NestJS thiết yếu hằng ngày — đó là cách bạn xây dựng bất kỳ endpoint nào.

Quan trọng không kém là nguyên tắc giữ controller **mỏng** (chỉ xử lý các mối quan tâm về HTTP và ủy thác business logic cho các service được inject), điều này thể hiện triết lý separation-of-concerns của NestJS và giữ cho code dễ bảo trì và dễ test.

Controller, cùng với service và module, tạo nên cấu trúc cốt lõi của mọi ứng dụng NestJS, khiến chúng trở nên thiết yếu để nắm vững ngay từ đầu.