본문으로 건너뛰기

Spring Boot - Interceptor

· 약 3분

Interceptor는 가로채는 것, 요격기 라는 뜻이다.

다시 말해서, Url Mapping된 Controller를 거치는 전, 후 처리를 할 수 있도록 도와주는 요소를 말하며 세션 검증, 로그 처리 같은 행위가 간단한 예시가 될 수 있다.

Dependency

Interceptor는 spring-webmvc에 포함되어 있다. Spring Boot에서는 spring-boot-starter-web을 가져옴으로 해결할 수 있다.

dependencies { 
compile('org.springframework.boot:spring-boot-starter-web')
testCompile('org.springframework.boot:spring-boot-starter-test')
}

Interceptor

기본 인터페이스는 HandlerInterceptor이고, 이를 구현할 수 해도 되지만, 추상 클래스인 HandlerInterceptorAdapter를 구현할 수도 있다. Java 1.8 부터는 굳이 HandlerInterceptorAdapter를 이용하지 않아도 된다. 하지만, 예시를 위해 모두 구현 해본다.

@Component
public class HttpInterceptor extends HandlerInterceptor {

private static final Logger logger = Logger.getLogger(HttpInterceptor.class);

@Override
public boolean preHandle(HttpServletRequest request,
HttpServletResponse response,
Object handler) {
logger.info("================ Before Method");
return true;
}

@Override
public void postHandle( HttpServletRequest request,
HttpServletResponse response,
Object handler,
ModelAndView modelAndView) {
logger.info("================ Method Executed");
}

@Override
public void afterCompletion(HttpServletRequest request,
HttpServletResponse response,
Object handler,
Exception ex) {
logger.info("================ Method Completed");
}
}
  • preHandle() : 맵핑되기 전 처리를 해주면 됩니다.
  • postHandle() : 맵핑되고난 후 처리를 해주면 됩니다.
  • afterCompletion() : 모든 작업이 완료된 후 실행 됩니다.

Config

Interceptor를 등록하기 위해서 WebMvcConfigurer를 이용한다. Interceptor를 등록한 후 적용할 경로, 제외할 경로를 지정해줄 수 있다.

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

@Autowired
@Qualifier(value = "httpInterceptor")
private HandlerInterceptor interceptor;

@Override
public void addInterceptors(InterceptorRegistry registry) {
registry.addInterceptor(interceptor)
.addPathPatterns("/**")
.excludePathPatterns("/user/**");
}
}

Controller

Test를 위해 콘솔에 해당 로그를 찍어보자.

IndexController (참고)

http://localhost:8080

UserController (참고)

http://localhost:8080/user

결과

~~ : Hello, User!
~~ : ================ Before Method
~~ : Hello, Spring Boot Interceptor
~~ : ================ Method Executed
~~ : ================ Method Completed

그 외

Interceptor 후처리를 이용하여 값을 가공하거나 header에 키값을 추가하는 등의 작업을 할 수 없다. (해도 header에서 해당 키값을 찾아볼 수 없다.) 이런 경우에는 ResponseBodyAdvice를 구현해야 한다.(참고)

참고

SpringBootSample / SpringBootInterceptor