[Spring] Spring WebFlux - DispatcherHandler

Spring WebFlux - DispatcherHandler

Spring WebFlux 프레임워크의 DispatcherHandler 에 대해서 알아볼 것이다. Spring WebFlux 동작구조에 대해서 알아보고 싶었으나, 따로 동작구조에 대한 문서는 못 찾아서 DispatcherHandler 가 적절한 것 같아 이에 대해 알아보려고 한다.

Introduction

Spring WebFlux 는 Spring MVC 처럼 중앙에 WebHandler 인 DispatcherHandler 가 있는데 프론트 컨트롤러 패턴을 중심으로 설계되었으며, 실제 작업이 설정(configurable)이나 delegate 컴포넌트에 의해 행해지는 동안 request 처리를 위한 shared 알고리즘을 제공한다. 이 모델은 유연하고, 다양한 wrokflow(작업흐름)를 지원한다.

DispatcherHandler 는 Spring configuration 에서 필요한 delegate 컴포넌트들을 검색한다. 또한, Spring bean으로 설계되었으며 실행 컨테스트에 대한 액세스를 위해 ApplicationContextAware 를 구현한다. 만약 DispatcherHandler가 "webHandler" 란 이름의 bean 으로 선언된다면, WebHandler API 에 설명되있는 대로 request 처리 chain을 합치는 WebHttpHandlerBuilder 에 의해 결과적으로 발견된다.

WebFlux 애플리케이션의 Spring configuration 은 다음을 포함하고 있다.

• bean 이름이 "webHandler" 인 DispatcherHandler
• WebFilter 및 WebExceptionHandler beans
• DispathcerHandler 의 특별한 bean
  • HandlerMapping : 요청을 어떤 컨트롤러에서 처리할지 결정
  • HandlerAdapter : HandlerMapping 으로 선택한 컨트롤러를 DispatcherHandler가 호출할 때 사용
  • HandlerResultHandler : handler 호출의 결과를 처리하고 응답
• 그 외

WebHttpHandlerBuilder 에 processing chain 을 구축하는 configuration 을 제공한다.

ApplicationContext context = ...
HttpHandler handler = WebHttpHandlerBuilder.applicationContext(context);

Proccessing

DispatcerHandler 는 다음과 같이 요청을 처리한다.

• 각 HandlerMapping 은 일치하는 handler 를 찾고 첫 번째로 일치한 handler 를 사용한다.
• handler 를 발견하면, 적절한 HandlerAdapter 를 통해 실행되며 handler 는 HandlerResult 로 리턴한다.
• HandlerResult 는 적절한 HandlerResultHandler 에 주어져 응답에 직접 사용하거나 view 를 사용하여 렌더링을 하고 처리를 완료한다.

Result Handling

HandlerAdapter 를 통한 handler 의 호출에서 반환된 값은 몇 가지 추가적인 context 와 함께 HandlerResult 로 wrapped 되고, 지원을 요구하는 첫 번째 HandlerResultHandler 로 전달된다. 아래의 표는 사용 가능한 HandlerResultHandler 구현을 보여주며 이 구현들은 모두 WebFlux Config 에 선원되어 있다.

• ResponseEntityResultHandler
  • 일반적으로 @Controller 에서 ResponseEntity 를 반환한다.
• ServerResponseResultHandler
  • 일반적으로 functional endpoint 에서 ServerResponse 를 반환한다.
• ResponseBodyResultHandler
  • @ResponseBody 메소드 또는 @RestController 클래스의 반환 값을 처리한다.
• ViewResolutionResultHandler
  • CharSequence 또는 View, Model 또는 Map, Rendering 또는 다른 Object는 model attribute 로 처리된다.

Exceptions

HandlerAdapter 를 통해 반환된 HandlerResult 는 일부 handler-specific 메카니즘을 기반으로 오류처리 기능을 expose 할 수 있다. 이 error function 은 다음 경우에 호출된다.

• handler(e.g. @Controller) 호출에 실패
• HandlerResultHandler 를 통한 handler 반환 값 처리에 실패

error function 은 response 를 변경할 수 있다. 예를 들어, handler 에서 반환된 reactive tpee 이 데이터 항목들을 생성하기 전에 error signal 이 발생하는 error status 로 변경된다.

이것은 @Controller 클래스 안의 @ExceptionHandler 메소드가 지원되는 방법이다. 반대로 Spring MVC 에서는 HandlerExceptionResolver 를 기반으로 지원된다. 그러나 일반적으로 WebFlux 에서는 @ControllerAdvice 를 사용하여 handler 를 선택하기 전에 발생하는 예외를 처리 할 수는 없다.