Pyohwan
commented
4 years ago 1. SpringApplication
SpringApplication는 main 메소드에서 스프링 애플리케이션을 부트스트랩하는 편리한 기능 제공public static void main(String[] args) { SpringApplication.run(MySpringConfiguration.class, args); }- 샘플 output
. ____ _ __ _ _ /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \ ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \ \\/ ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_\__, | / / / / =========|_|==============|___/=/_/_/_/ :: Spring Boot :: v2.2.2.RELEASE
2019-04-31 13:09:54.117 INFO 56603 --- [ main] o.s.b.s.app.SampleApplication : Starting SampleApplication v0.1.0 on mycomputer with PID 56603 (/apps/myapp.jar started by pwebb) 2019-04-31 13:09:54.166 INFO 56603 --- [ main] ationConfigServletWebServerApplicationContext : Refreshing org.springframework.boot.web.servlet.context.AnnotationConfigServletWebServerApplicationContext@6e5a8246: startup date [Wed Jul 31 00:08:16 PDT 2013]; root of context hierarchy 2019-04-01 13:09:56.912 INFO 41370 --- [ main] .t.TomcatServletWebServerFactory : Server initialized with port: 8080 2019-04-01 13:09:57.501 INFO 41370 --- [ main] o.s.b.s.app.SampleApplication : Started SampleApplication in 2.992 seconds (JVM running for 3.658)
* 기본적으로 INFO 로깅 메시지
* `spring.main.log-startup-info` 로 startup 정보 로깅을 끌 수 있음
> SpringApplication 에서 `logStartupInfo(boolean)` 로도 설정 가능
## 1.1. Startup Failure
* FailureAnalyzers 에 등록된 오류 메시지와 해결을 위한 조치를 제공 함
* 8080 포트가 이미 사용중이라면?APPLICATION FAILED TO START
Description:
Embedded servlet container failed to start. Port 8080 was already in use.
Action:
Identify and stop the process that's listening on port 8080 or configure this application to listen on another port.
> Spring Boot 는 수많은 `FailureAnalyzer` 구현체가 있고, 직접 추가도 가능 함
* failure analyzers 가 처리 하지 못하는 exception 이 있을 수 있는데, DEBUG 로깅으로 바꿔서 상세하게 봐라
* `java -jar` 할때 DEBUG 로깅을 하고 싶다면$ java -jar myproject-0.0.1-SNAPSHOT.jar --debug
## 1.2. Lazy Initialization
* lazy initialization 를 활성화 하면, Bean 이 필요할때 생성된다. (애플리케이션 startup 이 아니라)
* 애플리케이션 시작 시간을 단축 시킬 수 있다
* HTTP 요청 수신전까지 웹 관련 Bean 이 초기화 되지 않는다
* 하지만 단점은, 만약 잘못된 Bean 이 있을 경우 startup 시 발견 되지 않는다
* 또한 startup 시에 충분한 메모리 공간을 알수가 없다spring.main.lazy-initialization=true
> 특정 Bean 만 Lazy 를 사용하지 않으려면 `@Lazy(false)` 를 붙혀라
## 1.3. Customizing the Banner
* classpath 에 `banner.txt` 파일을 추가하거나, `spring.banner.location` 로 file 위치 설정 가능
* 파일이 UTF-8 로 인코딩 되어 있다면, `spring.banner.charset` 로 설정 가능
* banner.gif, banner.jpg, or banner.png 등의 이미지 파일로 추가 가능
* `spring.banner.image.location` 로 파일 위치 설정 가능
* 이미지는 ASCII 로 표현 됨
* `banner.txt` 에서 사용할 수 있는 placeholders. [이 링크](https://docs.spring.io/spring-boot/docs/2.2.2.RELEASE/reference/html/spring-boot-features.html#boot-features-banner)의 표 참고
> 프로그래밍 적으로는 `SpringApplication.setBanner(…)` method 로 설정 가능
* `spring.main.banner-mode` 로 `System.out (console)` 로 찍을지, 로그로 찍을지 설정 가능 함
* 프린트된 배너는 `springBootBanner` Bean 으로 등록 됨
## 1.4. Customizing SpringApplication
* `SpringApplication` 기본값이 마음에 안들면, 로컬 인스턴스를 작성하고 사용자 정의 가능하다.
* 예를 들어 밴어를 끄려면public static void main(String[] args) { SpringApplication app = new SpringApplication(MySpringConfiguration.class); app.setBannerMode(Banner.Mode.OFF); app.run(args); }
> SpringApplication 로 전달되는 생성자 아규먼트는 Spring Beans 의 구성 소스임. 대부분은 @Configuration 클래스에 대한 참조이지만, XML 구성에 대한 참조일 수도 있다
* application.properties 로도 SpringApplication 구성할수 있는데, Externalized Configuration 장에서 봐라
## 1.5. Fluent Builder API
* ApplicationContext 를 여러개 계층적으로 만들어야 하거나, “fluent” API 를 선호하면 SpringApplicationBuilder 를 사용해라
* SpringApplicationBuilder를 사용하면 여러 메소드 호출을 체인할 수 있고, 계층(child) 구조 작성 가능하다new SpringApplicationBuilder() .sources(Parent.class) .child(Application.class) .bannerMode(Banner.Mode.OFF) .run(args);
> ApplicationContext 를 계층적으로 만들때에는 제약사항이 있다. 웹 컴포넌트는 child context 에 포함되어야 하고, 상하위의 컨텍스트 모두 동일한 환경이어야 한다.
## 1.6. Application Events and Listeners
* `ContextRefreshedEvent` 와 같은 일반적인 이벤트 외에도, 추가적인 이벤트를 보낸다
> 특정 이벤트는 실제로 `ApplicationContext` 가 생성되기 전에 트리거되개 때문에, `@Bean` 으로 등록할 수 없다. `SpringApplication.addListeners(…)` 메소드로 등록해라
> 리스너 자동 등록을 하고 싶다면 `META-INF/spring.factories` 파일에 리스너를 추가해라org.springframework.context.ApplicationListener=com.example.project.MyListener
* 애플리케이션 이벤트는 다움의 순서로 전송 된다
1. `ApplicationStartingEvent` 는 run 시작시 에 발송 (리스너 및 초기화 등록 제외하고)
1. `ApplicationEnvironmentPreparedEvent` 는 컨텍스트 생선전에 사용될때 `Environment` 전송
1. `ApplicationContextInitializedEvent` 는 `ApplicationContext` 가 준비되고, `ApplicationContextInitializers` 가 호출되고 Bean 이 생성전에 전송
1. `ApplicationPreparedEvent` 는 refresh 시작 전, bean 정의가 로드된 후 전송
1. `ApplicationStartedEvent` 는 컨텍스트가 refresh 되었고, command-line runners 호출 전에 전송
1. `ApplicationReadyEvent` 는 애플리케이션 및 command-line runners 가 호출 된 후 전송. 애플리케이션이 요청을 처리할 준비가 되었다는 의미
1. `An ApplicationFailedEven` 는 startup 시 exception 있을때 전송
* 이외에 ApplicationStartedEvent 와 ApplicationPreparedEvent 사이에 발생하는 이벤트
1. `ContextRefreshedEvent` 는 ApplicationContext 가 refresh 되고 나서 전송
1. `WebServerInitializedEvent` 는 웹서버가 준비된 후 전송
## 1.7. Web Environment
* SpringApplication 는 사용자를 대신하여 올바르게 ApplicationContext 를 만들려고 함
* Spring MVC 가 있다면 AnnotationConfigServletWebServerApplicationContext 적용
* Spring MVC 가 없고, Spring WebFlux 가 있다면 AnnotationConfigReactiveWebServerApplicationContext 적용
* 모두 그렇지 않다면 AnnotationConfigApplicationContext 적용
* setWebApplicationType(WebApplicationType) 로 설정 가능
> JUnit test 할때에는 `setWebApplicationType(WebApplicationType.NONE)` 로 써라
## 1.8. Accessing Application Arguments
* `SpringApplication.run(…)` 에서 아규먼트를 접근해야 하는 경우 `org.springframework.boot.ApplicationArguments` bean 을 삽입 가능import org.springframework.boot.; import org.springframework.beans.factory.annotation.; import org.springframework.stereotype.*;
@Component public class MyBean {
@Autowired
public MyBean(ApplicationArguments args) {
boolean debug = args.containsOption("debug");
List<String> files = args.getNonOptionArgs();
// if run with "--debug logfile.txt" debug=true, files=["logfile.txt"]
}}
## 1.9. Using the ApplicationRunner or CommandLineRunner
* SpringApplication 가 시작되고 나서, 특정 코드를 한번 실행해야 한다면, ApplicationRunner or CommandLineRunner 인터페이스를 구현해라import org.springframework.boot.; import org.springframework.stereotype.;
@Component public class MyBean implements CommandLineRunner {
public void run(String... args) {
// Do something...
}}
* 순서대로 호출해야 하면 `org.springframework.core.Ordered` interface or `org.springframework.core.annotation.Order` 애너테이션을 써라
## 1.10. Application Exit
* 각 SpringApplication 종료시, ApplicationContext 가 close 되도록 JVM에 종료 후크를 등록 한다.
* DisposableBean 인터페이스 or `@PreDestroy` 를 사용 하라
* 또한 Bean 이 SpringApplication.exit() 가 호출되고, 특정 종료 코드를 응답하고자 한다면 org.springframework.boot.ExitCodeGenerator 인터페이스를 구현하라@SpringBootApplication public class ExitCodeApplication {
@Bean
public ExitCodeGenerator exitCodeGenerator() {
return () -> 42;
}
public static void main(String[] args) {
System.exit(SpringApplication.exit(SpringApplication.run(ExitCodeApplication.class, args)));
}}
## 1.11. Admin Features
* spring.application.admin.enabled 로 관리자 기능 사용 가능
* 플랫폼 MBeanServer 에 SpringApplicationAdminMXBean 를 노출 시킨다
* 이를 통해 Spring Boot application 을 원격으로 관리할 수 있다
12. Caching
@EnableCaching하면 자동 구성 해줌@Component public class MathService {
}
@Bean public CacheManagerCustomizer cacheManagerCustomizer() {
return new CacheManagerCustomizer() {
@Override
public void customize(ConcurrentMapCacheManager cacheManager) {
cacheManager.setAllowNullValues(false);
}
};
}
Only necessary if more than one provider is present
spring.cache.jcache.provider=com.acme.MyCachingProvider spring.cache.jcache.config=classpath:acme.xml
spring.cache.ehcache.config=classpath:config/another-config.xml
spring.cache.infinispan.config=infinispan.xml
spring.cache.cache-names=cache1,cache2
@Configuration(proxyBeanMethods = false) public class CouchbaseCacheConfiguration {
}
spring.cache.cache-names=cache1,cache2 spring.cache.redis.time-to-live=600000
spring.cache.cache-names=cache1,cache2 spring.cache.caffeine.spec=maximumSize=500,expireAfterAccess=600s
spring.cache.cache-names=cache1,cache2
spring.cache.type=none