Controller ใน NestJS คืออะไร?

Question

Accepted Answer

**Controller** ทำหน้าที่จัดการ **HTTP request** ที่เข้ามาและส่ง response กลับไป โดยเป็นตัวกำหนด route ของแอปพลิเคชันและทำหน้าที่เป็นจุดเริ่มต้น (entry point) — รับ request, ดึงข้อมูลออกมา, มอบหมายงานให้ service และส่งผลลัพธ์กลับ Controller ช่วยแยกเรื่องของ routing ออกจาก business logic

## การกำหนด 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);
  }
}
```

## หลักการทำงาน: decorator แมป method เข้ากับ route

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

Decorator ผูก method ของคลาสเข้ากับ HTTP route แบบ declarative — สะอาดและอ่านง่าย ไม่ต้องลงทะเบียน route เองด้วยมือ

## Parameter decorator ดึงข้อมูลจาก 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 decorator ของ Nest (`@Param`, `@Query`, `@Body`, `@Headers`) ดึงเฉพาะข้อมูลที่คุณต้องการออกมาได้อย่างสะอาด — ไม่ต้องแกะ `req` เองด้วยมือ

## Controller ควรจะ THIN (บาง)

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

แนวปฏิบัติที่ดีคือ: ทำให้ controller **บาง** — รับผิดชอบเฉพาะเรื่องของ HTTP (routing, ดึงข้อมูล, ส่ง response) แล้วมอบหมาย business logic ทั้งหมดให้ **service** การแยกหน้าที่เช่นนี้ทำให้โค้ดทดสอบได้และเป็นระเบียบ

## ทำไมจึงสำคัญ

Controller เป็นองค์ประกอบพื้นฐานของ NestJS — เป็นจุดเริ่มต้นของ HTTP request ทั้งหมดและเป็นที่ที่กำหนด route ของ API

การเข้าใจว่า decorator (`@Controller`, `@Get`/`@Post`, `@Param`/`@Body`/`@Query`) แมป method เข้ากับ route และดึงข้อมูลจาก request แบบ declarative อย่างไร เป็นความรู้ NestJS พื้นฐานที่ใช้ทุกวัน — เพราะนี่คือวิธีที่คุณสร้าง endpoint ใด ๆ

ที่สำคัญไม่แพ้กันคือหลักการของการทำให้ controller **บาง** (จัดการเฉพาะเรื่อง HTTP และมอบหมาย business logic ให้ service ที่ inject เข้ามา) ซึ่งสะท้อนปรัชญา separation of concerns ของ NestJS และทำให้โค้ดดูแลรักษาและทดสอบได้

Controller ร่วมกับ service และ module ก่อร่างเป็นโครงสร้างหลักของทุกแอปพลิเคชัน NestJS จึงเป็นสิ่งที่ต้องเข้าใจตั้งแต่เริ่มต้น