Piye cara routing ing NestJS?

Question

Accepted Answer

**Routing** ing NestJS iku **berbasis dekorator**: sampeyan nggabungake jalur URL lan metode HTTP menyang metode kontroler nggunakake dekorator. Prefiks rute asale saka `@Controller()` lan jalur spesifik + verba HTTP saka dekorator metode kaya `@Get()` — digabungake kanggo mbentuk rute lengkap.

## Piye rute digabung

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

Prefiks kontroler + jalur dekorator metode digabungake: `@Get(":id")` ing `@Controller("users")` → `GET /users/:id`. Saben verba HTTP nduweni dekorator dhewe (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Parameter rute lan string query

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

## Rute bersarang/wildcard lan sub-jalur

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

## Urutan rute penting

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

Rute spesifik (statis) kudu dideklarasikake sadurunge dinamis (`:param`), utawa rute dinamis bisa njebak dheweke.

## Prefiks global lan versioning

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

Prefiks global (contone `/api/v1`) berlaku kanggo kabeh rute — umum kanggo konvensi API.

## Dene iki penting

Routing iku dasar — nggawe struktur URL API lan cara saben panjalanan tekan handler sing tepat.

Nèng NestJS nggunakake **decorator-based routing** (prefiks `@Controller` digabungake karo dekorator metode `@Get`/`@Post`/lsp. kanggo mbentuk rute lengkap, lan `@Param`/`@Query` kanggo ngambil data) iku ilmu sehari-hari sing essential — piye sampeyan mbangun saben endpoint, lan gaya deklaratif njaga routing bersih lan bisa diwaca dibandingake registrasi rute manual.

Ngerti rincian praktis — ngabung prefiks lan jalur, nangani parameter rute lan string query, rute sumber bersarang, pentinge **urutan rute** (statis sadurunge dinamis), lan prefiks global/versioning kanggo konvensi API — perlu kanggo mbangun REST API sing terstruktur kanthi apik ing NestJS.

Routing, kontroler, lan dekorator parameter bareng-bareng mbentuk dasar penanganan permintaan saka framework, nggawe materi inti iki, kudu dipahami kanggo saben developer NestJS.