Spring Applications

SpringApplication: 提供一種便攜的方式來啟動Spring應(yīng)用(main函數(shù))。 可以使用靜態(tài)方法調(diào)用 SpringApplication.run

啟動

啟動日志

0. Spring啟動日志默認為info級別，可以關(guān)閉 spring.main.log-startup-info=false
1. FailureAnalyzers 處理啟動時拋出的異常，可以自己實現(xiàn)
2. 若仍無analyzer處理異常，則可以使用DEBUG級別的日志，或者啟動時增加debug屬性:
3. JAVA -jar *.jar --debug

延遲加載

0. 延遲加載默認關(guān)閉，開啟有可能導(dǎo)致錯誤延后發(fā)現(xiàn)
1. 延遲加載開關(guān)配置: spring.main.lazy-initialzation=true
2. 延遲開關(guān)代碼: SpringApplicationBuilder lazyInitialization; SpringApplication setLazyInitialization
3. 延遲開關(guān)注解: @Lazy(false)

banner

0. 類: SpringBootBanner
1. 配置文件 banner.txt
2. 支持將系統(tǒng)的一些變量輸出
3. 代碼設(shè)置: SpringApplication.setBanner()
4. 開關(guān)配置 console/log/off: spring.main.banner-mode=off
5. 地址配置:spring.banner.location

自定義Spring Application

0. 支持自定義SpringApplication
1. @SpringBootApplication
   public class MyApplication { public static void main(String[] args) { SpringApplication application = new SpringApplication(MyApplication.class); application.setBannerMode(Banner.Mode.OFF); application.run(args); }}

Builder API

0. Springboot應(yīng)用構(gòu)建
1. new SpringApplicationBuilder()
   .sources(Parent.class) .child(Application.class) .bannerMode(Banner.Mode.OFF) .run(args);

應(yīng)用可用性監(jiān)控

0. Spring boot actuator
1. ApplicationAvailability 實現(xiàn)該接口來向外暴露狀態(tài)

Liveness State

應(yīng)用是否存活，與外部狀態(tài)無關(guān)

Readiness State

應(yīng)用是否可用(例如CommandLineRunner ApplicationRunner在被執(zhí)行時)

狀態(tài)管理

• 監(jiān)聽狀態(tài)改變
• @Component
  public class MyReadinessStateExporter { @EventListener public void onStateChange(AvailabilityChangeEvent<ReadinessState> event) { switch (event.getState()) { case ACCEPTING_TRAFFIC: // create file /tmp/healthy break; case REFUSING_TRAFFIC: // remove file /tmp/healthy break; } }}
• 改變狀態(tài)
• @Component
  public class MyLocalCacheVerifier { private final ApplicationEventPublisher eventPublisher; public MyLocalCacheVerifier(ApplicationEventPublisher eventPublisher) { this.eventPublisher = eventPublisher; } public void checkLocalCache() { try { // ... } catch (CacheCompletelyBrokenException ex) { AvailabilityChangeEvent.publish(this.eventPublisher, ex, LivenessState.BROKEN); } }}

應(yīng)用事件監(jiān)聽

除了通常的Spring事件, 比如ContextRefreshedEvent, SpringApplication還可以發(fā)送其他事件

有些事件在ApplicationContext創(chuàng)建之前觸發(fā)，這種無法通過注冊bean來注冊監(jiān)聽器，可以通過其他方式監(jiān)聽:
SpringApplication.addListeners()/ SpringApplication.listeners()

支持自動化配置listeners. META_INF/spring.factories

org.springframework.context.ApplicationListener=com.example.MyListener

應(yīng)用實踐發(fā)送順序:

0. An ApplicationStartingEvent is sent at the start of a run but before any processing, except for the registration of listeners and initializers.
1. An ApplicationEnvironmentPreparedEvent is sent when the Environment to be used in the context is known but before the context is created.
2. An ApplicationContextInitializedEvent is sent when the ApplicationContext is prepared and ApplicationContextInitializers have been called but before any bean definitions are loaded.
3. An ApplicationPreparedEvent is sent just before the refresh is started but after bean definitions have been loaded.
4. An ApplicationStartedEvent is sent after the context has been refreshed but before any application and command-line runners have been called.
5. An AvailabilityChangeEvent is sent right after with LivenessState.CORRECT to indicate that the application is considered as live.
6. An ApplicationReadyEvent is sent after any application and command-line runners have been called.
7. An AvailabilityChangeEvent is sent right after with ReadinessState.ACCEPTING_TRAFFIC to indicate that the application is ready to service requests.
8. An ApplicationFailedEvent is sent if there is an exception on startup.

當(dāng)ApplicationContext 被刷新后會觸發(fā)ContextRefreshedEvent

實現(xiàn)ApplicationContextAware 可注入ApplicationContext

獲取啟動參數(shù)

ApplicationArguments

@Component
public class MyBean {

  public MyBean(ApplicationArguments args) {
      boolean debug = args.containsOption("debug");
      List<String> files = args.getNonOptionArgs();
      if (debug) {
          System.out.println(files);
      }
      // if run with "--debug logfile.txt" prints ["logfile.txt"]
  }

}

ApplicationRunner CommandLineRunner

在SpringApplication啟動之后, 需要運行相關(guān)代碼時, 可以用ApplicationRunner或CommandLineRunner。 接口均實現(xiàn)run方法。 區(qū)別是ApplicationRunner使用ApplicationArguments, CommandLineRunner使用字符串?dāng)?shù)組接收請求參數(shù)。

若有多個bean被定義并要求有順序執(zhí)行，可以實現(xiàn)
org.springframework.core.Ordered接口或使用org.springframework.core.annotation.Order

應(yīng)用關(guān)閉

每個Spring應(yīng)用會向JVM注冊一個鉤子確保ApplicationContext可以順利關(guān)閉 每個標(biāo)準(zhǔn)Spring生命周期的方法會被調(diào)用(例如DisposableBean 或@PreDestroy)

可以指定錯誤碼
org.springframework.boot.ExitCodeGenerator(自定義異常錯誤碼)

SpringApplicaiton.exit()

管理特性

啟動管理功能，支持遠程管理，暴露
SpringApplicationAdminMXBean MBeanServer

spring.application.admin.enabled=true

外部配置

包含Java properties files, yaml files, environment variables, command-line arguments

可通過@Value獲取 或者 結(jié)構(gòu)化對象(通過@ConfigurationProperties)

@value(${name:123})

配置優(yōu)先級

0. Default properties (specified by setting SpringApplication.setDefaultProperties).
1. @PropertySource annotations on your @Configuration classes. Please note that such property sources are not added to the Environment until the application context is being refreshed. This is too late to configure certain properties such as logging.* and spring.main.* which are read before refresh begins.
2. Config data (such as application.properties files).
3. A RandomValuePropertySource that has properties only in random.*.
4. OS environment variables.
5. Java System properties (System.getProperties()).
6. JNDI attributes from java:comp/env.
7. ServletContext init parameters.
8. ServletConfig init parameters.
9. Properties from SPRING_APPLICATION_JSON (inline JSON embedded in an environment variable or system property).
10. Command line arguments.
11. properties attribute on your tests. Available on @SpringBootTest and the test annotations for testing a particular slice of your application.
12. @TestPropertySource annotations on your tests.
13. Devtools global settings properties in the $HOME/.config/spring-boot directory when devtools is active.

配置文件按以下優(yōu)先級覆蓋

0. Application properties packaged inside your jar (application.properties and YAML variants).
1. Profile-specific application properties packaged inside your jar (application-{profile}.properties and YAML variants).
2. Application properties outside of your packaged jar (application.properties and YAML variants).
3. Profile-specific application properties outside of your packaged jar (application-{profile}.properties and YAML variants).

可通過命令行設(shè)置配置

使用 -- 前綴

關(guān)閉命令行參數(shù)
SpringApplication.setAddCommandLineProperties(false)

通過json配置

環(huán)境變量: SPRING_APPLICATION_JSON java 啟動命令: -Dspring.application.json

外部配置

通過以下順序:

0. classpath
   0. classpath
   1. classpath/config
1. current dir
   0. current dir
   1. current dir/config

修改配置文件名稱 Java啟動命令 --spring.config.name=···

修改配置文件地址 --spring.config.location
--spring.config.additional-location

配置文件地址支持使用通配符* , 支持多個目錄配置文件

環(huán)境配置文件 application-{profile}

外部導(dǎo)入

支持外部導(dǎo)入配置文件

spring.config.import=optional:file:./dev.properties

若不支持后綴名可以換寫法:

spring.config.import=optional:file:./dev[.ymal]

配置樹

可支持按文件層級關(guān)系做配置

spring.config.import=optional:configtree:/etc/config

占位符

可使用其他配置作為變量 ${app.name}

配置中的隨機變量

支持integer, long, uuid, strings.

${random.value}
${random.int}
${random.long}
${random.uuid}
${random.int(10)}
${random.int[1024, 65536]}

類型安全的配置(使用類配置)

@ConfigurationProperties("") 注意還需要作為一個bean來注入使用

Profiles

任何@Comp.NET, @Configuration, @ConfigurationProperties都可以被@Profile限制。

指定激活profile

spring.profiles.active=dev,hsqldb

spring.profiles.default=none

profile group

profiles

spring.profiles.group.production[0]=proddb
spring.profiles.group.production[1]=prodmq

程序設(shè)置profile

SpringApplication.setAdditionalProfiles(...)

Logging

日志格式

• Date and Time: Millisecond precision and easily sortable.
• Log Level: ERROR, WARN, INFO, DEBUG, or TRACE.
• Process ID.
• A --- separator to distinguish the start of actual log messages.
• Thread name: Enclosed in square brackets (may be truncated for console output).
• Logger name: This is usually the source class name (often abbreviated).
• The log message.

日志顏色

%clr 來指定日志顏色

%clr(%5p)
%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){yellow}

顏色支持: blue,cyan,faint,green,magenta,red,yellow

文件輸出

日志文件為10MB, 默認輸出ERROR, WARN, INFO logging.file.name logging.file.path

file rotation

• logging.logback.rollingpolicy.file-name-pattern
• The filename pattern used to create log archives.
• logging.logback.rollingpolicy.clean-history-on-start
• If log archive cleanup should occur when the application starts.
• logging.logback.rollingpolicy.max-file-size
• The maximum size of log file before it is archived.
• logging.logback.rollingpolicy.total-size-cap
• The maximum amount of size log archives can take before being deleted.
• logging.logback.rollingpolicy.max-history
• The maximum number of archive log files to keep (defaults to 7).

日志等級

日志級別: TRACE, DEBUG, INFO, WARN, ERROR, FATAL, OFF

logging.level.<logger-name>=<level>
logging.level.root=

日志組

spring有預(yù)設(shè)的日志組 如 web, sql

logging.group.Tomcat=org.Apache.catalina,org.apache.coyote,org.apache.tomcat

logging.level.tomcat=trace

日志關(guān)閉鉤子

logging.register-shutdown-hook=false

自定義日志配置

指定自定義日志系統(tǒng)

org.springframework.boot.logging.LoggingSystem=

logback: logback-spring.xml, logback.xml

log4j2: log4j2-spring.xml, log4j2.xml

JDK: logging.properties