스프링에서 의존성을 주입받는 방법

의존관계 자동 주입은 스프링 컨테이너가 관리하는 스프링 빈이어야 동작한다. 스프링 빈이 아닌 다른 클래스에서 @Autowired를 해도 아무 동작을 하지 않는다.

생성자 주입을 권장하는 이유

의존관계는 한 번 주입이 되면 불변해야 한다. 수정자 주입은 setter 메서드를 public으로 열어야 하기 때문에 변경이 일어날 수 있다. 변경하면 안되는 메서드를 public으로 열어두는 것은 좋은 방법이 아니다. 생성자 주입은 객체 생성 시 한 번만 호출되므로 불변하게 설계할 수 있다.

주입 데이터를 누락했을 때 컴파일 오류가 발생되고, 필드에 final 키워드를 사용할 수 있는데 생성자에서 값이 설정되지 않았을 때 컴파일 오류를 통해 캐치할 수 있다.
*수정자 주입을 포함한 나머지 주입 방식은 모두 생성자 이후에 호출되므로, 필드에 final 키워드를 사용할 수 없다. (오직 생성자 주입 방식만 final 키워드를 사용할 수 있다.)

@Autowired 옵션 처리

public class AutoWiredTest {

    @Test
    void AutowiredOption() {
        ApplicationContext ac = new AnnotationConfigApplicationContext(TestBean.class);
    }

    static class TestBean {

        // 자동 주입할 외존관계가 없으면 메서드가 호출되지 않는다.
        @Autowired(required = false)
        public void setNoBean1(Member noBean1) {
            System.out.println("noBean1 = " + noBean1);
        }

        // 자동 주입할 대상이 없으면 null을 반환한다.
        @Autowired
        public void setNoBean2(@Nullable Member noBean2) {
            System.out.println("noBean2 = " + noBean2);
        }

        // 스프링 빈이 없으면 Optional.empty를 반환한다.
        @Autowired
        public void setNoBean3(Optional<Member> noBean3) {
            System.out.println("noBean3 = " + noBean3);
        }
    }
}

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

Caused by: org.springframework.beans.factory.NoUniqueBeanDefinitionException: No qualifying bean of type 'hello.core.discount.DiscountPolicy' available: expected single matching bean but found 2: fixDiscountPolicy,rateDiscountPolicy

다음과 같이 DiscountPolicy 타입에 대한 의존 관계를 주입할 때 DiscountPolicy의 하위 타입 2개를 모두 스프링 빈으로 선언하면 싱글톤이 깨져서 오류가 발생하게 된다. 다음과 같이 3가지 방법으로 해결할 수 있다.

• @Autowired 필드명 매칭
  타입 매칭을 시도하고 타입 매칭 결과가 2개 이상인 경우 필드명 또는 파라미터명으로 빈 이름을 매칭한다.

    @Autowired
    public OrderServiceImpl(MemberRepository memberRepository, DiscountPolicy rateDiscountPolicy) {
        this.memberRepository = memberRepository;
        this.discountPolicy = rateDiscountPolicy;
    }

• @Qualifier끼리 매칭
  추가 구분자를 붙여서 주입 시 추가적인 방법을 제공하는 것으로 빈 이름을 변경하는 것은 아니다.
  주입 시에 @Qualifier를 붙여주고 등록한 이름을 적어준다. @Qualifier끼리 매칭한다.

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

    private int discountPercent = 10;

    @Override
    public int discount(Member member, int price) {
        if(member.getGrade() == Grade.VIP) return price * discountPercent / 100;
        else return 0;
    }
}

// 생성자 자동 주입
// 만약 @Qualifier("mainDiscountPolicy")를 찾지 못하면, mainDiscountPolicy라는 이름의 스프링 빈을 추가로 찾는다. 그래도 못 찾으면 NoSuchBeanDefinitionException 예외가 발생한다.
@Autowired
public OrderServiceImpl(MemberRepository memberRepository, @Qualifier("mainDiscountPolicy") DiscountPolicy discountPolicy) {
     this.memberRepository = memberRepository;
     this.discountPolicy = discountPolicy;
}

@Qualifier 방법의 단점은 다음과 같이 문자를 적으면 컴파일 시 타입 체크가 되지 않는다. 이것을 해결하기 위해 어노테이션을 만들어서 스프링 빈에 등록할 하위 타입 클래스에 선언한다.

@Target({ElementType.FIELD, ElementType.METHOD, ElementType.PARAMETER, ElementType.TYPE, ElementType.ANNOTATION_TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
@Qualifier("mainDiscountPolicy")
public @interface MainDiscountPolicy {
}

@Component
@MainDiscountPolicy
public class RateDiscountPolicy implements DiscountPolicy {
}

• @Primary 사용
  우선순위를 정하는 방법으로 @Autowired 시 여러 빈에 매칭되면 @Primary가 우선권을 갖는다.

@Primary
public class RateDiscountPolicy implements DiscountPolicy {}

스프링은 자동보다는 수동이, 넓은 범위의 선택권 보다는 좁은 범위의 선택권이 우선 순위가 높다. 따라서, @Primary 보다 @Qualifier가 우선권이 더 높다.