Request lifecycle (Vòng đời request)

Ứng dụng Nest xử lý request và tạo response theo một trình tự mà chúng ta gọi là vòng đời request (request lifecycle). Với việc dùng middleware, pipe, guard, và interceptor, sẽ khá khó để xác định chính xác một đoạn code chạy ở đâu trong vòng đời request, đặc biệt khi các component ở cấp global, controller, và route cùng tham gia. Nói chung, một request đi qua middleware đến guard, rồi đến interceptor, rồi đến pipe, và cuối cùng trở lại interceptor trên đường về (khi response được tạo ra).

Middleware

Middleware được thực thi theo một trình tự cụ thể. Đầu tiên, Nest chạy middleware được bind ở phạm vi global (ví dụ middleware được bind bằng app.use), sau đó chạy middleware bind theo module, các middleware này được xác định dựa trên path. Middleware chạy tuần tự theo đúng thứ tự chúng được bind, tương tự cách middleware hoạt động trong Express. Trong trường hợp middleware được bind ở nhiều module khác nhau, middleware bind ở root module sẽ chạy trước, sau đó middleware sẽ chạy theo thứ tự mà các module được thêm vào array imports.

Guards

Việc thực thi guard bắt đầu từ guard global, sau đó đến guard ở controller, và cuối cùng đến guard ở route. Giống như middleware, guard chạy theo thứ tự chúng được bind. Ví dụ:

@UseGuards(Guard1, Guard2)
@Controller('cats')
export class CatsController {
  constructor(private catsService: CatsService) {}

  @UseGuards(Guard3)
  @Get()
  getCats(): Cats[] {
    return this.catsService.getCats();
  }
}

Guard1 sẽ chạy trước Guard2, và cả hai sẽ chạy trước Guard3.

Interceptors

Interceptor, về cơ bản, tuân theo cùng pattern như guard, nhưng có một điểm khác: vì interceptor trả về RxJS Observable, các observable này sẽ được resolve theo kiểu vào sau ra trước (first in last out). Vì vậy, request đi vào sẽ đi qua trình tự resolve tiêu chuẩn: global, controller, route level, nhưng phía response của request (tức là sau khi trả về từ method handler của controller) sẽ được resolve theo thứ tự route → controller → global. Ngoài ra, bất kỳ error nào được throw từ pipe, controller, hoặc service đều có thể được đọc trong operator catchError của interceptor.

Pipes

Pipe tuân theo trình tự bind tiêu chuẩn global → controller → route, cùng nguyên tắc vào trước ra trước (first in first out) đối với tham số của @UsePipes(). Tuy nhiên, ở cấp route parameter, nếu bạn có nhiều pipe cùng chạy, chúng sẽ chạy theo thứ tự từ parameter cuối cùng có pipe đến parameter đầu tiên. Điều này cũng áp dụng cho pipe ở cấp route và cấp controller. Ví dụ, nếu chúng ta có controller sau:

@UsePipes(GeneralValidationPipe)
@Controller('cats')
export class CatsController {
  constructor(private catsService: CatsService) {}

  @UsePipes(RouteSpecificPipe)
  @Patch(':id')
  updateCat(
    @Body() body: UpdateCatDTO,
    @Param() params: UpdateCatParams,
    @Query() query: UpdateCatQuery,
  ) {
    return this.catsService.updateCat(body, params, query);
  }
}

thì GeneralValidationPipe sẽ chạy cho query, rồi params, rồi cho object body, trước khi chuyển sang RouteSpecificPipe, pipe này cũng theo cùng thứ tự đó. Nếu có pipe riêng cho từng parameter cụ thể, chúng sẽ chạy (một lần nữa, từ parameter cuối đến đầu) sau khi pipe ở cấp controller và route đã chạy.

Filters

Filter là component duy nhất không resolve theo thứ tự global trước. Ngược lại, filter resolve từ cấp thấp nhất có thể, nghĩa là việc thực thi bắt đầu từ filter bind ở route, rồi đến cấp controller, và cuối cùng là filter global. Lưu ý rằng exception không thể được truyền từ filter này sang filter khác; nếu một filter ở cấp route đã bắt được exception, filter ở cấp controller hoặc global sẽ không thể bắt cùng exception đó. Cách duy nhất để đạt được hiệu ứng tương tự là dùng kế thừa (inheritance) giữa các filter.

Summary (Tổng kết)

Nhìn chung, vòng đời request có dạng như sau:

1. Request đến (Incoming request)
2. Middleware
   • 2.1. Middleware bind ở phạm vi global
   • 2.2. Middleware bind theo module
3. Guards
   • 3.1 Guard global
   • 3.2 Guard controller
   • 3.3 Guard route
4. Interceptors (trước khi vào controller)
   • 4.1 Interceptor global
   • 4.2 Interceptor controller
   • 4.3 Interceptor route
5. Pipes
   • 5.1 Pipe global
   • 5.2 Pipe controller
   • 5.3 Pipe route
   • 5.4 Pipe route parameter
6. Controller (method handler)
7. Service (nếu có)
8. Interceptors (sau khi request hoàn tất)
   • 8.1 Interceptor route
   • 8.2 Interceptor controller
   • 8.3 Interceptor global
9. Exception filters
   • 9.1 route
   • 9.2 controller
   • 9.3 global
10. Response trả về client (Server response)