Spring framework core 정리 - Kim-Taesu/study GitHub Wiki

• 생성자의 아규먼트
• 팩토리 메서드의 아규먼트
• 팩토리 메서드로부터 생성되거나 반환된 객체 인스턴스의 프로퍼티에 의해

• 기본적으로 Bean이 직접 클래스를 생성하거나 Service Locator 패턴으로 의존성을 주입하는데 IoC는 반대되는 개념이다.

• Spring AOP를 더 쉽게 사용할 수 있게 해준다.
• 메시지 Resource 처리 (국제화에 사용)
• Event 발행
• 웹 애플리케이션에서 사용하기 위한 WebApplicationContext와 같은 애플리케이션 계층을 제공

• 메타데이터는 XML, Java 어노테이션, Java 코드로 표시된다.
• 메타데이터로 애플리케이션을 구성하는 객체 간의 상호 의존성을 표현할 수 있다.

• XML 기반 설정은 요소 내부에 요소로 구성
• Java 구성은 @Configuration 클래스 내에서 @Bean 주석이 달린 메소드를 사용

• AspectJ 를 사용하여 IoC 컨테이너가 관리하지 않는 외부 객체를 구성할 수 있다.

• BeanDefinition은 아래 메타 데이터를 포함한다.
• 패키지 이름 : Bean의 실제 구현 클래스
• 동작 구성 요소 : Bean이 커넽이너에서 어떻게 동작해야하는지 (scope, lifecycle callback)
• 해당 Bean이 작업을 수행하는데 필요한 다른 Bean에 대한 참조
• 새로 생성된 객체에서 설정한 기타 구성 설정

• 컨테이너 내부에서 Bean의 식별자는 고유한 값이어야 한다.

• 두 개 이상의 문자가 있고 첫 번째와 두 번째 문자가 모두 대문자인 특수한 경우에는 원래 대소문자가 유지된다.

1. 컨테이너 자체가 생성자를 호출하여 빈을 직접 생상하는 경우

   • 자바의 new SomeClass()와 동일하다.

     <bean id="exampleBean" class="examples.ExampleBean"/>

2. 컨테이너가 클래스의 static 팩토리 메서드를 호출하여 빈을 만드는 경우

   • static 팩토리 메서드에서 실제 클래스를 지정한다.

     <bean id="clientService"
         class="examples.ClientService"
         factory-method="createInstance"/>

     public class ClientService {
         private static ClientService clientService = new ClientService();
         private ClientService() {}
     
         public static ClientService createInstance() {
             return clientService;
         }
     }

     public class DefaultServiceLocator {
     
         private static ClientService clientService = new ClientServiceImpl();
     
         private static AccountService accountService = new AccountServiceImpl();
     
         public ClientService createClientServiceInstance() {
             return clientService;
         }
     
         public AccountService createAccountServiceInstance() {
             return accountService;
         }
     }

• 특히 인터페이스나 추상 클래스에 의존성이 있는 경우, 단위 테스트에서 stub/mock 으로 구현하여 사용할 수 있다.

• 생성자 기반 의존성 주입
• setter 기반 의존성 주입

의존성을 나타내는 여러 아규먼트가 있는 생성자를 호출하는 컨테이너에 의해 수행된다.

Bean을 구성하기 위해 특정 아규먼트를 가진 static 팩토리 메서드를 호출하는 것과 거의 동일하다.

public class SimpleMovieLister {

    // the SimpleMovieLister has a dependency on a MovieFinder
    private final MovieFinder movieFinder;

    // a constructor so that the Spring container can inject a MovieFinder
    public SimpleMovieLister(MovieFinder movieFinder) {
        this.movieFinder = movieFinder;
    }

    // business logic that actually uses the injected MovieFinder is omitted...
}

@ConstructorProperties 를 사용하여 생성자 프로퍼티를 지정할 수 있다.

public class ExampleBean {

    // Fields omitted

    @ConstructorProperties({"years", "ultimateAnswer"})
    public ExampleBean(int years, String ultimateAnswer) {
        this.years = years;
        this.ultimateAnswer = ultimateAnswer;
    }
}

빈 생성자 또는 빈 static 팩토리 메서드를 호출 한 후, Bean의 컨테이너 호출 setter 메서드에 의해 수행된다.

public class SimpleMovieLister {

    // the SimpleMovieLister has a dependency on the MovieFinder
    private MovieFinder movieFinder;

    // a setter method so that the Spring container can inject a MovieFinder
    public void setMovieFinder(MovieFinder movieFinder) {
        this.movieFinder = movieFinder;
    }

    // business logic that actually uses the injected MovieFinder is omitted...
}

• 따라서 필수 의존성에는 생성자를 사용하고, 선택적 의존성에는 setter 메서드 또는 설정 메서드를 사용하는 것이 좋다.
• setter 메서드에 @Required를 사용하면 필수 의존성으로 만들수 있지만 유효성 검사가 포함된 생성자 기반 DI를 사용하는 것이 좋다.

• 구성 요소를 final로 사용할 수 있다.
• null 체크 가능
• 생성자 아규먼트가 너무 많다면 리팩토링 대상이다.

• setter 기반 주입의 이점의 해당 객체를 재구성하거나 다시 주입할 수 있다.

• InitializingBean::afterPropertiesSet 으로 Bean 초기화 시 액션을 걸 수 있다.

  <bean id="exampleInitBean" class="examples.ExampleBean" init-method="init"/>

  public class ExampleBean {
  
      public void init() {
          // do some initialization work
      }
  }

  <bean id="exampleInitBean" class="examples.AnotherExampleBean"/>

  public class AnotherExampleBean implements InitializingBean {
  
      @Override
      public void afterPropertiesSet() {
          // do some initialization work
      }
  }

• DisposableBean::destroy 으로 Bean 초기화 시 액션을 걸 수 있다.

  <bean id="exampleInitBean" class="examples.ExampleBean" destroy-method="cleanup"/>

  public class ExampleBean {
  
      public void cleanup() {
          // do some destruction work (like releasing pooled connections)
      }
  }

  <bean id="exampleInitBean" class="examples.AnotherExampleBean"/>

  public class AnotherExampleBean implements DisposableBean {
  
      @Override
      public void destroy() {
          // do some destruction work (like releasing pooled connections)
      }
  }

• 커스터마이징이 필요하면 BeanPostProcessor를 구현해서 사용하면 된다.

1. The InitializingBean and DisposableBean callback interfaces
2. Custom init() and destroy() methods
3. The @PostConstruct and @PreDestroy annotations.

• The @PostConstruct and @PreDestroy annotations.
• The InitializingBean and DisposableBean callback interfaces
• Custom init() and destroy() methods

ApplicationContext는 org.springframework.context.ApplicationContextAware 인터페이스를 구현한 객체 인스턴스를 생성하는데, 해당 인스턴스는 특정 ApplicationContext를 참조하는 메서드와 함께 제공된다.

public interface ApplicationContextAware {
    void setApplicationContext(ApplicationContext applicationContext) throws BeansException;
}

위 인터페이스의 setApplicationContext 메서드를 통해 ApplicationContext에 접근할 수 있다.

• ex) 다른 Bean 검색 용도

  public class ExampleClass implements ApplicationContextAware{
  
      private SomeClass someClass;
  
      @Override
      public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
          // logic ...
          this.someClass = applicationContext.getBeansOfType(SomeClass.class)
      }    
  }

@Autowired 어노테이션을 사용해서 ApplicationContext에 대한 참조를 얻을 수 있다.

• 필드, 생성자 또는 메서드에 @Autowired 어노테이션이 있는 경우 ApplicationContext가 자동으로 제공된다.

ApplicationContext는 org.springframework.beans.factory.BeanNameAware 인터페이스를 구현한 클래스를 생성하는데, 해당 클래스는 특정 name을 가지는 Bean을 참조하는 메서드와 함께 제공된다

public interface BeanNameAware {

    void setBeanName(String name) throws BeansException;
}

• ApplicationContext는 자동으로 BeanPostProcessor 인터페이스 구현한 클래스를 감지한다.

• order 프로퍼티는 BeanPostProcessor가 Ordered 인퍼페이스를 구현해야 한다.

• Spring IoC 컨테이너가 Bean 인스턴스를 만들고 이후에 BeanPostProcessor 인스턴스가 작업을 수행한다.

• postProcessBeforeInitialization : Bean 초기화 전에 실행

• postProcessAfterInitialization : Bean 초기화 전에 실행

  public class InstantiationTracingBeanPostProcessor implements BeanPostProcessor {
  
      // simply return the instantiated bean as-is
      public Object postProcessBeforeInitialization(Object bean, String beanName) {
          return bean; // we could potentially return any object reference here...
      }
  
      public Object postProcessAfterInitialization(Object bean, String beanName) {
          System.out.println("Bean '" + beanName + "' created : " + bean.toString());
          return bean;
      }
  }

• HierarchicalMessageSource 인터페이스도 제공하여 계층적인 메시지를 제공할 수 있다.

• MessageSource로부터 메시지를 가져오는 기본적인 메서드이다.
• 특정 Locale의 메시지가 없는 경우 default 메시지가 사용된다.

• 위 메소드와 동일한 기능이나 출력할 메시지가 없는 경우 NoSuchMessageException 예외를 발생시킨다.

• 반드시 bean 이름은 messageSource로 해야 한다.

• ResourceBundleMessageSource
• ReloadableResourceBundleMessageSource
• StaticMessageSource : 거의 사용되지 않음

• format.properties, exceptions.properties, windows.properties 파일이 classpath 경로에 있어야 한다.

• classpath 또는 servletContext에서 상대경로로 resource를 가져와야 하는 경우 접근하기 위한 표준화된 URL 구현체가 없다.

• java.net.URL를 래핑하여 URL resource에 접근할 수 있다.
  • files
  • https target
  • ftp target
  • ...
• URL은 일반적으로 String 타입으로 표시하며 resource에 따라 prefix를 설정한다.
  • file: : filesystem path인 경우
  • https: : HTTPS protocol을 통해 resource에 접근하는 경우
  • ftp: : FTP를 통해 resource에 접근하는 경우

• classpath에 위치하는 resource에 대해 접근한다.
• java.io.File로 classpath의 resource에 접근할 수 있다.
• classpath 경로에 없을 경우를 대비해 java.net.URL도 지원한다.

• java.nio.file.Path, java.nio.file.Files를 지원하여 filesystem의 resource에 접근할 수 있다.

• 웹 애플리케이션 Root dir의 resource에 접근할 수 있다.
• java.io.File을 지원하여 filesystem의 resource에 접근할 수 있다.

• Spring Validation은 모든 계층에서 사용 가능한 Validator를 지원한다.

• 이 때 검증 실패 시 Errors 객체에 실패 결과를 기입한다.

• reject, rejectXXX 메소드에서 설정한 에러 코드와 함께 에러 메시지를 등록
• rejectValue("age", "too.darn.old")
  • 코드 값 : too.darn.old
  • Spring은 추가로 too.darn.old.age와 too.darn.old.age.int를 등록한다.

• EX) 트랜잭션 관리, 로깅
• Spring AOP에서는 @Aspect 주석을 사용하거나 스키마 선언을 사용하여 구현한다.

• Spring AOP에서 Join Point는 항상 메소드 실행을 나타낸다.

• around, before, after와 같은 다양한 유형의 advice가 있다.
• Spring을 포함한 많은 AOP 프레임워크는 advice를 인터셉터로 모델링하고 Join Point 주변에 intercepter 체인을 유지한다.

• Advice는 Pointcut 표현식과 연관되며 Pointcut에 일치하는 모든 Join Point에서 실행된다.
  • EX) 특정 이름의 메소드 실행
• Pointcut 표현식과 일치하는 Join point 구조는 AOP의 핵심 개념이다.
• Spring은 기본적으로 AspectJ pointcut 표현식을 사용한다.

• Spring AOP는 런타임 프록시를 사용해서 구현하기 때문에 항상 프록시 객체이다.

• Spring Framework에서 AOP 프록시는 JDK 동적 프록시 또는 CGLIB 프록시이다.
  • JDK Dynamic Proxy : Java의 리플렉션 패키지에 존재하는 Proxy라는 클래스를 통해 생성된 Proxy 객체
  • target object가 하나 이상의 인터페이스를 구현하고 있는 클래스라면 JDK DYnamic Proxy 방식으로 생성
  • target object가 인터페이스를 구현하지 않은 클래스라면 CGLIB 방식으로 AOP 프록시를 생성
• 추가 설명 링크

• 예외를 던지면 막을 수 있다.

• 메서드가 예외 없이 반환되어야 한다.

• 정상 종료 / 예외 발생 모두 포함

• 메서드 호출 전후에 사용자 코드를 실행할 수 있다.
• 예외를 throw 하여 join point의 실행을 막을 수 있습니다.

• Spring AOP로 작업할 때 사용하는 기본 포인트컷 지정자