📌 Spring MVC - HandlerMapping 완전 정리

📅 2025-04-29

---

📝 학습 내용

---

1️⃣ HandlerMapping 개요

✅ HandlerMapping이란?

• Spring MVC에서 클라이언트 요청을 받아 어떤 핸들러(컨트롤러)로 전달할지 결정하는 전략 인터페이스
• DispatcherServlet → HandlerMapping → Controller 호출 구조
• 대표적인 구현체:
  • BeanNameUrlHandlerMapping
  • SimpleUrlHandlerMapping
  • RequestMappingHandlerMapping

---

2️⃣ HandlerMapping 설정 코드

✅ BeanNameUrlHandlerMapping

• 요청 URL과 Bean 이름을 매칭
• 예시 코드:

@Bean
BeanNameUrlHandlerMapping beanNameUrlHandlerMapping() {
    return new BeanNameUrlHandlerMapping();
}

@Bean("/custom_01")
public CustomHandler customHandler() {
    return new CustomHandler();
}

---

✅ SimpleUrlHandlerMapping

• 개발자가 직접 URL-Handler를 매핑하는 방식
• 주로 정적 자원(css, js 등)에 대한 요청을 처리하기 위해 기본적으로 설정된다.
• 예시 코드:

@Bean
SimpleUrlHandlerMapping simpleUrlHandlerMapping() {
    SimpleUrlHandlerMapping handlerMapping = new SimpleUrlHandlerMapping();

    Map<String, Object> urlMap = new HashMap<>();
    urlMap.put("/custom_02", new CustomHandler());
    handlerMapping.setUrlMap(urlMap);

    return handlerMapping;
}

---

✅ RequestMappingHandlerMapping

• @RequestMapping, @GetMapping, @PostMapping 등을 통한 매핑
• 스프링 부트에서는 기본 설정
• 직접 등록하는 예시:

@Bean
RequestMappingHandlerMapping requestMappingHandlerMapping() throws NoSuchMethodException, SecurityException {
    RequestMappingHandlerMapping handlerMapping = new RequestMappingHandlerMapping();

    RequestMappingInfo mappingInfo = RequestMappingInfo
            .paths("/custom_03")
            .methods(RequestMethod.GET)
            .build();

    Method method = CustomHandler.class.getMethod("hello", null);

    handlerMapping.registerMapping(mappingInfo, new CustomHandler(), method);

    return handlerMapping;
}

---

3️⃣ HandlerMapping을 커스텀하게 사용하는 이유

✅ 기본 제공 매핑만으로는 한계가 있을 때

• 외부 시스템 연동이나, 규칙 없는 다양한 URL 대응이 필요할 때
• 복잡한 요청 분기 로직이 필요한 경우

✅ 요청 URL → 핸들러 매핑을 프로그래밍적으로 제어하고 싶을 때

• 런타임에 매핑을 추가하거나 제거해야 할 경우
• 설정 파일을 읽어 매핑을 동적으로 적용하는 경우

✅ 복잡한 매핑 정책을 구현하고 싶을 때

• 단순 경로 매칭이 아니라, 요청 Header, Content-Type, IP 주소 등에 따라 매핑을 달리해야 할 때

✅ 스프링 기본 매핑 방식을 확장하거나 보완하고 싶을 때

• 기존 컨트롤러 매핑은 유지하면서 별도 커스텀 요청을 처리하고자 할 때

---

4️⃣ CustomHandler 클래스

✅ CustomHandler 예시

// Custom URL Handler 클래스
public class CustomHandler implements Controller {

    @Override
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
        System.out.println("CustomHandler's handleRequest");
        return null;
    }

    public void hello() {
        System.out.println("CustomHandler's hello!!...");
    }
}

---

5️⃣ 서버 실행 결과

🔹 매핑 확인 로그

• BeanNameUrlHandlerMapping:

  Mapped URL path [/custom_01] onto handler '/custom_01'
  

• SimpleUrlHandlerMapping:

  Mapped URL path [/custom_02] onto handler of type [class com.example.app.handler.CustomHandler]
  

• RequestMappingHandlerMapping:

  Mapped "{[/custom_03],methods=[GET]}" onto public void com.example.app.handler.CustomHandler.hello()
  

🔹 출력 결과

• /custom_01 요청 시:

  CustomHandler's handleRequest
  

• /custom_03 요청 시 (GET):

  CustomHandler's hello!!...
  

---

🔗 참고 자료

• Spring 공식 문서 - Web MVC Framework

---

🧠 느낀 점

• Spring MVC의 핵심 처리 과정인 HandlerMapping의 세 가지 주요 방식을 코드로 직접 구성해보면서 동작 원리를 명확히 이해할 수 있었다.
• 특히 RequestMappingHandlerMapping을 통해 Reflection을 사용하여 메서드를 수동으로 등록할 수 있다는 점이 굉장히 흥미로웠다.
• 실습을 통해 DispatcherServlet이 다양한 HandlerMapping을 통해 요청을 매핑하고 처리하는 전체 과정을 체험할 수 있었다.

---

✍️ 요약

• HandlerMapping은 요청 URL과 Controller/Method를 연결하는 핵심 인터페이스다.
• 주요 구현체:
  • BeanNameUrlHandlerMapping: Bean 이름과 URL 매칭
  • SimpleUrlHandlerMapping: 개발자가 직접 매핑 설정
  • RequestMappingHandlerMapping: @RequestMapping 기반 매핑
• 커스텀 HandlerMapping은 복잡하거나 동적인 요청 처리를 위해 필수적이다.
• 서버 로그를 통해 매핑 과정을 명확히 확인할 수 있다.

---