[6주차] 컨트롤러 확장2 - 정인철

[incheol789]

6주차 - Controller 매핑 및 실행 책임 분리

구현 내용

인터페이스 기반 Controller와 애너테이션 기반 Controller가 공존하는 상황에서,
DispatcherServlet이 두 방식을 구분 없이 처리할 수 있도록 매핑과 실행 책임을 분리했습니다.

---

핵심 설계

요청 처리 흐름은 아래와 같습니다.

HTTP 요청
  └─ DispatcherServlet
       ├─ HandlerMapping.getHandler()   → 핸들러 탐색 (매핑 책임)
       ├─ HandlerAdapter.supports()     → 어댑터 선택
       ├─ HandlerAdapter.handle()       → 핸들러 실행 (실행 책임)
       └─ ViewResolver → View.render()  → 응답 렌더링

DispatcherServlet은 Controller가 인터페이스 기반인지 애너테이션 기반인지 알지 못하고,
HandlerMapping과 HandlerAdapter가 각자의 책임을 담당합니다.

---

변경 사항

1. ApplicationContext - URL 매핑 책임 제거

ApplicationContext는 빈 생성·관리만 담당해야 합니다.
기존에는 getControllerMapping()이 URL 매핑까지 처리하고 있어 웹 MVC 관심사가 IoC 컨테이너에 혼재되어 있었습니다.

변경 전

// ApplicationContext가 URL 매핑을 직접 생성
public Map<String, Controller> getControllerMapping() {
    ...filter(bean -> bean instanceof Controller)
    ...mapping.put(annotation.value(), controller)  // @RequestMapping 값을 URL로 사용
}

변경 후

// 빈 이름 정보를 포함한 Map 반환, URL 매핑 책임은 HandlerMapping으로 이전
public Map<String, Object> getBeans() {
    return Collections.unmodifiableMap(beans);
}

---

2. SimpleUrlHandlerMapping - 빈 이름 기반 자체 초기화

기존에는 외부(ApplicationContext)에서 만든 Map을 생성자로 주입받았습니다.
AnnotationHandlerMapping이 initialize()로 스스로 초기화하는 것과 달리 일관성이 없었습니다.

변경 전

// 외부에서 이미 완성된 Map을 주입받음
public SimpleUrlHandlerMapping(Map<String, Controller> handlerMap) {
    this.handlerMap = handlerMap;
}

변경 후

// 빈 목록을 받아 Controller 인터페이스 구현체를 직접 탐색
// 빈 이름 자체가 URL이 됨 → "빈 이름에 url을 매핑하는 방식"
public void initialize(Map<String, Object> beans) {
    beans.forEach((beanName, bean) -> {
        if (bean instanceof Controller) {
            handlerMap.put(beanName, (Controller) bean);
        }
    });
}

---

3. AnnotationHandlerMapping - 파라미터 타입 통일

getBeans()의 반환 타입이 Map<String, Object>로 변경됨에 따라 파라미터 타입을 맞췄습니다.
내부 로직은 .values()로 접근하므로 동일하게 동작합니다.

// Collection<Object> → Map<String, Object>
public void initialize(Map<String, Object> beans) {
    beans.values().stream()
            .filter(bean -> bean.getClass().isAnnotationPresent(Controller.class))
            .forEach(this::registerHandler);
}

이로써 두 HandlerMapping이 동일한 초기화 패턴을 갖게 됩니다.

// LectureApplication - 대칭적인 초기화 구조
Map<String, Object> beans = ac.getBeans();

annotationHM.initialize(beans);  // 애너테이션 기반
simpleHM.initialize(beans);      // 인터페이스 기반

---

4. WebConfig - 인터페이스 기반 Controller 등록

@Bean의 value에 URL을 지정해 빈 이름 자체가 URL이 되도록 등록합니다.
Controller가 @FunctionalInterface이므로 람다로 간결하게 구현했습니다.

@Component
public class WebConfig {

    @Bean("/home")
    public Controller homeController() {
        return (req, resp) -> new ModelAndView("redirect:/lectures");
    }
}

SimpleUrlHandlerMapping이 초기화 시 빈 이름 /home을 URL 키로 등록합니다.

---

두 방식 비교

구분	매핑	실행
인터페이스 기반	SimpleUrlHandlerMapping (빈 이름 = URL)	SimpleControllerHandlerAdapter (handleRequest() 호출)
애너테이션 기반	AnnotationHandlerMapping (URL + HTTP Method)	AnnotationHandlerAdapter (Method.invoke() 호출)

---

동작 확인

요청	방식	결과
GET /lectures	애너테이션 기반	200 OK
POST /lectures	애너테이션 기반	302 redirect
GET /home	인터페이스 기반	302 → /lectures