[Spring] ComponentScan

김대준·2022년 1월 15일

spring

목록 보기

19/25

@ComponentScan

📌 1. @ComponentScan

@ComponentScan이란, @Component 및 Stereo Type(@Service, @Repository, @Controller)이 부여된 클래스들을 자동으로 스캔하여 빈으로 등록해주는 역할을 한다.

빈으로 등록 될 준비를 마친 클래스들을 스캔하여, 빈으로 등록해주는 것이다.
빈으로 등록 될 준비란, 클래스에 @Component 및 Stereo Type(@Service, @Repository, @Controller)을 붙여서 빈으로 등록 될 준비를 한 것이다.

이전 xml파일에 <context:component-scan base-package="패키지경로"/>를 이용해 지정해주었던 것을 java파일을 이용하여 빈을 스캔하기 위해 생겨났다.
어떤 애노테이션을 스캔할지 또는 하지 않을지 결정하는 Filter 기능을 가지고 있다.

@ComponentScan에서 중요한 설정으로는 BasePackages와 BasePackageClasses 가 있다.
BasePackages는 String으로 입력된 패캐지의 경로를 스캔하는 방법이다.
BasePackageClasses는 전달된 클래스의 위치를 기준으로 스캔하는 방법이다.

BasePackageClasses 사용을 더 추천한다.

StringBoot를 사용한다면 우리가 따로 설정하지 않는 이상 @ComponentScan을 보기 힘들다.
그 이유는 @SpringBootApplication이 @ComponentScan이랑 @Configuration을 들고 있기 때문이다.

📌 2. @ComponentScan의 스캔 기본 대상

@Component : 컴포넌트 스캔에서 사용
@Controller : 스프링 MVC 컨트롤러에서 사용
@Service : 스프링 비즈니스 로직에서 사용
@Repository : 스프링 데이터 접근 계층에서 사용
@Configuration : 스프링 설정 정보에서 사용

📌 3. @ComponentScan 동작 과정

① @Configuration 파싱
ConfigurationClassParser가 @Configuration 클래스를 파싱한다.

② @ComponentScan 설정 파싱
개발자는 basePackage, basePackesClasses, excludeFilters, includeFilters, lazyInit, nameGenerator, resourcePattern, scopeProxy 등 컴포넌트들을 스캔하기 위한 설정을 정의한다. ComponentScanAnnotationParse가 컴포넌트 후보를 모두 찾고, 스캔하기 위해 설정을 파싱한다.

③ 클래스 로딩
base-package 설정을 바탕으로 모든 클래스를 로딩한다. (*.class)
클래스로더를 이용하여 모든 자원을 Resource 인터페이스 형태로 불러온다.

④ 빈 정의 설정
ClassLoader가 로딩한 클래스를 BeanDefinition으로 정의한다.
그리고 beanName의 key값으로 BeanDefinitionRegistry에 등록해놓는다.
생성할 빈에 대한 정의(메타 데이터)다.

⑤ 빈 생성 & 주입.
설정한 빈 정의를 바탕으로 객체를 생성하고, 주입한다.

💡 정리
Configuration 클래스 및 애노테이션에 사용하는 설정들을 파싱한다.
basePackage의 하위 클래스들을 불러와서 Component 후보인지 확인 후 BeanDefinition(빈 생성을 위한 정의) 을 만든다.
생성된 빈 정의를 바탕으로 빈을 생성하고 의존성있는 빈들을 주입한다.

📌 4. @CompoenentScan 사용방법

@CompoenentScan 사용 방법은 xml파일에 설정하는 방법과 자바파일안에서 설정하는 방법이 있다.

✔ 4-1 xml 파일에 설정

<context:component-scan base-package="com.rcod.lifelog"/>

xml 파일에 설정하고, base-package을 적어주면 base-package 기준으로 클래스들을 스캔하여 빈으로 등록한다. base-package에 여러개의 패키지를 쓸 수 있다.

<context:component-scan base-package="com.rcod.lifelog, com.rcod.example"/>

위와 같이 설정하면, base package하위의 @Controll, @Service, @Repository, @Component 클래스가 모두 빈으로 등록되므로, 특정한 객체만 빈으로 등록하여 사용하고 싶다면 include-filter 또는 exclude-filter를 통해 설정할 수 있다.

🔍 include-filter

<context:component-scan base-package="com.rcod.lifelog" use-default="false">
    <context:include-filter type="annotation" 
        expression="org.springframework.stereotype.Controller"/>
</context:component-scan>

use-default="false"는 기본 애노테이션 @Controller, @Component등을 스캔하지 않는 다는 것이다.
기본 애노테이션을 스캔하지 않는다고 설정하고, include-filter을 통해서 특정 애노테이션만 스캔할 수 있다.

🔍 exclude-filter

<context:component-scan base-package="com.rcod.lifelog">
    <context:exclude-filter type="annotation" 
        expression="org.springframework.stereotype.Controller"/>
</context:component-scan>

@Controller를 제외하고 싶다면 exclude-filter를 사용하여 org.springframework.stereotype.Controller 를 명시한다.

✔ 4-2 java파일에 설정

💡 동작 순서
① @Comfiguration, @ConponentScan 지정
② 각 클래스가 컴포넌트 스캔의 대상이 되도록 @Component 지정
③ @Component로 지정된 클래스에서 생성자 메서드에 @Autowired을 지정하여 의존관계 주입

①@Comfiguration, @ConponentScan 지정

package hello.core;

import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;

@Configuration
@ComponentScan
public class AutoAppConfig {}

@Configuration을 이용하여 빈 설정파일(XML 파일을 대체하는)임을 알려준다.
@ComponentScan 을 이용해 빈으로 등록되기 위한 애노테이션이 부여된 클래스들을 자동으로 IoC컨테이너에 등록하도록 한다.
@ComponentScan을 사용하면 @Configuration이 붙은 설정 정보도 자동으로 스프링 IoC 컨테이너의 빈으로 등록된다.
@Configuration의 소스코드에 @Conponent가 포함되어 있기 때문이다.

② 각 클래스가 컴포넌트 스캔의 대상이 되도록 @Component 지정

package hello.core.member;

import org.springframework.stereotype.Component;

import java.util.HashMap;
import java.util.Map;

@Component
public class MemoryMemberRepository implements  MemberRepository{

    private  static Map<Long, Member> store = new HashMap<>();

    @Override
    public void save(Member member) {
        store.put(member.getId(), member);
    }

    @Override
    public Member findById(Long memberId) {
        return store.get(memberId);
    }
}

컴포넌트 스캔

@ComponentScan은 @Component가 붙은 모든 클래스를 스프링 빈으로 등록한다.
이 때 스프링 빈의 기본 이름은 클래스 명을 사용하되 맨 앞글자만 소문자를 사용한다.
빈 이름을 직접 지정하고 싶을 때는 @Component("원하는이름") 으로 작성한다.

③ @Component로 지정된 클래스에서 생성자 메서드에 @Autowired을 지정하여 의존관계 주입

package hello.core.member;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

@Component
public class MemberServiceImpl implements  MemberService{

    private final MemberRepository memberRepository;

    @Autowired 
    public MemberServiceImpl(MemberRepository memberRepository) {
        this.memberRepository = memberRepository;
    }

    @Override
    public void join(Member member) {
        memberRepository.save(member);
    }

    @Override
    public Member findMember(Long memberId) {
        return memberRepository.findById(memberId);
    }
}

의존관계 자동 주입

생성자에 @Autowired를 지정하면, 스프링 컨테이너가 자동으로 해당 스프링 빈을 찾아서 주입한다.
이 때 기본 조회 전략은 타입이 같은 빈을 찾아서 주입한다.
getBean(MemberRepository.class)와 동일하다.

의존관계 자동 주입 2

생성자에 파라미터가 많아도 다 찾아서 자동으로 주입한다.

🔍 @ComponentScan 범위

basePackages

@Configuration
@ComponentScan(basePackages = "com.kureungkureung.spring")
public class ApplicationConfig {}

basePackages의 경우 괄호안에 직접 패키지 경로를 적어주어 스캔할 위치를 정한다.

basePackages = {"hello.core", "hello.service"} 처럼 여러 시작 위치를 지정할 수도 있다.

basePackages는 Typesafe하지 않았기 떄문에 조금만 철자가 잘못되더라도 스캔을 못하는 오류가 나타날 수 있다.

basePackagesClasses

@Configuration
@ComponentScan(basePackageClasses = Application.class)
public class ApplicationConfig {}

basePackageClasses의 경우에는 괄호안에 적힌 클래스가 위치한 곳에서부터 모든 애노테이션이 부여된 클래스를 빈으로 등록한다.
basePackageClasses를 지정하지 않으면 @ComponentScan이 붙은 설정 정보 클래스의 패키지가 시작 위치가 된다.
basePackagesClasses는 클래스를 통해 기입하기 때문에 훨씬 Typesafe한 방법이다.

🧷 권장 방법
패키지 위치를 지정하지 않고, 설정 정보 클래스의 위치를 프로젝트 최상단에 두는 것이다.
최근 스프링 부트도 이 방법을 기본으로 제공한다.

ex) 프로젝트 구조
com.hello
com.hello.service
com.hello.repository
이렇게 있다고 가정할 때,

com.hello 에 프로젝트 시작 루트인 AppConfig같은 메인 설정 정보를 두고 @ComponentScan 을 붙이고 basePackages 지정을 생략한다.

참고로 스프링 부트를 사용하면 스프링 부트의 대표 시작 정보인 @SpringBootApplication을 프로젝트 시작 루트 위치에 둬야한다.

🔍 필터

includeFilters
컴포넌트 스캔 대상을 추가로 지정한다.
@Component 를 써도 충분하기 때문에 includeFilters를 사용할 일은 거의 없다.

package hello.core.scan.filter;

import java.lang.annotation.*;

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented

public @interface MyIncludeComponent { }

package hello.core.scan.filter;

@MyIncludeComponent
public class BeanA { }

👀 @Target
애노테이션이 적용할 위치를 선택한다.
애노테이션이 생성될 수 있는 위치를 지정한다.

ElementType.PACKAGE : 패키지 선언
ElementType.TYPE : 타입 선언
ElementType.ANNOTATION_TYPE : 애노테이션 타입 선언
ElementType.CONSTRUCTOR : 생성자 선언
ElementType.FIELD : 멤버 변수 선언
ElementType.LOCAL_VARIABLE : 지역 변수 선언
ElementType.METHOD : 메서드 선언
ElementType.PARAMETER : 메소드의 파라미터로 선언된 객체에서만 사용 가능
ElementType.TYPE_PARAMETER : 전달인자 타입 선언
ElementType.TYPE_USE : 타입 선언

👀 @Retention
해당 애노테이션이 언제까지 유지할지 알려주는 애노테이션이다.
자기 자신이 어느 시점까지 유효한지를 명시해줘야한다.

RetentionPolicy.SOURCE : 컴파일 전까지만 유효. (컴파일 이후에는 사라짐)
RetentionPolicy.CLASS : 컴파일러가 클래스를 참조할 때까지 유효.
RetentionPolicy.RUNTIME : 컴파일 이후에도 JVM에 의해 계속 참조가 가능. (리플렉션 사용)

👀 @Documented
메타 데이터 애노테이션이다.
문서에 애노테이션의 정보가 표현된다.
애노테이션을 정의할 때, @Documented형태로 적용하여, 해당 애노테이션을 사용하는 클래스가 javadoc과 같은 문서화 될 때, 해당 애노테이션이 적용 되었음을 명시하도록 한다.

excludeFilters
컴포넌트 스캔에서 제외할 대상을 지정한다.
excludeFilters는 여러가지 이유로 간혹 사용할 때가 있지만 많지는 않다.

package hello.core.scan.filter;

import java.lang.annotation.*;

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented

public @interface MyExcludeComponent { }

package hello.core.scan.filter;

@MyExcludeComponent
public class BeanB { }

스프링 부트는 컴포넌트 스캔을 기본으로 제공한다. 옵션을 변경하면서 사용하기 보다는 스프링의 기본 설정에 최대한 맞추어 사용하는것이 좋다.

@ComponentScan(
 includeFilters = @Filter(type = FilterType.ANNOTATION, classes =

MyIncludeComponent.class),
 excludeFilters = @Filter(type = FilterType.ANNOTATION, classes =

MyExcludeComponent.class)
)