การ routing ในตัว NestJS ทำงานอย่างไร?

Question

Accepted Answer

**Routing** ใน NestJS คือ **decorator-based**: คุณแมป URL paths และ HTTP methods ไปยัง controller methods โดยใช้ decorators route prefix มาจาก `@Controller()` และ path เฉพาะ + HTTP verb มาจาก method decorators เช่น `@Get()` — รวมกันเพื่อสร้าง route เต็มรูปแบบ

## วิธีการเขียน routes

```ts
@Controller("users")          // PREFIX: all routes start with /users
export class UsersController {
  @Get()                       // GET /users
  findAll() {}

@Get("active")               // GET /users/active
  findActive() {}

@Get(":id")                  // GET /users/:id (dynamic parameter)
  findOne(@Param("id") id: string) {}

@Post()                      // POST /users
  create(@Body() dto: CreateUserDto) {}

@Put(":id")                  // PUT /users/:id
  update(@Param("id") id: string, @Body() dto: UpdateUserDto) {}

@Delete(":id")               // DELETE /users/:id
  remove(@Param("id") id: string) {}
}
```

controller prefix + path ของ method decorator รวมกัน: `@Get(":id")` ภายใน `@Controller("users")` → `GET /users/:id` ทุก HTTP verb มี decorator ของตัวเอง (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`)

## Route parameters และ query strings

```ts
@Get(":id")
example(
  @Param("id") id: string,        // path param: /users/123 → id = "123"
  @Query("sort") sort: string,    // query: /users?sort=name → sort = "name"
  @Query() allQuery: any,         // the whole query object
) {}
```

## Nested/wildcard routes และ sub-paths

```ts
@Controller("users")
export class UsersController {
  @Get(":id/posts")              // GET /users/:id/posts (nested resource)
  getUserPosts(@Param("id") id: string) {}

@Get("search/*")               // wildcard matching
  search() {}
}
```

## ลำดับของ routes สำคัญ

```ts
@Get("active")    // ✅ specific route FIRST
findActive() {}
@Get(":id")        // dynamic route AFTER — else "active" would match :id
findOne() {}
```

Staticroutes ควรประกาศก่อน dynamic routes (`:param`) มิฉะนั้น dynamic route อาจจับทั้งหมด

## Global prefix และ versioning

```ts
app.setGlobalPrefix("api/v1");   // all routes become /api/v1/...
// NestJS also supports API versioning (URI, header, media-type based)
```

Global prefix (เช่น `/api/v1`) ใช้กับทุก routes — ทั่วไปสำหรับ API conventions

## ทำไมสิ่งนี้จึงสำคัญ

Routing เป็นพื้นฐาน — มันกำหนด URL structure ของ API ของคุณและเป็นวิธีที่ทุก request เข้าถึง handler ที่ถูกต้อง

การทำความเข้าใจ **decorator-based routing** ใน NestJS (prefix `@Controller` รวมกับ method decorators `@Get`/`@Post`/ฯลฯ เพื่อสร้าง full routes และ `@Param`/`@Query` เพื่อดึงข้อมูล) เป็นความรู้พื้นฐานการทำงานประจำวัน — นี่คือวิธีการสร้าง endpoint ทุกอัน และ declarative style ทำให้ routing สะอาดและอ่านได้สบายเมื่อเทียบกับการ register routes ด้วยตนเอง

รู้รายละเอียดปฏิบัติ — การรวม prefixes และ paths การจัดการ route parameters และ query strings nested resource routes ความสำคัญของ **route ordering** (static ก่อน dynamic) และ global prefixes/versioning สำหรับ API conventions — เป็นสิ่งจำเป็นในการสร้าง REST APIs ที่มีโครงสร้างดีใน NestJS

Routing controllers และ parameter decorators ร่วมกันสร้าง request-handling foundation ของ framework ทำให้นี่เป็นเนื้อหาพื้นฐาน ต้องรู้ สำหรับ NestJS developer ทั้งหมด