Bagaimanakah routing berfungsi dalam NestJS?

Question

Accepted Answer

**Routing** dalam NestJS ialah **berasaskan dekorator**: anda memetakan laluan URL dan kaedah HTTP kepada method controller menggunakan dekorator. Prefix laluan datang daripada `@Controller()` manakala laluan khusus + verb HTTP datang daripada dekorator method seperti `@Get()` — digabungkan untuk membentuk laluan penuh.

## Bagaimana laluan dikarang

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

Prefix controller + laluan dekorator method bergabung: `@Get(":id")` di dalam `@Controller("users")` → `GET /users/:id`. Setiap verb HTTP mempunyai dekoratornya sendiri (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Parameter laluan dan query string

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

## Laluan bersarang/wildcard dan sub-laluan

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

## Susunan laluan penting

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

Laluan khusus (statik) patut diisytiharkan sebelum laluan dinamik (`:param`), atau laluan dinamik itu mungkin menangkapnya.

## Prefix global dan versioning

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

Satu prefix global (cth. `/api/v1`) terpakai kepada semua laluan — lazim untuk konvensyen API.

## Mengapa ia penting

Routing adalah asas — ia mentakrifkan struktur URL API anda dan ialah cara setiap request sampai ke handler yang betul.

Memahami **routing berasaskan dekorator** NestJS (prefix `@Controller` digabungkan dengan dekorator method `@Get`/`@Post`/dll. untuk membentuk laluan penuh, dan `@Param`/`@Query` untuk mengekstrak data) ialah pengetahuan sehari-hari yang penting — itulah cara anda membina setiap endpoint, dan gaya deklaratif menjadikan routing bersih dan mudah dibaca berbanding pendaftaran laluan secara manual.

Mengetahui butiran praktikal — mengarang prefix dan laluan, mengendalikan parameter laluan dan query string, laluan sumber bersarang, kepentingan **susunan laluan** (statik sebelum dinamik), serta prefix/versioning global untuk konvensyen API — adalah perlu untuk membina REST API yang tersusun baik dalam NestJS.

Routing, controllers, dan dekorator parameter bersama-sama membentuk asas pengendalian request bagi framework ini, menjadikan ini bahan teras yang mesti diketahui oleh mana-mana pembangun NestJS.