설정 파일 3종 해부

학습 목표

⚠️ XML 의 첫인상

🛠️ 3 가지 파일의 분업

① web.xml — 관문

아래 세 블록이 들어갑니다 — Spring 컨테이너 시작 / DispatcherServlet 등록 / 한글 깨짐 필터.

① web.xml — 코드 (1/3)

① Spring Root 컨테이너 시작

<web-app xmlns="...">

    <!-- ① Spring 컨테이너 시작 -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/spring/root-context.xml</param-value>
    </context-param>
    <listener>
        <listener-class>
            org.springframework.web.context.ContextLoaderListener
        </listener-class>
    </listener>

① web.xml — 코드 (2/3)

② DispatcherServlet 등록 + URL 매핑

    <!-- ② DispatcherServlet 등록 -->
    <servlet>
        <servlet-name>appServlet</servlet-name>
        <servlet-class>
            org.springframework.web.servlet.DispatcherServlet
        </servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/spring/appServlet/servlet-context.xml</param-value>
        </init-param>
    </servlet>
    <servlet-mapping>
        <servlet-name>appServlet</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

① web.xml — 코드 (3/3)

③ 한글 깨짐 필터

    <!-- ③ 한글 깨짐 필터 -->
    <filter>
        <filter-name>encodingFilter</filter-name>
        <filter-class>
            org.springframework.web.filter.CharacterEncodingFilter
        </filter-class>
        <init-param>
            <param-name>encoding</param-name>
            <param-value>UTF-8</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>encodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

</web-app>

① web.xml 의 핵심 3 가지

👉 web.xml 을 한 번 작성하면 거의 안 건드림. encoding 필터만 자주 등장.

② root-context.xml — 백엔드 설계도

크게 다섯 블록 — Service 스캔 / DB 커넥션 풀 / SqlSessionFactory / Mapper 스캔 / 트랜잭션.

② root-context.xml — 코드 (1/2)

<beans xmlns="..." xmlns:context="...">

    <!-- ① Service / DAO 자동 스캔 -->
    <context:component-scan base-package="com.example.demo.service" />

    <!-- ② DB 커넥션 풀 -->
    <bean id="hikariConfig" class="com.zaxxer.hikari.HikariConfig">
        <property name="driverClassName" value="com.mysql.cj.jdbc.Driver" />
        <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/spring_db" />
        <property name="username" value="root" />
        <property name="password" value="1234" />
    </bean>
    <bean id="dataSource" class="com.zaxxer.hikari.HikariDataSource"
          destroy-method="close">
        <constructor-arg ref="hikariConfig" />
    </bean>

② root-context.xml — 코드 (2/2)

    <!-- ③ MyBatis SqlSessionFactory -->
    <bean id="sqlSessionFactory"
          class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource" />
        <property name="configLocation" value="classpath:mybatis-config.xml" />
        <property name="mapperLocations" value="classpath:mappers/*Mapper.xml" />
    </bean>

    <!-- ④ Mapper 자동 스캔 -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.example.demo.mapper" />
    </bean>

    <!-- ⑤ 트랜잭션 -->
    <bean id="transactionManager"
          class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource" />
    </bean>
    <tx:annotation-driven />

</beans>

② root-context.xml 5 블록

👉 「DB 5 단계 지도」 차시의 ②번이 바로 이 파일.

③ servlet-context.xml — 웹 설계도

다섯 블록 — MVC 활성화 / 정적 자원 / ViewResolver / Controller 스캔 / 인터셉터.

③ servlet-context.xml — 코드 (1/2)

<beans:beans xmlns="http://www.springframework.org/schema/mvc"
              xmlns:beans="http://www.springframework.org/schema/beans"
              xmlns:context="...">

    <!-- ① Spring MVC 활성화 -->
    <annotation-driven />

    <!-- ② 정적 자원 (JS, CSS, 이미지) 처리 -->
    <resources mapping="/resources/**" location="/resources/" />

    <!-- ③ ViewResolver — JSP 경로 조립 -->
    <beans:bean id="viewResolver"
                 class="...InternalResourceViewResolver">
        <beans:property name="prefix" value="/WEB-INF/views/" />
        <beans:property name="suffix" value=".jsp" />
    </beans:bean>

③ servlet-context.xml — 코드 (2/2)

    <!-- ④ Controller 자동 스캔 -->
    <context:component-scan base-package="com.example.demo.controller" />

    <!-- ⑤ 인터셉터 등록 (v4 에서 추가) -->
    <interceptors>
        <interceptor>
            <mapping path="/board/write"/>
            <mapping path="/mypage/**"/>
            <exclude-mapping path="/login"/>
            <beans:bean class="com.example.demo.interceptor.LoginInterceptor"/>
        </interceptor>
    </interceptors>

</beans:beans>

③ servlet-context.xml 5 블록

왜 root 와 servlet 으로 나누나?

   Root 컨테이너 (root-context.xml)
       │ ▲ Servlet 컨테이너가 Root 의 Bean 사용 가능
       │ │ Root 는 Servlet 의 Bean 사용 불가
   Servlet 컨테이너 (servlet-context.xml)

왜 이렇게 복잡한가

component-scan vs <bean>

<!-- 방식 ① component-scan (현대) -->
<context:component-scan base-package="com.example.demo.service" />

@Service
public class BoardService { ... }   // 자동 등록

<!-- 방식 ② <bean> 직접 (옛 방식) -->
<bean id="boardService"
      class="com.example.demo.service.BoardService" />

👉 component-scan 이 훨씬 간결. 본 과정은 component-scan 사용.
<bean> 은 외부 라이브러리의 클래스를 등록할 때 (예: HikariDataSource).

자주 만나는 오류

네임스페이스 (xmlns) 정리

<beans xmlns="...beans"
       xmlns:context="...context"
       xmlns:tx="...tx"
       xmlns:mvc="...mvc">

    <bean ... />                  ← 기본 (beans)
    <context:component-scan ... />  ← context 그룹의 태그
    <tx:annotation-driven />        ← tx 그룹의 태그
    <mvc:interceptors> ... </mvc:interceptors>
</beans>

실험 — 직접 깨뜨려보기

👉 일부러 한 번씩 깨뜨려보면 「설정 한 줄이 어떤 동작을 책임지는지」 가 머리에 박힙니다.

Spring Boot 와의 비교

👉 Boot 는 이 차시의 모든 XML 을 「자동」 으로. Legacy 를 한 번 봐두면 Boot 가 무엇을 자동화하는지 보임.

읽는 순서 — 디버깅 시

🔄 Before / After

이번 차시의 데이터 흐름

정리

다음: 한글 깨짐 필터 — 학생이 가장 먼저 만나는 「??? 글자」.