Hogyan működik az útválasztás a NestJS-ben?

Question

Accepted Answer

A NestJS-ben a **routing** **dekorátor-alapú**: URL-útvonalakat és HTTP-metódusokat képez le a vezérlő metódusaira dekorátorok segítségével. Az útvonal előtagja a `@Controller()`-ből származik, a specifikus útvonal + HTTP-ige pedig a `@Get()` típusú metódusdekorátorokból — kombinálva a teljes útvonal létrehozásához.

## Hogyan állnak össze az útvonalak

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

A vezérlő előtagja + a metódusdekorátor útvonala kombinálódik: a `@Controller("users")` belsejében lévő `@Get(":id")` → `GET /users/:id`. Minden HTTP-igének van saját dekoratora (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## Útvonalparaméterek és lekérdezési karakterláncok

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

## Beágyazott/wildcard útvonalak és alútvonalak

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

## Az útvonalsorrend számít

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

A specifikus (statikus) útvonalakat a dinamikus (`:param`) útvonalak előtt kell deklarálni, különben a dinamikus útvonal elfoghatja őket.

## Globális előtag és verziózás

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

Egy globális előtag (pl. `/api/v1`) az összes útvonalra vonatkozik — az API-konvenciók közé tartozik.

## Miért fontos ez

Az útválasztás alapvető — meghatározza az API URL-szerkezetét, és így minden kérés az entsprechend kezelőhöz jut.

A NestJS **dekorátor-alapú útválasztásának** megértése (a `@Controller` előtag kombinálása a `@Get`/`@Post`/stb. metódusdekorátorokkal a teljes útvonalak létrehozásához, valamint a `@Param`/`@Query` az adatok kinyeréséhez) elengedhetetlen mindennapi tudás — így építed fel az egyes végpontokat, és a deklaratív stílus tiszta és olvasható marad az útválasztás, szemben a kézi útvonal-regisztrációval.

A gyakorlati részletek ismerete — előtagok és útvonalak összeállítása, útvonalparaméterek és lekérdezési karakterláncok kezelése, beágyazott erőforrás-útvonalak, az **útvonalsorrend** fontossága (statikus előtt dinamikus), valamint a globális előtagok/verziózás az API-konvenciókhoz — szükséges a jól felépített REST API-k létrehozásához a NestJS-ben.

Az útválasztás, a vezérlők és a paraméterdekorátorok együttesen képezik a keretrendszer kéréskezelésének alapját, ezáltal alapvető, nélkülözhetetlen tudássá válnak bármely NestJS-fejlesztő számára.