როგორ მუშაობს routing NestJS-ში?

Question

Accepted Answer

**Routing** NestJS-ში არის **დეკორატორ-ზე დაფუძნებული**: თქვენ URL-ის ბილიკებს და HTTP მეთოდებს კონტროლერის მეთოდებზე აკავშირებთ დეკორატორების გამოყენებით. მარშრუტის პრეფიქსი მოდის `@Controller()`-დან და კონკრეტული ბილიკი + HTTP ზმნა მეთოდის დეკორატორებიდან, როგორიცაა `@Get()` — რომლებიც ერთდება სრულ მარშრუტში.

## როგორ ქმნიან მარშრუტებს

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

კონტროლერის პრეფიქსი + მეთოდის დეკორატორის ბილიკი გაერთიანდება: `@Get(":id")` `@Controller("users")`-ის შიგნით → `GET /users/:id`. თითოეულ HTTP ზმნას აქვს თავისი დეკორატორი (`@Get`, `@Post`, `@Put`, `@Patch`, `@Delete`).

## მარშრუტის პარამეტრები და 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
) {}
```

## დამალული/wildcard მარშრუტები და ქვე-ბილიკები

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

## მარშრუტის რიგი მნიშვნელოვანია

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

კონკრეტული (სტატიური) მარშრუტები უნდა დაწეროთ დინამიური (`:param`) მარშრუტების წინ, ან დინამიური მარშრუტი შეიძლება მათი დაჭერა.

## გლობალური პრეფიქსი და ვერსიონირება

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

გლობალური პრეფიქსი (მაგ. `/api/v1`) ვრცელდება ყველა მარშრუტზე — ჩვეულებრივი API კონვენციისთვის.

## რატომ მნიშვნელოვანია

Routing ფუნდამენტური — ის განსაზღვრავს თქვენი API-ის URL სტრუქტურას და ისაა ის, თუ როგორ აღწევს ყოველი მოთხოვნა სწორ ხელმისაწვდომელამდე.

NestJS-ის **დეკორატორ-ზე დაფუძნებული routing-ის** გაცნობა (`@Controller` პრეფიქსი გაერთიანებული `@Get`/`@Post`/და ა.შ. მეთოდის დეკორატორებთან სრულ მარშრუტის ჩამოსაყალიბებლად, და `@Param`/`@Query` მონაცემების გამოსაყოფად) გამოუცდელი ყოველდღიური ცოდნაა — ეს არის თუ როგორ აშენებთ ყოველ endpoint-ს, და დეკლარაციული სტილი ინახავს routing-ს სუფთა და წაკითხულ, მეთოდის ხელით რეგისტრაციასთან შედარებით.

პრაქტიკული დეტალების ცოდნა — პრეფიქსებისა და ბილიკების კომპოზიცია, მარშრუტის პარამეტრებისა და query სტრიქონების დამუშავება, ქვე-რესურსების მარშრუტები, **მარშრუტის რიგის** მნიშვნელობა (სტატიური დინამიურამდე), და გლობალური პრეფიქსი/ვერსიონირება API კონვენციებისთვის — აუცილებელია NestJS-ში კარგად სტრუქტურირებული REST API-ების აშენებისთვის.

Routing, კონტროლერები და პარამეტრის დეკორატორები ერთად ქმნიან ჩარჩოს მოთხოვნის დამუშავების საფუძველს, რაც ამ ყველა NestJS დეველოპერის უნდა იცოდეს.