Spring Boot 2.0 Release Notes 中文版

image.png

Upgrading from Spring Boot 1.5

由于1.5版本是Spring Boot的主要版本，所有升級現有的應用程序可能會比平常更復雜一點。我們制定了專門的遷移指南來幫助您升級現有的Spring Boot 1.5應用程序。

如果您目前正在運行更早版本的Spring Boot，強烈建議在遷移到Spring Boot 2.0之前先升級到Spring Boot 1.5。

New and Noteworthy

Tip:檢查 the configuration changelog以獲取配置更改的完整概述。

Java 8 Baseline and Java 9 Support

Spring Boot 2.0要求Java 8作為其最低版本。為利用Java 8的特性，已更新了許多現有API，例如：接口上的默認方法，函數回調以及新的API，如javax.time。如果您目前正在使用Java 7或更早版本，那么在開發Spring Boot 2.0應用程序之前，您需要升級您的JDK。

Spring Boot 2.0 已經能很好地工作了，并且已經通過基于JDK 9的測試。所有的jar包都在系統兼容性模塊測試清單中（the manifests for module system compatibility）附帶自動測試用例。

Third-party Library Upgrades

Spring Boot 2.0建立在Spring Framework 5之上，Spring Framework 5.0中提供的新功能，請在升級之前查看其升級指南。

我們已盡可能將其他第三方依賴jar升級到最新穩定版本。本版本中一些重要的依賴升級包括：

Tomcat 8.5
Flyway 5
Hibernate 5.2
Thymeleaf 3

Reactive Spring

許多使用Spring構建的項目的現在都在為 reactive applications提供一流的支持。響應式編程是完全異步和非阻塞的。它們旨在用于事件驅動模型（而不是傳統的每個請求都需要一個線程執行的模型）。讀者可以將Spring框架參考文檔中的“Web on Reactive Stack”部分作為一個很好的入門參考。

Spring Boot 2.0通過自動配置和starter-POMs 來全面支持reactive applications。Spring Boot的內部本身也在必要時進行了更新，為各種組件的響應式編程提供了自動化配置（最明顯的是我們的嵌入式服務器支持）。

Spring WebFlux & WebFlux.fn

Spring WebFlux是支持Spring MVC的非阻塞式替代方案。Spring Boot為基于注釋的Spring WebFlux應用程序以及WebFlux.fn提供了自動配置支持，為WebFlux.fn提供了更實用的 style API。

在啟動時，使用spring-boot-starter-webflux starter POM，它將提供支持Spring WebFlux的嵌入式Netty Server。有關詳細信息，請參閱Spring Boot參考文檔。

Reactive Spring Data

在底層技術支持的情況下，Spring Data也為reactive applications提供支持。目前Cassandra，MongoDB，Couchbase和Redis都有響應式API支持。

Spring Boot可為您提供所有針對以上技術的不同 starter-POMs。例如，spring-boot-starter-data-mongodb-reactive包含了所有對響應式mongo的相關驅動依賴。

Reactive Spring Security

Spring Boot 2.0支持集成Spring Security 5.0。為WebFlux程序提供Spring Security的自動配置。

使用WebFlux的Spring Security訪問規則可以通過SecurityWebFilterChain來自動配置。如果你之前使用過Spring MVC，將會感到非常熟悉。有關更多詳細信息，請參閱Spring Boot參考文檔和Spring Security文檔。

Embedded Netty Server

由于WebFlux不依賴于Servlet API，現在首次支持Netty作為嵌入式Server。該spring-boot-starter-webflux starter POM 將引入 Netty 4.1和Ractor Netty。

Note: 你可以只使用 Netty 作為一個響應式Server，而不提供對阻塞 servlet API 的支持。

HTTP/2 Support

現在Tomcat，Undertow和Jetty都已經提供對HTTP / 2的支持。但是這部分取決于所選的Web服務器和應用程序環境（因為JDK 8不支持該協議）。

有關詳細信息，請參閱 this "how to" section。

Configuration Property Binding

在Spring Boot 2.0中，已經徹底修改了用于綁定Environment屬性的@ConfigurationProperties機制。我們借此機會收緊了松散的綁定規則，并修復了Spring Boot 1.x版本中許多不一致的地方。

通過新的Binder API可以在您的代碼中直接使用@ConfigurationProperties。例如，下面的示例將實現綁定PersonName到List對象：

List<PersonName> people = Binder.get(environment)
    .bind("my.property", Bindable.listOf(PersonName.class))
    .orElseThrow(IllegalStateException::new);

在YAML中配置源可以像這樣表示：

my:
  property:
  - first-name: Jane
    last-name: Doe
  - first-name: John
    last-name: Doe

有關更新綁定規則的更多信息，請參閱此Wiki頁面。

Property Origins

YAML文件和Properties文件現在都包含Origin信息，從而可幫助更好的跟蹤項目加載情況。有一些Spring Boot特性可以利用這些信息，并在適當時用于展示。

例如，BindException 類綁定失敗時拋出的OriginProvider。這意味著origin信息可以很好地從故障分析器中顯示出來。

另一個例子是env 可用 actuator端點時其包括的origin信息。下面的代碼顯示的是通過 spring.security.user.name屬性，得知application.properties文件來自jar包下行1，列27。

{
  "name": "applicationConfig: [classpath:/application.properties]",
  "properties": {
    "spring.security.user.name": {
      "value": "user",
      "origin": "class path resource [application.properties]:1:27"
    }
  }
}

Converter Support

使用新的ApplicationConversionService類的綁定器，提供了一些對屬性綁定特別有用的額外轉換器。最引人注目的是 Duration和分隔字符串類型的轉換器。

Gradle Plugin

Spring Boot的Gradle插件已經在很大程度上進行了重新編寫，以實現許多重大改進。您可以在其參考文獻和API文檔中閱讀關于插件功能的更多信息。

Spring Boot現在要求基于Gradle 4.x. 如果您要升級使用Gradle版本，請查看遷移指南。

Kotlin

Spring Boot 2.0現在支持Kotlin 1.2.x，并提供了一種runApplication功能來通過Kotlin運行Spring Boot應用程序。其他Spring項目的最新版本中也對Kotlin做了支持（如Spring Framework，Spring Data和Reactor）。

有關更多信息，請參閱參考文檔的Kotlin支持部分。

Actuator Improvements

對Spring Boot 2.0的許多actuator 端口進行了改進。所有HTTP actuator 端口現在都發布在/actuator路徑下，并且改進了生成的JSON payloads。

我們現在也不會在默認情況下暴露很多端口。如果您要升級現有的Spring Boot 1.5應用程序，請務必查看遷移指南并特別注意management.endpoints.web.exposure.include屬性。

Actuator JSON

Spring Boot 2.0改進了從許多端點返回的JSON payloads信息。

現在許多端口都有能更精確地反映底層數據的JSON信息。例如，/actuator/conditions端口（在Spring Boot 1.5中是/autoconfig）現在將有一個頂級contexts key來將結果分組。

現在可以使用Spring REST Docs生成的REST API 文檔，并隨每個版本發布。

Jersey and WebFlux Support

除了支持Spring MVC和JMX，您現在可以在開發Jersey或WebFlux應用程序時訪問actuator端口。Jersey通過自定義JerseyResource ，WebFlux使用自定義 HandlerMapping來支持。

Hypermedia links

該/actuator 端口現在為所有的活動端口提供了一個HAL格式的超媒體鏈接（即使在classpath下沒有Spring HATEOAS）。

Actuator @Endpoints

為了支持Spring MVC，JMX，WebFlux和Jersey，我們為actuato端口開發了一種新的編程模型。該@Endpoint注解可以與@ReadOperation，@WriteOperation、@DeleteOperation組合使用，來定制一個對技術無感知的開發端口。

您還可以使用@EndpointWebExtension或@EndpointJmxExtension為端口編寫特定的技術擴展功能。詳細信息請參閱更新的參考文檔。

Micrometer

Spring Boot 2.0不再提供自己的metrics API。相反，我們依靠micrometer.io來滿足所有應用程序監控需求。

Metrics可以輸出到各種系統，如Atlas，Datadog，Ganglia，Graphite，Influx，JMX，New Relic，Prometheus，SignalFx，StatsD和Wavefront等。另外還可以使用簡單的in-memory metrics。

支持JVM指標（包括CPU，內存，線程和GC），Logback，Tomcat，Spring MVC＆RestTemplate。

有關更多詳細信息，請參閱參考文檔的更新“Metrics”部分。

Data Support

除了上面提到的“Reactive Spring Data”支持外，在數據領域還進行了一些其他更新和改進。

HikariCP

Spring Boot 2.0中的默認的數據庫連接池組件已從Tomcat連接池切換到HikariCP。Hakari提供了更卓越的性能，不過也有許多用戶更喜歡Tomcat Pool。

Initialization

數據庫初始化邏輯在Spring Boot 2.0中已經更加合理化。Spring Batch，Spring Integration，Spring Session和Quartz的初始化現在默認情況下僅在使用嵌入式數據庫時才會發生。該 enabled 屬性已被更具表現力的枚舉所取代。例如，如果您想要始終執行Spring Batch初始化，您可以通過設置 spring.batch.initialize-schema=always來實現。

如果在使用Flyway或Liquibase管理你的DataSource，并且您正在使用嵌入式數據庫，Spring Boot現在會自動關閉Hibernate的自動DDL功能。

JOOQ

Spring Boot 2.0現在基于DataSource自動檢測jOOQ方言（類似于為JPA方言所做的）。@JooqTest還引入了一個新的注解來簡化只有jOOQ使用的測試。

JdbcTemplate

Spring Boot 使用自定義的spring.jdbc.template 屬性自動配置JdbcTemplate 。

Spring Data Web Configuration

Spring Boot公開了一個新的 spring.data.web 配置namespace來很容易的配置分頁和排序。

Influx DB

Spring Boot現在支持自動配置開源數據庫InfluxDB。要啟用InfluxDB支持，您需要設置一個spring.influx.url屬性，并將influxdb-java包含到您的類路徑中。

Flyway/Liquibase Flexible Configuration

如果僅提供自定義url或user屬性，那么現在Flyway和Liquibase的自動配置將重新使用標準的datasource屬性，而不是忽略它們。這使您可以為了遷移目來，僅使用所需的信息來定制DataSource 。

Hibernate

現在支持自定義Hibernate命名策略。對于高級場景，您現在可以使用常規bean在上下文中定義ImplicitNamingStrategy或PhysicalNamingStrategy。

現在也可以通過HibernatePropertiesCustomizerbean Bean來更加細致地定制Hibernate使用的一些屬性。

MongoDB Client Customization

現在可以通過定義一個MongoClientSettingsBuilderCustomizer類型的bean,來定制支持Spring Boot自動配置的Mongo Client。

Redis

現在可以使用spring.cache.redis.*屬性配置Redis的緩存默認值。

Web

除了上面提到的WebFlux和WebFlux.fn支持之外，還對Web應用程序開發進行了以下改進。

Context Path Logging

當使用嵌入式容器時，當您的應用程序啟動時，上下文路徑將與HTTP端口一起打印出來。例如，embedded Tomcat現在看起來像這樣：

Tomcat started on port(s): 8080 (http) with context path '/foo'

Web Filter Initialization

Web filters 現在在所有容器內都支持 eagerly 初始化。

Thymeleaf

Thymeleaf starter 現在包含了支持javax.time 類型的thymeleaf-extras-java8time 。

JSON Support

新的spring-boot-starter-json starter gathers必要的字節來讀寫JSON。它不僅提供了 jackson-databind，同時也為java8環境提供了很多非常有用的模塊：jackson-datatype-jdk8, jackson-datatype-jsr310 和 jackson-module-parameter-names。這個新的starter現在被用于之前定義jackson-databind的地方。

如果您更喜歡除了Jackson以外的產品，Spring Boot 2.0對GSON支持已經大大提高。我們還引入了對JSON-B的支持（包括JSON-B測試支持）。

Quartz

自動配置現在也支持Quartz Scheduler。我們還添加了新的spring-boot-starter-quartz starter POM。

您可以使用內存的JobStores或完整的基于JDBC存儲的 JobDetail。所有JobDetail，Calendar和Trigger beans將會通過Scheduler自動注冊。

有關更多詳細信息，請閱讀參考文檔“Quartz Scheduler”部分。

Testing

補充和調整了Spring Boot 2.0中提供的測試支持：

為支持WebFlux應用程序的“切片”測試，增加了新的 @WebFluxTest 注解.
Converter 和 GenericConverter 現在通過 @WebMvcTest 和 @WebFluxTest實現自動掃描。
為WebTestClient bean測試提供 @AutoConfigureWebTestClient 注解。該注解將自動應用與 @WebFluxTest 測試。
為了能更加容易地測試自動配置，增加了一個新的ApplicationContextRunner。我們已將大部分內部測試套件移至此新模型。詳細信息請參閱更新的文檔。

Miscellaneous

除了上面列出的變化之外，還有很多小的調整和改進，包括：

@ConditionalOnBean 現在在確定條件是否被滿足時使用邏輯AND而不是邏輯OR。
Unconditional類現在包含在自動配置報表中。
spring CLI應用程序現在包含可用于創建Spring Security的兼容散列密碼的encodepassword command。
計劃任務(i.e. ``@EnableScheduling) 可以通過scheduledtasks`actuator 端口來進行review。
loggers actuator 端口現在允許重新設置一個日志級別作為它的默認值。
使用Spring Session的用戶現在可以通過 sessions actuator 端口查看和刪除sessions。

Animated ASCII Art

最后，為了好玩，Spring Boot 2.0現在支持動畫GIF橫幅。例如this project 。