2 분 소요

 인프런 스프링 MVC 2편 - 백엔드 웹 개발 활용 기술편을 학습하고 정리한 내용 입니다.

스프링 인터셉터란?

스프링 인터셉터도 서블릿 필터와 같이 웹과 관련된 공통 관심 사항을 효과적으로 해결할 수 있는 기술이다.

서블릿 필터가 서블릿이 제공하는 기술이라면, 스프링 인터셉터는 스프링 MVC가 제공하는 기술이다.

둘 다 웹과 관련된 공통 관심 사항을 처리하지만, 적용되는 순서와 범위, 그리고 사용 방법이 다르다.

스프링 인터셉터 흐름

1
HTTP 요청 -> WAS -> 필터 -> 서블릿 -> 스프링 인터셉터 -> 컨트롤러
  • 스프링 인터셉터는 디스패처 서블릿과 컨트롤러 사이에서 컨트롤러 호출 직전에 호출 된다.
  • 스프링 인터셉터는 스프링 MVC가 제공하는 기능이기 때문에 결국 디스패처 서블릿 이후에 등장하게 됨. 스프링 MVC의 시작 점이 디스패처 서블릿이라고 생각해보면 이해가 됨.
  • 스프링 인터셉터에도 URL 패턴을 적용할 수 있는데, 서블릿 URL 패턴과는 다르고, 매우 정밀하게 설정 가능하다.

스프링 인터셉터 제한

1
2
HTTP 요청 -> WAS -> 필터 -> 서블릿 -> 스프링 인터셉터 -> 컨트롤러 // 로그인 사용자
HTTP 요청 -> WAS -> 필터 -> 서블릿 -> 스프링 인터셉터 (적절하지 않은 사용자, 컨트롤러 호출 X)

인터셉터에서 적절하지 않은 요청이라고 판단하면 거기에서 끝을 낼 수도 있다.

스프링 인터셉터 체인

1
HTTP 요청 -> WAS -> 필터 -> 서블릿 -> 인터셉터1 -> 인터셉터2 -> 컨트롤러

스프링 인터셉터는 체인으로 구성되는데, 중간에 인터셉터를 자유롭게 추가할 수 있다.

예를 들어서 로그를 남기는 인터셉터를 먼저 적용하고, 그 후 로그인 여부를 체크하는 인터셉터를 만들 수 있다.

그런데 지금까지 내용을 보면 필터 이후에 동작한다는 것만 빼면 비슷하다고 느껴진다.

하지만 스프링 인터셉터는 서블릿 필터보다 편리하고, 더 정교하고 다양한 기능을 제공한다.

스프링 인터셉터 인터페이스

스프링 인터페이스를 사용하려면 필터에서 Filter를 구현한 것 처럼

HandlerInterceptor를 구현하면 된다.

1
2
3
4
5
6
7
8
9
10
11
public interface HandlerInterceptor {  
    default boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {  
        return true;  
    }  
  
    default void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, @Nullable ModelAndView modelAndView) throws Exception {  
    }  
  
    default void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, @Nullable Exception ex) throws Exception {  
    }  
}
  • 서블릿 필터의 경우 doFilter() 하나만 제공된다. 인터셉터는 컨트롤러 호출 전(preHandle), 호출 후 (postHandle), 요청 완료 이후 (afterComplite)와 같이 단계적으로 잘 세분화 되어 있다.
  • 서블릿 필터의 경우 단순히 request, response만 제공했지만, 인터셉터는 어떤 컨트롤러(handler)가 호출되는지 호출 정보도 받을 수 있다. 그리고 어떤 modelAndView가 반환 되는지 정보도 알 수 있다.

스프링 인터셉터 호출 흐름

정상 흐름

  • preHandle : 컨트롤러 호출 전에 호출된다. (더 정확히는 핸들러 어댑터 호출 전에 호출된다.)
    • preHandle의 응답 값이 true이면 다음으로 진행하고, false이면 더는 진행하지 않는다. false인 경우 나머지 인터셉터는 물론이고, 핸들러 어댑터도 호출되지 않는다. 그림에서 1번에서 끝이 나버린다.
  • postHandle : 컨트롤러 호출 후에 호출된다. (더 정확히는 핸들러 어댑터 호출 후에 호출 된다.)
  • afterCompletion : 뷰가 렌더링 된 후에 호출 된다.

스프링 인터셉터 예외 상황

컨트롤러에서 예외가 터지면 인터셉터는 다음과 같이 동작한다.

  • preHandle : 컨트롤러 전에 호출
  • postHandle : 컨트롤러가 예외가 터지면 postHandle은 호출 되지 않는다.
  • afterCompletion: afterCompletion은 예외가 터지던 말던 항상 호출 된다. 이 경우 예외(ex)를 파라터로 받아서 어떤 예외가 발생했는지 로그로 출력도 할 수 있다.

afterCompletion은 예외가 발생해도 호출된다.

  • 예외가 발생하면 postHandle은 호출 되지 않으므로 예외와 무관하게 공통 처리를 하려면 afterCompletion을 사용해야 한다.
  • 예외가 발생하면 afterCompletion에 예외 정보(ex)를 포함해서 호출 된다.

댓글남기기