📌 Spring Interceptor 정리

📅 날짜

2025-04-29

---

📝 학습 내용

1️⃣ Interceptor란?

• 스프링 MVC 요청 처리 흐름에 개입할 수 있는 가로채기 기능
• 컨트롤러 실행 전/후, 뷰 렌더링 후에도 개입 가능
• 주로 인증/인가, 로깅, 공통 데이터 처리 등에 활용
• 서브컨트롤러별로 필터링할 수 있는 기능을 추가하는 것이라고 이해하면 됨

---

2️⃣ Interceptor 작동 시점

메서드	설명
preHandle()	컨트롤러 호출 전에 실행 (핵심 메서드)
postHandle()	컨트롤러 실행 후, 뷰 렌더링 전에 실행
afterCompletion()	뷰 렌더링 완료 후 실행 (예외 발생 여부와 무관하게 항상 실행됨)

---

3️⃣ Interceptor 전체 흐름 요약

클라이언트 요청
      ↓
DispatcherServlet 도착
      ↓
등록된 인터셉터의 preHandle() 호출
      ↓
컨트롤러 실행
      ↓
인터셉터의 postHandle() 호출
      ↓
뷰 렌더링
      ↓
인터셉터의 afterCompletion() 호출
      ↓
응답 완료

🔹 출력 로그 예시

MemoInterceptor's preHandle...
INFO : com.example.app.controller.MemoController - GET /memo/add...
MemoInterceptor's postHandle...
MemoInterceptor's afterCompletion...

---

4️⃣ Interceptor 설정 방법 (Java Config 기반)

✅ Java 기반 설정 방식

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new MemoInterceptor())
                .addPathPatterns("/memo/*")                // 해당 경로에만 인터셉터 적용
                .excludePathPatterns("/memo/login");       // 특정 경로는 제외 가능
    }
}

✅ 설명 요약

• addInterceptor() : 사용할 인터셉터를 등록
• addPathPatterns() : 특정 URL 패턴에만 적용
• excludePathPatterns() : 특정 경로를 인터셉터 처리 대상에서 제외 (예: 로그인 페이지 등)
• Java 설정을 통해 XML 없이도 깔끔하게 관리 가능

---

5️⃣ 참고 이미지

• Interceptor 동작 시점 구조도
  

---

🔥 정리

• Interceptor는 클라이언트 요청 흐름에 사전/사후 개입할 수 있는 필터 개념
• 인증, 인가, 로깅, 예외 처리, 공통 Model 설정 등 다양한 영역에 활용 가능
• preHandle() → 요청 차단 or 진행 여부 결정 postHandle() → ModelAndView 수정 afterCompletion() → 리소스 정리 및 예외 처리
  
• Java 기반 설정이므로 유지보수성과 확장성이 뛰어남
• excludePathPatterns()를 활용해 로그인/정적 리소스 등은 필터링 대상에서 제외 가능

---

🔗 참고 자료

• Spring 공식 문서 - Interceptors
• Velog 관련 포스트 예시

---