Request_Lifecycle.md

NestJS Request Lifecycle

Summary

NestJS의 요청 수명 주기는 요청이 서버로 들어와 처리된 후 응답이 반환될 때까지의 흐름을 나타낸다. 이 과정은 여러 핵심 구성 요소(미들웨어, 가드, 인터셉터, 파이프, 컨트롤러, 서비스, 예외 필터)를 거치며 요청과 응답을 조작할 수 있다.

Details

요청 수명 주기의 주요 단계

1. 미들웨어 (Middleware)

   • 요청이 컨트롤러에 도달하기 전에 실행됨
   • 로깅, 인증, 요청 변환 등의 작업 수행
   • next() 호출을 통해 다음 단계로 전달

   @Injectable()
   export class LoggerMiddleware implements NestMiddleware {
     use(req: Request, res: Response, next: NextFunction) {
       console.log(`[${new Date().toISOString()}] ${req.method} ${req.url}`);
       next();
     }
   }

2. 가드 (Guard)

   • 요청이 특정 라우트에 접근할 수 있는지 여부를 결정
   • 주로 인증 및 권한 검증에 사용됨

   @Injectable()
   export class AuthGuard implements CanActivate {
     canActivate(context: ExecutionContext): boolean {
       const request = context.switchToHttp().getRequest();
       return validateRequest(request);
     }
   }

3. 인터셉터 (Interceptor)

   • 요청 및 응답을 변환하거나 로깅, 메타데이터 추가 등의 작업 수행
   • 메서드 실행 전후 로직을 추가할 수 있음

   @Injectable()
   export class TransformInterceptor implements NestInterceptor {
     intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
       return next.handle().pipe(map(data => ({ data })));
     }
   }

4. 파이프 (Pipe)

   • 요청 데이터의 유효성을 검사하거나 변환을 수행

   @Injectable()
   export class ValidationPipe implements PipeTransform {
     transform(value: any, metadata: ArgumentMetadata) {
       if (!value) {
         throw new BadRequestException('Validation failed');
       }
       return value;
     }
   }

5. 컨트롤러 (Controller)

   • 클라이언트의 요청을 처리하고 응답을 생성하는 역할

   @Controller('cats')
   export class CatsController {
     @Get()
     findAll(): string {
       return 'This action returns all cats';
     }
   }

6. 서비스 (Service)

   • 비즈니스 로직을 처리하며 데이터베이스 및 외부 API와 상호작용

   @Injectable()
   export class CatsService {
     private readonly cats: Cat[] = [];
   
     findAll(): Cat[] {
       return this.cats;
     }
   }

7. 예외 필터 (Exception Filter)

   • 애플리케이션 내에서 발생한 예외를 처리

   @Catch(HttpException)
   export class HttpExceptionFilter implements ExceptionFilter {
     catch(exception: HttpException, host: ArgumentsHost) {
       const ctx = host.switchToHttp();
       const response = ctx.getResponse();
       const status = exception.getStatus();
   
       response.status(status).json({
         statusCode: status,
         timestamp: new Date().toISOString(),
         path: request.url,
       });
     }
   }

요청 수명 주기 다이어그램

Loading

---
config:
  look: handDrawn
  theme: neutral
---

graph TD
    A[Client Request] -->|Middleware| B[Middleware Processing]
    B -->|Guard| C[Authorization Guard Check]
    C -->|Interceptor| D[Request Interception]
    D -->|Pipe| E[Validation & Transformation]
    E -->|Controller| F[Controller Processing]
    F -->|Service| G[Business Logic Execution]
    G -->|Controller Response| H[Controller Returns Data]
    H -->|Interceptor| I[Response Interception]
    I -->|Client Response| J[Final Response Sent]
    H -.->|Exception Occurred| K[Exception Filter Handling]
    K --> J;

Reference

link: External reference

• NestJS 공식 문서 - Request Lifecycle