[스프링 핵심 원리 - 기본편] 같은 타입의 빈 여러 개 조회 문제

조회 대상 빈이 2개 이상 문제

• @Autowired 는 타입(Type)으로 조회한다.

• 타입으로 조회하면 선택된 빈이 2개 이상일 때 문제가 발생한다.

• 이러한 문제가 발생했을 때 주입 대상 객체를 하위 타입으로 지정할 수 도 있지만, 하위 타입으로 지정하는 것은 DIP를 위배하고 유연성이 떨어진다. 그리고 이름만 다르고, 완전히 똑같은 타입의 스프링 빈이 2개 있는 경우에는 똑같이 문제가 발생한다.

• 스프링 빈을 수동 등록해서 문제를 해결해도 되지만, 의존 관계 자동 주입에서 해결하는 여러 방법이 있다.

 

조회 대상 빈이 2개 이상일 때 해결 방법

• @Autowired 필드 명 매칭
• @Autowired 는 타입 매칭을 시도하고, 이때 여러 빈이 있으면 필드 이름, 파라미터 이름으로 빈 이름을 추가 매칭한다.
  • @Autowired private DiscountPolicy discountPolicy
    • DiscountPolicy 타입의 빈이 여러 개 존재한다면 문제가 발생한다.
  • @Autowired private DiscountPolicy rateDiscountPolicy
  • 필드 명을 등록되어있는 빈 이름으로 변경하면 DiscountPolicy 타입의 빈이 여러 개 존재하더라도 정상 주입된다.
    
    

• @Autowired 매칭 정리
  • 필드 명 매칭은 먼저 타입 매칭을 시도 하고 그 결과에 여러 빈이 있을 때 추가로 동작하는 기능이다.
  • 1. 타입 매칭
  • 2. 타입 매칭의 결과가 2개 이상일 때 필드 명, 파라미터 명으로 빈 이름 매칭

---

• @Qualifier 사용

• @Qualifier 는 추가 구분자를 붙여주는 방법이다. 의존성 주입 시 추가적인 방법을 제공하는 것이지 빈 이름을 변경하는 것은 아니다.

• 빈 등록시 @Qualifier를 붙여 준다.

@Component
@Qualifier("mainDiscountPolicy")
public class RateDiscountPolicy implements DiscountPolicy {}

@Component
@Qualifier("fixDiscountPolicy")
public class FixDiscountPolicy implements DiscountPolicy {}

• 의존성 주입 시에 @Qualifier를 붙여주고 등록한 이름을 적어준다.

//생성자 자동 주입 예시
@Autowired
public OrderServiceImpl(MemberRepository memberRepository, @Qualifier("mainDiscountPolicy") DiscountPolicy discountPolicy) {
 this.memberRepository = memberRepository;
 this.discountPolicy = discountPolicy;
}
//수정자 자동 주입 예시
@Autowired
public DiscountPolicy setDiscountPolicy(@Qualifier("mainDiscountPolicy") DiscountPolicy discountPolicy) {
 return discountPolicy;
}

//직접 빈 등록시에도 @Qualifier를 동일하게 사용할 수 있다.
@Bean
@Qualifier("mainDiscountPolicy")
public DiscountPolicy discountPolicy() {
 return new ...
}

• @Qualifier 로 주입할 때 @Qualifier("mainDiscountPolicy") 를 못찾으면 mainDiscountPolicy라는 이름의 스프링 빈을 추가로 찾는다. 하지만 @Qualifier 는 @Qualifier 를 찾는 용도로만 사용하는게 명확하고 좋다.

 

• @Qualifier 정리
  • 1. @Qualifier끼리 매칭
  • 2. @Qualifier 못찾은 경우, 해당 @Qualifier 이름의 빈 매칭
  • 3. NoSuchBeanDefinitionException 예외 발생

---

• @Primary 사용

• @Primary 는 우선순위를 정하는 방법이다. @Autowired 시에 여러 빈이 매칭되면 @Primary 선언된 객체가 우선권을 가진다.

@Component
@Primary
public class RateDiscountPolicy implements DiscountPolicy {}

@Component
public class FixDiscountPolicy implements DiscountPolicy {}

//생성자 주입
@Autowired
public OrderServiceImpl(MemberRepository memberRepository, DiscountPolicy discountPolicy) {
 this.memberRepository = memberRepository;
 this.discountPolicy = discountPolicy;
}

• @Qualifier 의 단점은 주입 받을 때 모든 코드에 @Qualifier 를 붙여주어야 한다.

• 반면에 @Primary 를 사용하면 @Qualifier 를 붙일 필요가 없다.

---

[참고자료]

스프링 핵심 원리 - 기본편, 김영한