[Spring🌱] XML Configuration 📄

XML Configuration 🛠️

XML을 사용해 Bean을 설정 하는 것은 Annotation이 없던 시절에 사용됐으며 최근에는 거의 사용하지 않는다.

하지만 Legacy 코드를 보기 위해 볼 수도 있으니 이해가 필요하다.

XML Configuration 예제 코드 📄

Java 코드

package com.hippoo.studyspring.examples.h1;

import com.hippoo.studyspring.game.GameRunner;
import java.util.Arrays;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class XmlConfigurationContextLauncherApplication {

    public static void main(String[] args) {
        try (var context = new ClassPathXmlApplicationContext("contextConfiguration.xml")) {

            Arrays.stream(context.getBeanDefinitionNames()).forEach(System.out::println);

            System.out.println(context.getBean("name"));
            System.out.println(context.getBean("age"));
            context.getBean(GameRunner.class).run();
        }

    }
}

XML 설정 파일

위치: resources/contextConfiguration.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context" xsi:schemaLocation="
        http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">

    <bean id="name" class="java.lang.String">
        <constructor-arg value="Ranga"/>
    </bean>

    <bean id="age" class="java.lang.Integer">
        <constructor-arg value="35"/>
    </bean>

    <context:component-scan base-package="com.hippoo.studyspring.game"/>

    <bean id="game" class="com.hippoo.studyspring.game.PacmanGame"/>
    <bean id="gameRunner" class="com.hippoo.studyspring.game.GameRunner">
        <constructor-arg ref="game" />
    </bean>
</beans>

설명 📝

XML 파일을 통해 스프링 빈을 설정할 수 있으며, <bean> 태그를 사용하여 빈을 생성한다. 이는 @Bean, @Component 등의 어노테이션을 사용하는 것과 동일한 역할을 하며, 생성자 인수로 객체를 넘길 때는 ref 옵션을 추가하여 의존성을 주입한다.

예전에는 @Configuration, @Component, @Bean과 같은 어노테이션이 없었기 때문에 XML로 모든 설정을 했다. 최근에 만들어진 코드들은 설정을 어노테이션으로 주로 사용하지만, 여전히 기존의 XML 설정을 사용하는 프로젝트들이 많기 때문에 이를 이해가 필요하다.

어노테이션과 비교표 📊

아래 표는 XML 설정과 어노테이션 기반 설정의 주요 차이점을 비교한 것.

Pros & Cons ⚖️

Pros ✅

• 순수 자바로 POJO 유지: XML 설정은 순수 자바 객체를 유지할 수 있어 테스트가 용이합니다.
• 디버깅이 조금 더 쉽다: 어노테이션의 경우 스프링 프레임워크가 알아서 설정을 처리하기 때문에 프레임워크의 동작을 깊이 이해해야 하지만, XML 설정은 설정 파일을 직접 보고 이해할 수 있습니다.

Cons ❌

• 유지보수가 힘들다: XML 설정 파일이 커질수록 관리하기 어려워집니다.
• 장황하다: 어노테이션에 비해 설정이 길어져 코드가 장황해질 수 있습니다.

TIP 💡

Annotation과 XML 중 하나만 사용해서 설정을 일관성 있게 유지. 두 가지 방식을 혼용하면 설정의 복잡성이 증가하고 유지보수가 어려워질 수 있다.

참고자료 📚

• Spring Framework XML Configuration Reference
• Spring Framework XSD Schemas