스프링 BeanDefinition 완벽 정리: 빈 설정 메타정보 탐구

스프링 BeanDefinition 완벽 정리: 빈 설정 메타정보 탐구

1. BeanDefinition이란?

BeanDefinition은 스프링 컨테이너가 빈(bean)의 메타정보를 담아두는 추상화 모델이다. 스프링은 다양한 형태의 빈 설정 정보(Java Config, XML, 어노테이션)를 모두 BeanDefinition이라는 하나의 모델로 추상화하여 사용한다.

즉, 개발자가 Java 코드로 설정하든, XML로 설정하든 스프링 내부에서는 결국 BeanDefinition 객체로 변환되어 관리된다.

 

 

2. BeanDefinition 주요 정보

BeanDefinition이 담고 있는 주요 속성은 다음과 같다:

• BeanClassName: 생성할 빈의 클래스명
  • 예) hello.core.service.MemberServiceImpl
  • 팩토리 메서드 방식에서는 생략될 수 있다.
• factoryBeanName: 팩토리 역할을 하는 빈의 이름
  • 예) appConfig
• factoryMethodName: 빈을 생성할 팩토리 메서드명
  • 예) memberService
• Scope: 빈의 범위(기본값: 싱글톤)
  • 예) singleton, prototype
• lazyInit: 빈을 지연 초기화할지 여부
  • true로 설정 시 스프링 컨테이너가 빈을 바로 생성하지 않고, 실제 사용할 때까지 생성을 지연한다.
• InitMethodName: 빈의 초기화 메서드
  • 빈 생성 후 의존관계 주입이 완료된 뒤 호출된다.
• DestroyMethodName: 빈의 소멸 메서드
  • 빈의 생명주기가 끝나기 직전에 호출된다.
• Constructor Arguments, Properties: 의존관계 주입 시 사용된다.

 

3. BeanDefinition 예제 코드

아래는 AnnotationConfigApplicationContext를 사용하여 BeanDefinition 정보를 확인하는 코드다.

package hello.core.beandefinition;

import hello.core.AppConfig;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.config.BeanDefinition;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;

public class BeanDefinitionTest {
    AnnotationConfigApplicationContext ac = new AnnotationConfigApplicationContext(AppConfig.class);

    @Test
    @DisplayName("빈 설정 메타정보 확인")
    void findApplicationBean() {
        // 스프링 컨테이너에 등록된 모든 빈 이름 가져오기
        String[] beanDefinitionNames = ac.getBeanDefinitionNames();

        for (String beanDefinitionName : beanDefinitionNames) {
            BeanDefinition beanDefinition = ac.getBeanDefinition(beanDefinitionName);

            // ROLE_APPLICATION: 일반적으로 사용자가 등록한 빈
            if (beanDefinition.getRole() == BeanDefinition.ROLE_APPLICATION) {
                System.out.println("beanDefinitionName = " + beanDefinitionName +
                        " beanDefinition = " + beanDefinition);
            }
        }
    }
}

 

4. 실행 결과

위 코드를 실행하면 스프링 컨테이너에 등록된 빈들의 BeanDefinition 정보가 출력된다.

beanDefinitionName = memberService beanDefinition = Generic bean: class [hello.core.service.MemberServiceImpl]; scope=singleton; abstract=false; lazyInit=false
beanDefinitionName = orderService beanDefinition = Generic bean: class [hello.core.service.OrderServiceImpl]; scope=singleton; abstract=false; lazyInit=false
...

 

출력된 정보에서 확인할 수 있는 것:

• 빈 클래스명
• 스코프(singleton)
• 초기화 여부(lazyInit=false)

 

5. BeanDefinition을 직접 등록하기

BeanDefinition은 필요에 따라 직접 생성해서 스프링 컨테이너에 등록할 수도 있다. 하지만 실무에서는 이러한 방식은 거의 사용되지 않는다.

package hello.core.beandefinition;

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.support.BeanDefinitionBuilder;
import org.springframework.beans.factory.support.DefaultListableBeanFactory;
import org.springframework.beans.factory.config.BeanDefinition;

public class DirectBeanDefinitionTest {

    @Test
    void registerBeanDefinition() {
        DefaultListableBeanFactory beanFactory = new DefaultListableBeanFactory();

        // BeanDefinition 생성
        BeanDefinition beanDefinition = BeanDefinitionBuilder
                .genericBeanDefinition(HelloService.class)
                .addPropertyValue("name", "Hello Bean")
                .getBeanDefinition();

        // BeanDefinition을 컨테이너에 등록
        beanFactory.registerBeanDefinition("helloService", beanDefinition);

        // 빈 조회 및 실행
        HelloService helloService = (HelloService) beanFactory.getBean("helloService");
        helloService.sayHello();
    }

    static class HelloService {
        private String name;

        public void setName(String name) {
            this.name = name;
        }

        public void sayHello() {
            System.out.println("Hello " + name);
        }
    }
}

 

 

총 정리

• BeanDefinition은 스프링이 빈의 메타정보를 추상화한 모델이다.
• Java, XML, 어노테이션 설정 등 다양한 방식으로 설정된 빈들은 결국 BeanDefinition 객체로 관리된다.
• 실무에서는 BeanDefinition을 직접 다룰 일은 거의 없으며, 스프링 내부 동작 원리나 코드에서 보이는 정도로 이해하면 충분하다.