生活不可能像你想象的那麼好，但也不會像你想象的那麼糟。我覺得人的脆弱和堅強都超乎自己的想象。有時，可能脆弱得一句話就淚流滿面；有時，也發現自己咬著牙走了很長的路。——源自 莫泊桑

開始前…

本章內容主要介紹的是Spring Boot常用的配置，相對前一篇來說，比較簡單。“配置即使用“的意思就是，在工程裡配置了自帶的預設配置或自定義配置後，就能生效的一種功能，這也是Spring Boot推薦的一種做法。常用配置，就是一般用得最多的配置，大家預設推薦的配置。其實大家都知道官方有最標準的配置，但是有時就是不願去看，反而喜歡常用配置，為什麼呢？一般的技術文件都是枯燥乏味的，寫的井然有序，適合查詢，但是一般的情況下，有些配置很少會用到，所以，就逐漸形成了常用配置。

說說@SpringBootApplication

@SpringBootApplication是Spring Boot的核心註解，它本身是一個的註解組合，包含了啟動配置的一系列功能，讓我們來看下原始碼：

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import
 
 java.lang.annotation.Target;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.annotation.AliasFor;

@Target({ElementType.TYPE})
@Retention
 
(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@Configuration
@EnableAutoConfiguration
@ComponentScan
public @interface SpringBootApplication {
    Class<?>[] exclude() default {};

    String[] excludeName() default {};

    @AliasFor(
        annotation = ComponentScan.class,
        attribute = "basePackages"
    )
    String[] scanBasePackages() default {};

    @AliasFor(
        annotation = ComponentScan.class,
        attribute = "basePackageClasses"
    )
    Class<?>[] scanBasePackageClasses() default {};
}

組合包含了以下重要註解：

@Configuration
@EnableAutoConfiguration
@ComponentScan

其中，@Configuration表示這是一個配置，@EnableAutoConfiguration表示讓Spring Boot根據類路徑中的jar包依賴為當前專案進行自動配置。

比如，添加了spring-boot-starter-web這個基礎依賴，Spring Boot會自動新增tomcat和Spring MVC的依賴，並且自動對他們進行配置。

@ComponentScan表示的是大家都熟悉的自動bean掃描注入。

如果不使用@SpringBootApplication，可以像我第一章那樣，使用單獨的註解，效果是一樣的。

再來說一下入口類，Spring Boot的啟動是靠一個名為*Application的入口類來實現的，入口類其實就是一個標準的Java靜態方法類，只不過是在類中使用了一個物件SpringApplication的run方法來啟動Spring Boot專案。如下圖：

由於Spring Boot會自動掃描@SpringBootApplication所在類的同級包（如com.hjf.boot.demo.boot_mybatis）以及下級包裡的所有bean，所以，官方建議入口類放在最外層的包名下。如下圖：

最後，還有一個新的註解@AliasFor，這個註解應該是從4.2開始的標示註解屬性別名的含義。

屬性檔案配置

Spring Boot的預設屬性配置檔案是在resources下的application.properties，也可以使用application.yaml來配置預設引數。如果是使用Spring Boot自帶的配置的話，配置即使用，無需再單獨去宣告內容。例如：

也可以使用自己習慣的配置，但是這種方式不太安全，有可能會和自帶的配置或第三方配置衝突，例如：

test.user=mickjoust
test.age=30

Spring Boot推薦使用型別安全的方式來進行自定義配置，例如：

@ConfigurationProperties(
        prefix = "safe"   //定義了一個safe字首的配置類
)
public class SafeProperties {
}

日誌配置

Spring Boot支援 Java Utile Logging、Log4J、Log4J2和Logback作為日誌框架，無論使用哪種框架，Spring Boot都為當前使用日誌框架及檔案輸出做好了配置。

預設情況下，Spring Boot使用LogBack作為預設日誌框架，輸出格式的檔案是logback.cml

配置日誌級別：

logging.file=/export/log

配置日誌檔案，按照格式loggin.level.包名=級別：

logging.level.org.springframework.web=DEBUG

或者直接配置root所有日誌級別：

logging.level.root=DEBUG

Profile配置

Profile是Spring針對不同的環境提供不同的配置支援的一種功能，一般應用在生產環境和測試環境的配置區分上（比如，測試環境一般需要列印更多日誌資訊或者http響應中會有很多測試標示資訊等等，生產環境則不會有）。Spring Boot中通過類似格式applicaiotn-{profile_name}.properties的配置形式指定當前活動的Profile。
例如：首先在application.properties中配置如下：

spring.profiles.active=dev

新建application-dev.properties和application-online.properties兩個配置檔案，內容分別如下：
application-dev.properties

server.port=8181

application-online.properties

server.port=9090

檔案結構如下：

啟動不同配置即可看到用的是測試環境配置，如下，切換配置同理。
使用測試環境配置

使用生產環境配置

引用xml配置

上一章裡已經使用過，使用@ImportResource來載入xml配置，使我們在特定的應用的場景下去使用xml的配置：

@ImportResource(locations = "classpath*:/applicationContext.xml")

關閉自動配置

同樣，上一章中已經配置過，當我們需要關閉自動配置的功能是，找到對應的自動配置的類，新增到排除項裡即可，多項採用逗號隔開.class名稱：

@SpringBootApplication(exclude = {MybatisAutoConfiguration.class})

Banner配置

關閉banner

Banner是什麼？其實就是啟東時顯示的一個圖案，Spring Boot預設顯示如下：

如果不想顯示它，直接在配置檔案裡配置即可關閉，如下：

spring.main.banner-mode=off

修改banner

我們也可以定製自己的啟動圖案，通過字元生成網站生成好看的字母或圖案字元來顯示自己的啟動圖案。

1、在src/main/resources下新建一個banner.txt。
2、將生成好的字元複製到banner.txt中。
3、啟動即可顯示自定義圖案了。

starter pom

Spring Boot為我們提供了大多數常用的封裝依賴，叫做starter pom，只要使用相關的starter pom，則Spring Boot會為我們自動的配置Bean，使用配置檔案即可修改常用引數。除了官方提供的starter pom以外，頁可以自己封裝starter應用於自己的專案，後面再抽空演示如何自定義starter pom，像上一章裡的mybatis就是mybatis小組封裝的starter提供對Spring Boot的支援。

官方地址starter pom地址：

Favicon配置

關閉Favicon

說到favicon.ico這個小圖示，Spring Boot提供了預設的小葉子，如果不需要使用

定製Favicon

但是，絕大多數時候，我們都會定製自己的小圖示，用以區分我們的專案。設定它很簡單，只需要將favicon.ico檔案放到以下目錄下，即可實現。

1、類路徑 根目錄 下
2、類路徑 META-INF/resources/下
3、類路徑 resources/下
4、類路徑 static/下
5、類路徑 public/下

後續文章在整合web專案詳細配置時，會單獨說明除了Spring Boot預設識別的靜態檔案路徑外，怎麼自定義靜態路徑或其它過濾路徑。

一份簡單的配置

#自定義：型別不安全
demo.author=mickjoust
demo.name=mickjoust-boot-demo

#內嵌tomcat配置
server.port=8080
#server.context-path= //如果沒有值就不配置，可以使用預設，但不要在這裡留空，會有錯誤
server.tomcat.uri-encoding=UTF-8

#Profile
spring.profiles.active=dev

#http encoding
spring.http.encoding.charset=UTF-8
spring.http.encoding.enabled=true
spring.http.encoding.force=true

#日誌
#logging.file=/export/log
#logging.level.root=DEBUG
#logging.level.org.springframework.web=DEBUG
#logging.level.sample.mybatis.mapper=TRACE

#datasource
#spring.datasource.driver-class-name=com.mysql.jdbc.Driver
#spring.datasource.url=jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=UTF-8
#spring.datasource.username=test
#spring.datasource.password=123456
#spring.datasource.max-active=10
#spring.datasource.max-idle=5
#spring.datasource.min-idle=0

#converters 預設jackson
spring.http.converters.preferred-json-mapper=gson

#spring.main.banner-mode=off

小結

本章主要是對常用的Spring Boot配置做了簡單的說明，更詳細的配置可以參考官方的解釋。配置內容和整合使用的依賴有關係，比如，ssl，jpa，jackson，httpconvert，mvc等等，具體使用時再說明。

page 165 of 366 in chapter 2016