[Spring] 스프링 핵심 원리 - 컴포넌트 스캔

컴포넌트 스캔과 의존관계 자동 주입 시작하기

요약

• 컴포넌트 스캔 : 스프링 컨테이너에 스프링 빈을 등록하는 것
  • @ComponentScan 사용 : @Component 어노테이션이 붙은 클래스를 스캔해서 스프링 빈으로 등록함
• 의존관계 자동 주입 : 등록된 스프링 빈 간의 의존관계를 생성하는 것, @Autowired 사용

 

1) 컴포넌트 스캔

• 스프링은 설정 정보가 없어도 자동으로 스프링 빈을 등록하는 컴포넌트 스캔이라는 기능을 제공함
  • *설정 정보 : @Bean이나 XML의 <bean> 등을 통해 설정 정보에 직접 등록할 스프링 빈을 나열하는 것
• 컴포넌트 스캔을 사용하려면 @ComponentScan을 설정 정보에 붙여주면 됨
  • @Component 어노테이션이 붙은 클래스를 스캔해서 스프링 빈으로 등록함
  • 스프링 빈의 기본 이름은 클래스명을 사용하되 맨 앞글자만 소문자로 사용함
    • 빈 이름 직접 지정도 가능함

 

2) 의존관계 자동 주입

• @Autowired 를 사용하면, 스프링 컨테이너가 자동으로 해당 스프링 빈을 찾아서 주입해줌
  • 이때 기본 조회 전략은 타입이 같은 빈을 찾아서 주입함
    • getBean(XX.class)

 

탐색 위치와 기본 스캔 대상

1) 탐색할 패키지의 시작 위치 지정

• @ComponentScan
  • basePackages : 탐색할 패키지의 시작 위치를 지정함, 이 패키지를 포함해서 하위 패키지를 모두 탐색함
  • basePackageClasses : 지정한 클래스의 패키지를 탐색 시작 위치로 지정함
  • 지정하지 않으면 @ComponentScan이 붙은 설정 정보 클래스의 패키지가 시작 위치가 됨
• 권장 방법
  • 패키지 위치를 지정하지 않고, 설정 정보 클래스의 위치를 프로젝트 최상단에 두는 것
    • 스프링부트도 이 방법을 기본으로 제공
      • @SpringBootApplication은 @ComponentScan을 포함하고 있는 합성 어노테이션
      • 해당 어노테이션이 붙은 클래스의 위치는 프로젝트 최상단이어야 함

 

2) 컴포넌트 스캔 기본 대상

• @Component 및 해당 어노테이션을 포함하고 있는 합성 어노테이션 목록
  • @Component : 컴포넌트 스캔 대상
  • @Controller : 스프링 MVC 컨트롤러로 인식
  • @Service : 특별한 처리를 하지 않음, 비즈니스 계층임을 인식하는 용도
  • @Repository : 스프링 데이터 접근 계층으로 인식, 데이터 계층의 예외를 스프링 예외로 변환해줌
  • @Configuration : 스프링 설정 정보로 인식, 스프링 빈이 싱글톤을 유지하도록 추가 처리함

 

중복 등록과 충돌

빈 등록 방식 2가지

• 자동 빈 등록 : @Component 사용
• 수동 빈 등록 : @Bean 사용

 

빈 중복 등록(동일한 이름의 빈이 등록되는 것) 상황

• 자동 빈 등록 vs 자동 빈 등록
  • 컴포넌트 스캔에 의해 자동으로 스프링 빈이 등록됨
  • 빈 이름 충돌 시 스프링에서 ConflictingBeanDefinitionException 예외 발생시킴
• 수동 빈 등록 vs 자동 빈 등록
  • 스프링에서는?
    • 수동 빈 등록이 우선권을 가져서 수동 빈이 자동 빈을 오버라이딩 함
  • 스프링부트에서는?
    • 수동 빈 등록과 자동 빈 등록이 충돌나면 오류가 발생하도록 기본으로 설정함
    • 아래 에러 출력됨
    • `Consider renaming one of the beans or enabling overriding by setting spring.main.allow-bean-definition-overriding=true`

 

참고

스프링 핵심 원리 - 기본편