스프링 MVC 프레임워크와 웹 환경 통합 가이드

Servlet 기반 스프링 컨텍스트 초기화 패턴

기존의 자바 웹 애플리케이션에서 스프링을 활용할 때, 각 서블릿 내부에서 `new ClassPathXmlApplicationContext()`를 반복 호출하면 설정 파일 중복 로드와 메모리 비효율 문제가 발생합니다. 이를 해결하기 위해 웹 컨테이너 시작 시점에 스프링 컨테이너를 단일 인스턴스로 생성하고, `ServletContext` 범위 내에 저장하는 설계가 필요합니다.

public class AppContextListener implements ServletContextListener {
    @Override
    public void contextInitialized(ServletContextEvent event) {
        try {
            String configLocation = event.getServletContext()
                .getInitParameter("springConfig");
            ApplicationContext container = new ClassPathXmlApplicationContext(configLocation);
            event.getServletContext().setAttribute("appContainer", container);
        } catch (Exception e) {
            throw new RuntimeException("컨테이너 초기화 실패", e);
        }
    }

    @Override
    public void contextDestroyed(ServletContextEvent event) {
        // 리소스 정리 필요 시 구현
    }
}

위 리스너를 `web.xml`에 등록하고, 전역 파라미터를 통해 설정 파일 위치를 외부화하면 결합도를 낮출 수 있습니다.

<!-- web.xml -->
<context-param>
    <param-name>springConfig</param-name>
    <param-value>application-config.xml</param-value>
</context-param>
<listener>
    <listener-class>com.demo.app.listener.AppContextListener</listener-class>
</listener>

실무에서는 스프링 프레임워크가 제공하는 `org.springframework.web.context.ContextLoaderListener`와 `WebApplicationContextUtils.getWebApplicationContext()` 메서드를 직접 사용합니다. 해당 클래스들은 컨텍스트 로드, 도메인 등록, 유틸리티 추상을 완전히封装하므로 개발자는 단순 설정과 조회만 수행하면 됩니다.


Spring MVC 아키텍처 및 기본 워크플로우

Spring MVC는 모델(Model)-뷰(View)-컨트롤러(Controller) 패러다임을 구현한 경량 HTTP 요청 처리 프레임워크입니다. 클라이언트의 요청은 항상 프론트 엔드 컨트롤러인 `DispatcherServlet`을 통하며, 이 중앙 컨트롤러가 나머지 컴포넌트(Handler Mapping, Adapter, View Resolver)를 조정하여 비즈니스 로직 실행 후 응답을 반환합니다.

표준 개발 단계는 다음과 같습니다:

  1. Maven 의존성 추가 (`spring-web`, `spring-webmvc`)
  2. `DispatcherServlet`을 `web.xml`에 매핑
  3. 어노테이션 기반 컨트롤러 클래스 및 뷰 생성
  4. `@RequestMapping`을 활용한 URL-메서드 매핑
  5. `spring-mvc.xml`에 컴포넌트 스캔 및 AD配置
  6. 테스트 환경 배포
// pom.xml 의존성 excerpt
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>5.0.5.RELEASE</version>
</dependency>
// web.xml 설정 excerpt
<servlet>
    <servlet-name>mvc-dispatcher</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:mvc-config.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>mvc-dispatcher</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

URL 매핑 및 컴포넌트 스캔 구성

`@RequestMapping`은 클래스 레벨과 메서드 레벨에 적용 가능하며, 요청 경로(HTTP Method, Query Params, Header 조건)를 세밀하게 제어할 수 있습니다.

@Controller
@RequestMapping("/api/users")
public class UserController {

    @RequestMapping(value = "/detail", method = RequestMethod.GET, params = {"memberId"})
    public String retrieve(@RequestParam String memberId) {
        return "user/detail";
    }
}

컴포넌트 스캔 시 특정 어노테이션만 포함하거나 제외하려면 `` 내 필터 태그를 활용합니다.

<!-- Controller 전용 스캔 -->
<context:component-scan base-package="com.demo.controller">
    <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
</context:component-scan>

정적 뷰 경로를 간소화하기 위해 `InternalResourceViewResolver`를 설정하면 컨트롤러에서 단순히 논리적 이름만 반환해도 자동으로 접두사/접미사가 조합됩니다.

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/views/" />
    <property name="suffix" value=".jsp" />
</bean>

응답 데이터 처리 전략

서버는 뷰를 렌더링하거나 순수 데이터(JSON/XML)를 반환해야 하는 목적에 따라 다른 패턴을 사용합니다.

뷰 렌더링

`ModelAndView`는 모델 데이터와 뷰 이름을 동시에 담을 수 있으나, 최근에는 `Model` 객체와 반환 타입 `String`을 분리하는 것이 권장됩니다.

@GetMapping("/render-view")
public String renderPage(Model model) {
    model.addAttribute("displayMsg", "조회 완료");
    return "index"; // internal resource resolver에 의해 /WEB-INF/views/index.jsp 매칭
}

데이터 직렬화 반환

클라이언트가 HTML이 아닌 문자열 또는 JSON을 원할 경우 `@ResponseBody` 어노테이션을 붙입니다. Jackson 라이브러리가 클래스패스에 있다면 `@RequestMappingHandlerAdapter`의 `messageConverters`에 `MappingJackson2HttpMessageConverter`가 등록되어 자바 객체를 자동으로 JSON으로 변환합니다.

// mvc-config.xml
<mvc:annotation-driven/>

// 컨트롤러
@ResponseBody
@GetMapping("/return-json")
public MemberDTO fetchJson() {
    MemberDTO dto = new MemberDTO();
    dto.setUid("user01");
    dto.setAge(28);
    return dto;
}

요청 파라미터 바인딩

Spring MVC는 HTTP 요청 데이터를 다양한 형식으로 바인딩할 수 있는 유연한 시스템 제공합니다.

  • 기본 타입/POJO: 파라미터 이름이 DTO 필드명과 일치하면 자동으로 할당됩니다.
  • 배열/리스트: HTML表单에서 동일한 `name` 속성을 복수 사용하면 `String[]`이나 `List<T>`로 수신 가능합니다.
  • RESTful 경로 추출: `@PathVariable`를 사용하여 URL 패턴 `{id}` 값을 메서드 파라미터에 매핑합니다.
  • 커스텀 컨버터: 날짜 형식 등 표준 변환이 안 될 경우 `Converter<S, T>` 인터페이스를 구현하고 ``에 등록합니다.
@PostMapping("/submit-form")
public String submit(@ModelAttribute SubmissionDto dto) {
    // 폼 데이터가 dto.username, dto.createdAt 등에 바인딩됨
    return "confirmation";
}

파일 업로드의 경우 `multipart/form-data` 인코딩 타입과 함께 `CommonsMultipartFile` 매개변수를 사용하며, `commons-fileupload` 의존성과 `CommonsMultipartResolver` 빈 설정이 필수입니다.

@PostMapping("/upload")
public String handleFile(String note, MultipartFile uploadedFile) throws IOException {
    Path dest = Paths.get("/data/uploads/", uploadedFile.getOriginalFilename());
    uploadedFile.transferTo(dest.toFile());
    return "success-page";
}

인터셉터(Interceptor) 동작 원리

필터(Filter)가 서블릿 컨테이너 수준의 요청/응답을 가로챈다면, 인터셉터는 Spring MVC 내부 파이프라인에서만 작동합니다. `HandlerInterceptor` 인터페이스를 구현하여 주요 생명주기를 제어할 수 있습니다.

  1. preHandle(): 타겟 컨트롤러 실행 전에 호출. boolean 반환값이 false이면 이후 흐름 중단.
  2. postHandle(): 타겟 실행 후, 뷰 렌더링 직전에 호출. Model 수정 가능.
  3. afterCompletion(): 전체 응답 마무리 후 호출. 주로 모니터링 또는 리소스 회수에 사용.
<!-- mvc-config.xml -->
<mvc:interceptors>
    <mvc:interceptor>
        <mvc:mapping path="/admin/**"/>
        <bean class="com.demo.interceptor.AuthValidator"/>
    </mvc:interceptor>
</mvc:interceptors>

여러 인터셉터를 설정할 경우, `preHandle`은 등록된 순서대로 실행되고, `postHandle`과 `afterCompletion`는 역순으로 실행됩니다. 이는 전형적인 데코레이터 패턴 동작을 따릅니다.


전역 예외 처리機制

애플리케이션 전역에서 발생할 수 있는 예외를统一 처리하기 위한 두 가지 방식이 제공됩니다.

  1. XML 기반 매핑: `SimpleMappingExceptionResolver`를 정의하여 예외 클래스명과 에러 뷰 이름을 매핑합니다.
  2. 구현체 기반 커스텀 리졸버: `HandlerExceptionResolver` 인터페이스를 구현하여 프로그램적으로 예외 분석과 뷰/상태코드 설정이 가능합니다.
public class GlobalExceptionHandler implements HandlerExceptionResolver {
    @Override
    public ModelAndView resolveException(HttpServletRequest req, HttpServletResponse res, Object handler, Exception ex) {
        ModelAndView mav = new ModelAndView("error/unexpected");
        if (ex instanceof ValidationException) {
            mav.setViewName("error/validation");
            mav.addObject("msg", "입력값이 정확하지 않습니다.");
        } else {
            mav.addObject("msg", "시스템 오류가 발생했습니다.");
        }
        return mav;
    }
}

통합 프로젝트 환경 구성 및 비즈니스 연동

실제 서비스 운영을 위해서는 스프링 컨테이너(빈 관리/트랜잭션), 스프링 MVC(웹 처리), 데이터 액세스 계층(JDBC/ORM)을 하나의 웹 모듈에 통합해야 합니다. `web.xml`에서 `ContextLoaderListener`를 스프링 루트 컨텍스트로, `DispatcherServlet`을 MVC 전용 컨텍스트로 분리하면 레이어 간 의존성 충돌을 방지할 수 있습니다.

<!-- applicationContext.xml (Data & Service Layer) -->
<context:property-placeholder location="classpath:db.properties"/>
<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
    <property name="driverClass" value="${db.driver}"/>
    <property name="jdbcUrl" value="${db.url}"/>
    <property name="user" value="${db.user}"/>
    <property name="password" value="${db.pass}"/>
</bean>
<bean id="jdbcTemplate" class="org.springframework.jdbc.core.JdbcTemplate">
    <property name="dataSource" ref="dataSource"/>
</bean>

비즈니스 로직 연동 시 컨트롤러는 서비스 레이어 의존성을 주입 받고, DAO 레이어에서는 `JdbcTemplate`을 활용해 ORM 없이 SQL 쿼리를 실행합니다. `BeanPropertyRowMapper`를 사용하면 결과 집합을 자동으로 엔티티 DTO로 변환합니다.

// Repository Layer
@Repository
public class RoleRepositoryImpl implements RoleRepository {
    private final JdbcTemplate jdbc;
    
    @Autowired public RoleRepositoryImpl(JdbcTemplate jdbc) { this.jdbc = jdbc; }
    
    @Override public List<RoleEntity> findAllRoles() {
        return jdbc.query("SELECT r_id, r_name, r_desc FROM sys_role", 
            BeanPropertyRowMapper.newInstance(RoleEntity.class));
    }
}

이러한 레이어 구조를 바탕으로 컨트롤러는 조회 결과를 `Model`에 담아 뷰 엔진으로 전달하며, 전체 흐름은 프론트 엔드 컨트롤러가 일관되게 조율합니다.

태그: SpringMVC DispatcherServlet HandlerInterceptor @RequestMapping JdbcTemplate

10월 13일 03:21에 게시됨