Spring Boot

스프링 부트는 필요한 환경 설정을 최소화하고 개발자가 비즈니스 로직에 집중할 수 있도록 도와줘 생산생을 향상시켰다.

특징

  • 임베디드 톰캣, 제티, 언더토우를 사용해 독립 실행이 가능한 스프링 애플리케이션 개발

  • 통합 스타터를 제공하여 maven/gradle 구성 간소화

  • 스타터를 통한 자동화된 스프링 설정 제공

  • 번거로운 XML 설정 요구하지 않음

  • JAR을 사용해 자바 옵션만으로도 배포 가능

  • 애플리케이션의 모니터링과 관리를 위한 Spring Actuator 제공

  • Spring Boot Reference Guide를 참고해 스타터 내부의 의존성을 확인할 수 있다.

라이브러리

  • spring-boot-starter-web

    • spring-boot-starter-tomcat: 톰캣(웹서버)

    • spring-webmvc: 스프링 웹 MVC

  • spring-boot-starter-thymeleaf: 타임리프 템플릿 엔진(View)

  • spring-boot-starter: 스프링 부트 + 스프링 코어 + 로깅

    • spring-boot

      • spring-core

    • spring-boot-starter-logging

      • logback, slf4j

  • spring-boot-starter-test: 스프링부트 테스트

장단점

장점

  • 각각의 의존성 버전을 올리는 것이 조금 더 수월하다.

  • 특정 라이브러리에 버그가 있더라도 스프링팀의 버그 픽스한 버전을 받기 편리하다.

  • 간단한 어노테이션 설정이나 프로퍼티 설정으로 세부적인 설정 없이 원하는 기능을 빠르게 적용할 수 있다.

  • 별도의 외장 톰캣을 설치할 필요가 없다.

단점

  • 설정을 개인화하면 버전을 올릴 때 기존 스프링 프레임워크를 사용하는 것과 동일한 불편함을 겪을 수 있다.

  • 특정 설정을 개인화 혹은 설정 자체를 변경하고 싶다면, 내부의 설정 코드를 살펴봐야하는 불편함이 있다.

자동 환경 설정

스프링 부트 자동 환경설정은 Web, H2, JDBC를 비롯해 약 100여 개의 자동 설정을 제공한다. 그리고 새로 추가되는 라이브러리는 스프링 부트 자동-설정 의존성에 따라 설정이 자동 적용된다. 자동 설정은 @EnableAutoConfiguration (@Configuration과 반드시 같이 사용) 또는 @SpringBootApplication 중 하나를 사용하면 된다.

스프링 프레임워크에서는 의존성을 일일이 빈으로 설정했으나, 스프링 부트는 관련 의존성을 스타터라는 묶음으로 제공해 수동 설정을 지양한다.

@SpringBootApplication

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(
    excludeFilters = {@Filter(
    type = FilterType.CUSTOM,
    classes = {TypeExcludeFilter.class}
), @Filter(
    type = FilterType.CUSTOM,
    classes = {AutoConfigurationExcludeFilter.class}
)}
)
public @interface SpringBootApplication {
  ...
}

  • @SpringBootConfiguration : 스프링 부트의 설정을 나타내는 어노테이션

    • Spring의 @Configuration 대체

    • 스프링부트 전용

  • @EnableAutoConfiguration : 자동 설정의 핵심 어노테이션

    • 클래스 경로에 지정된 내용을 기반으로 자동 설정

    • 특별한 설정값을 추가하지 않으면 default값 설정

  • @ComponentScan : 특정 패키지 경로를 기반으로 @configuration에서 사용할 @Component 설정 클래스를 찾는다.

    • basePackages 프로퍼티 값에 별도로 값을 설정하지 않으면, @ComponentScan이 위치한 패키지가 루트 경로로 설정

@EnableAutoConfiguration

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@AutoConfigurationPackage
@Import({AutoConfigurationImportSelector.class})
public @interface EnableAutoConfiguration {
    String ENABLED_OVERRIDE_PROPERTY = "spring.boot.enableautoconfiguration";

    Class<?>[] exclude() default {};

    String[] excludeName() default {};
}

여기서 자동 설정을 지원해주는 어노테이션은 @Import({AutoConfigurationImportSelector.class})이다.

public class AutoConfigurationImportSelector implements DeferredImportSelector, BeanClassLoaderAware, ResourceLoaderAware, BeanFactoryAware, EnvironmentAware, Ordered {
    private static final AutoConfigurationImportSelector.AutoConfigurationEntry EMPTY_ENTRY = new AutoConfigurationImportSelector.AutoConfigurationEntry();
    private static final String[] NO_IMPORTS = new String[0];
    private static final Log logger = LogFactory.getLog(AutoConfigurationImportSelector.class);
    private static final String PROPERTY_NAME_AUTOCONFIGURE_EXCLUDE = "spring.autoconfigure.exclude";
    private ConfigurableListableBeanFactory beanFactory;
    private Environment environment;
    private ClassLoader beanClassLoader;
    private ResourceLoader resourceLoader;
    private AutoConfigurationImportSelector.ConfigurationClassFilter configurationClassFilter;

    public AutoConfigurationImportSelector() {
    }

    public String[] selectImports(AnnotationMetadata annotationMetadata) {
        if (!this.isEnabled(annotationMetadata)) {
            return NO_IMPORTS;
        } else {
            AutoConfigurationImportSelector.AutoConfigurationEntry autoConfigurationEntry = this.getAutoConfigurationEntry(annotationMetadata);
            return StringUtils.toStringArray(autoConfigurationEntry.getConfigurations());
        }
    }
  ...
}

AutoConfigurationImportSelector 내부의 selectImports()에는 자동 설정 방식에 대해 조금 더 상세히 살펴볼 수 있다.

    protected AutoConfigurationImportSelector.AutoConfigurationEntry getAutoConfigurationEntry(AnnotationMetadata annotationMetadata) {
        if (!this.isEnabled(annotationMetadata)) {
            return EMPTY_ENTRY;
        } else {
            AnnotationAttributes attributes = this.getAttributes(annotationMetadata);
            List<String> configurations = this.getCandidateConfigurations(annotationMetadata, attributes);
            configurations = this.removeDuplicates(configurations);
            Set<String> exclusions = this.getExclusions(annotationMetadata, attributes);
            this.checkExcludedClasses(configurations, exclusions);
            configurations.removeAll(exclusions);
            configurations = this.getConfigurationClassFilter().filter(configurations);
            this.fireAutoConfigurationImportEvents(configurations, exclusions);
            return new AutoConfigurationImportSelector.AutoConfigurationEntry(configurations, exclusions);
        }
    }

getAutoConfigurationEntry() 메서드를 보면 removeDuplicates() 종복된 설정과 getExclusions()으로 제외할 설정을 제외시켜주고 있다. 그리고 나서 이중에 프로젝트에서 사용하는 빈만 임포트할 자동 대상으로 선택하고 있다.

  • META-INF/spring.factories : 자동 설정 타깃 클래스 목록. 이곳에 선언되어 있는 클래스들이 @EnableAutoConfiguration 의 타겟

  • META-INF/spring-configuration-metadata.json : 자동 설정에 사용할 프로퍼티 정의 파일.

    • 미리 구현되어 있는 자동 설정에 프로퍼티만 주입 시키면 된다.(별도 환경설정 불필요)

  • org/springframework/boot/autoconfigure : 미리 구현해놓은 자동 설정 리스트

    • {특정설정이름}AutoConfiguration 형식으로 이름이 지정되어 있음

위 파일은 모두 spring-boot-autoconfiguration에 미리 정의되어 있고, 지정된 프로퍼티 값을 사용해 설정 클래스 내부 값을 바꿀 수 있다.

Spring Boot Reference Guide - Common Application properties에서 프로퍼티 값을 쉽게 확인할 수 있다.

자동 설정 어노테이션

자동 설정 조건 어노테이션

어노테이션
적용 조건

@ConditionalOnBean

해당하는 빈 클래스나 이름이 미리 빈 팩토리에 포함되어 있는 경우

@ConditionalOnClass

해당하는 클래스가 클래스 경로에 있는 경우

@ConditionalOnCloudPlatform

해당하는 클라우드 플랫폼이 활용 상태인 경우

@ConditionalOnExpression

SpEL에 의존하는 조건인 경우

@ConditionalOnJava

JVM 버전이 일치하는 경우

@ConditionalOnJndi

JNDI가 사용가능하고 특정 위치에 있는 경우

@ConditionalOnMissingBean

해당하는 빈 클래스나 이름이 미리 빈 팩토리에 포함되어 있지 않은 경우

@ConditionalOnMissingClass

해당하는 클래스가 클래스 경로에 없을 경우

@ConditionalOnNotWebApplication

웹 어플리케이션이 아닌경우

@ConditionalOnProperty

특정한 피로퍼티가 지정한 값을 갖는 경우

@ConditionalOnResource

특정 리소스가 클래스 경로에 있는 경우

@ConditionalOnSingleCandidate

지정한 빈 클래스가 이미 빈 팩토리에 포함되어 있고 단일 후보자로 지정 가능한 경우

@ConditionalOnWebApplication

웹 어플리케이션인 경우

자동 설정 순서 어노테이션

어노테이션
설명

@AutoConfigureAfter

지정한 특정 자동 설정 클래스들이 적용된 이후에 해당 자동 설정 적용

@AutoConfigureBefore

지정한 특정 자동 설정 클래스들이 적용된 이전에 해당 자동 설정 적용

@AutoConfigureOrder

자동 설정 순서 지정을 위한 스프링 프레임워크의 @Order 어노테이션 변형으로 기존 설정 클래스에는 영향을 주지 않고 자동 설정 클래스들 간의 순서만 지정한다.

예시

@Configuration
@ConditionalOnWebApplication(type = ConditionalOnWebApplication.Type.SERVLET) // 웹 어플리케이션일 떄
@ConditionalOnClass(WebServlet.class) // WebServlet.class가 경로에 있을때
@ConditionalOnProperty(prefix = "spring.h2.console" , name = "enabled", havingValue = "true", matchIfMissing = false) // spring.h2.console.enabled 값이 true일때
@EnableConfigurationProperties(H2ConsoleProperties.class)
public class H2ConsoleAutoConfiguration {
  ...
}
PreviousYAML 파일 설정NextH2 DB 설정

Last updated