Filter와 Interceptor

💡 Spring framework의 내부 동작에 대해서 공부하다보면 Filter와 Interceptor는 뺴놓을 수 없는 요소입니다. 왜 내부 로직에 Filter랑 Interceptor를 뒀을까?를 알고 이를 활용할 줄 알아야 수준 높은 프로젝트를 개발할 수 있을 것입니다. 단순히 아 Filter랑 Interceptor가 있구나 하고 넘어가면 Filter와 Interceptor의 존재에서 나오는 장점들을 놓친 채 개발을 하게 될 것입니다. 그렇기에 왜 Filter와 Interceptor를 뒀을까, 무슨 역할을 할까, 어떤 차이가 있을까에 대해서 알아보는 시간을 가져볼까 합니다. ✌️

왜 필요한데?

---

자바 웹 애플리케이션을 개발하다보면 요구사항에 맞는 API 개발뿐만 아니라 필수적으로 개발해야 되는 요소들이 있습니다.

• 사용자 인증
• 권한 검사(인가)
• 보안
  • XSS, CORS
• 로깅
• 이미지 압축 및 데이터 형식 변환

API의 URL에 따라 상이한 동작을 요구할 수 있겠지만, 같은 동작이든 다른 동작이든 공통적으로 모든 API에 필수로 적용되어야 하는 요소들입니다.

위 내용을 언급한 이유는 다들 눈치챘다시피 Filter와 Interceptor가 위 요소들에 대한 책임 및 구현에 역할을 하고 있기 때문입니다. 왜 저 역할들을 하기 위해 저 2가지 개념이 탄생하고 만들어지게 되었을까요?

없을 때를 생각하면 쉬울 것 같습니다. 저 2가지 layer가 없을 경우, 우리는 클라이언트의 요청에 대해 Controller, Service Layer에서 저 동작들을 처리할 수 밖에 없습니다. 위 요소들은 모든 API에 대해 공통적으로 수행되어야 하는 것들인데 애플리케이션이 커지면 커질수록 코드의 양은 방대해지고, 중복되어지고, 애플리케이션은 무거워질 수 밖에 없습니다.

그렇기에 우리는 시점에 따라 관심사의 분리를 할 필요가 있습니다. 관심사의 분리를 하게 되면 다음과 같은 장점들을 고스란히 얻을 수 있는데요,

• 유지보수가 쉬움.
• 개발 시, 하나의 관심사에 대해 집중할 수 있음.
• 코드의 재사용 (중복 제거)

그러면 어떤 시점에 따라 분리하여 관심사를 분리하였을까요?

Spring MVC 내부 동작

• 클라이언트의 요청이 서블릿 컨테이너에 접근하기 전 (1)

• 요청이 DispatcherServlet으로 부터 Controller로 접근하기 전 (2)

• Controller에서 Service - Repository ~ (3)

• +추가) DispatcherServlet이란?

  DispatcherServlet이란 클라이언트로 들어온 HTTP 요청을 Controller로 전달해주는 역할을 합니다. Controller보다 앞단에서 요청을 전달받기 때문에 Front Controller라고도 합니다. 요 녀석도 Filter와 Interceptor의 탄생 배경과 비슷한 부분이 있는데요, DispatcherServlet이 등장하기 전엔 HTTP 요청을 하는 API에 맞는 서블릿을 일일이 구현해야만 했고 각각의 서블릿에 맞는 Controller에 매핑을 해야만 했습니다.

  이를 해결하기 위해 DispatcherServlet이 등장하였는데요,

  DispatcherServlet은 하나의 서블릿 개념으로 모든 HTTP 요청을 받은 뒤, 요청에 대한 공통의 작업을 수행(ex, 한글/영어 인코딩)하고 이를 Controller에 뿌려주는 역할을 합니다.

  또한 DispatcherServlet는 resources 폴더에 있는 정적 리소스(이미지, 파일, html)에 요청을 애플리케이션의 요청과 분리하여 처리하는 기능도 수행하는데요, 요청이 들어오면 controller(애플리케이션)에 해당 요청에 대한 매핑이 있는지 탐색하고 없을 시, resources 로 접근하는 로직을 통해 위 기능을 수행합니다.
  

무슨 역할을 할까?

---

위 그림을 통해 3가지로 분리한 시점에 대해 잘 이해해 볼 수 있을 것 같습니다.

(1) 클라이언트의 요청이 스프링 컨테이너에 접근하기 전 : Filter의 역할

ServletContainer 의 DispatcherServlet으로 요청의 도달하기 전과 DispatcherServlet으로 부터 응답 데이터를 받고 클라이언트로 가기 전의 데이터에 대한 작업을 Filter가 수행하게 됩니다. 보통 웹 어플리케이션에서 전역으로 처리되는 작업들(ex) 보안 처리)을 수행하게 되는데요,

• CORS
• XSS
• 인증

보안과 관련된 작업 외에도 아래와 같은 작업도 수행합니다.

• 문자열 인코딩
• 이미지 및 데이터 압축

(2) 요청이 DispatcherServlet으로 부터 Controller로 접근하기 전 : Interceptor의 역할

• dispatcherServlet → Controller
• Controller → dispatcherServlet

위 2가지 과정 사이에서 Interceptor가 작업을 수행합니다. 보통 권한 검사(인가), View 렌더링 전 추가 작업등을 수행합니다.

(3)Controller에서 Service - Repository ~

위에서 다룬 Filter, Interceptor의 역할에 덕분에 App에서 분리되어지는 Controller - Service - Repository 계층은 각각의 역할과 책임에 집중할 수 있습니다.

뭐가 좋아진거지? 🗯️

• 계층 별 응집도가 높아졌다!
• 계층 별 결합도가 낮아졌다!
• 효율적으로 코드를 작성할 수 있고, 유지보수하기 쉽다!

어떤 차이가 있을까?

---

A. Filter

---

public interface Filter {

    
    public default void init(FilterConfig filterConfig) throws ServletException {}

    
    public void doFilter(ServletRequest request, ServletResponse response,
            FilterChain chain) throws IOException, ServletException;

    
    public default void destroy() {}

}

B. Interceptor

---

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

}

위에서 실행 시점이 다르고, 하는 역할이 다른 것은 다뤄보았기 때문에 크게 2가지 차이점에 대해 다뤄보고 싶습니다.

1. Exception Handling

스프링에서 예외처리는 발생 위치에 따라 2가지로 분리되어질 수 있습니다.

• Dispatcher Servlet 에서 발생하는 예외 (root Spring Container 포함)
  • 위 경우, HandlerExceptionResolver 을 통해 예외처리를 수행할 수 있습니다. Interceptor는 위 경우이므로 HandlerExceptionResolver을 사용하면 쉽게 예외처리를 할 수 있습니다.
• Dispatcher Servlet 밖의 서블릿(Filter)에서 발생하는 예외 (Web Application 레벨 예외)
  • Filter 내부에 예외처리를 위한 Filter을 두고 try-catch로 예외처리를 수행
    • Security 의 인가 처리의 경우, ExceptionTranslationFilter 에 예외를 던져 예외처리를 수행합니다.
  • HandlerExceptionResolver을 bean으로 등록하고 GlobalExceptionHandler에서 예외 처리

1. 요청/응답에 대한 조작 가능 여부

Filter 에서는 ServletRequest, ServletResponse 객체로 요청/응답 데이터를 제공받기 때문에 대한 조작이 가능합니다. 반면에 Interceptor에서는 HttpServletRequest, HttpServletResponse 객체로 요청/응답 데이터를 제공받기 때문에 조작이 불가능합니다.

그렇기에 Filter에선 대개 이미지 및 데이터 압축을 수행하며 Interceptor에서는 객체 내부 값을 통해 컨트롤러가 요구하는 형식의 데이터 가공을 수행합니다.

회고

---

사실 포스팅을 결정했던 건 Spring Security를 통해 여러 Filter에 공부하게 되었고, Spring에선 Filter와 Interceptor가 중요한 역할을 한다는 것을 알게 되었기 때문입니다.

이번 포스팅을 작성하면서 Spring Security에서 왜 자꾸 여러가지 Filter를 사용하면서 Secure한 작업들을 수행하는지 알게 되어 Spring Security를 적용하고 학습할 때 도움이 될 것 같습니다.

다음 포스팅으로 Spring Security에서의 Filter와 프로젝트에서 맡았던 CorsFilter 적용에 대해서 작성해보고, 위 2가지 개념과 비슷한 AOP 에 대해서도 다뤄보도록 하겠습니다 🤭

참고문서

---

[Spring] 필터(Filter) vs 인터셉터(Interceptor) 차이 및 용도

(Spring)Filter와 Interceptor의 차이

Spring Filter, Interceptor 그리고 AOP

[Spring] Filter, Interceptor, AOP 차이 및 정리

[카카오 면접] Spring Filter, Interceptor, AOP

Filter 와 Interceptor의 차이란?

[Java][Spring] Filter와 Interceptor

Spring Interceptor란 무엇인가. 필터와 인터셉터의 차이

Filter VS Interceptor

[Spring]Dispatcher-Servlet(디스패처 서블릿)이란?

서블릿 컨테이너와 스프링 컨테이너

[스프링] 스프링에서 예외 처리