image.png

Upgrading from Spring Boot 1.5

由于1.5版本是Spring Boot的主要版本，所有升級現(xiàn)有的應用程序可能會比平常更復雜一點。我們制定了專門的遷移指南來幫助您升級現(xiàn)有的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的特性，已更新了許多現(xiàn)有API，例如：接口上的默認方法，函數(shù)回調(diào)以及新的API，如javax.time。如果您目前正在使用Java 7或更早版本，那么在開發(fā)Spring Boot 2.0應用程序之前，您需要升級您的JDK。

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

Third-party Library Upgrades

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

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

Tomcat 8.5
Flyway 5
Hibernate 5.2
Thymeleaf 3

Reactive Spring

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

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

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。有關(guān)詳細信息，請參閱Spring Boot參考文檔。

Reactive Spring Data

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

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

Reactive Spring Security

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

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

Embedded Netty Server

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

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

HTTP/2 Support

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

有關(guān)詳細信息，請參閱 this "how to" section。

Configuration Property Binding

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

通過新的Binder API可以在您的代碼中直接使用@ConfigurationProperties。例如，下面的示例將實現(xiàn)綁定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

有關(guān)更新綁定規(guī)則的更多信息，請參閱此Wiki頁面。

Property Origins

YAML文件和Properties文件現(xiàn)在都包含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類的綁定器，提供了一些對屬性綁定特別有用的額外轉(zhuǎn)換器。最引人注目的是 Duration和分隔字符串類型的轉(zhuǎn)換器。

Gradle Plugin

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

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

Kotlin

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

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

Actuator Improvements

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

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

Actuator JSON

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

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

現(xiàn)在可以使用Spring REST Docs生成的REST API 文檔，并隨每個版本發(fā)布。

Jersey and WebFlux Support

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

Hypermedia links

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

Actuator @Endpoints

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

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

Micrometer

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

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

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

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

Data Support

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

HikariCP

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

Initialization

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

如果在使用Flyway或Liquibase管理你的DataSource，并且您正在使用嵌入式數(shù)據(jù)庫，Spring Boot現(xiàn)在會自動關(guān)閉Hibernate的自動DDL功能。

JOOQ

Spring Boot 2.0現(xiàn)在基于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現(xiàn)在支持自動配置開源數(shù)據(jù)庫InfluxDB。要啟用InfluxDB支持，您需要設置一個spring.influx.url屬性，并將influxdb-java包含到您的類路徑中。

Flyway/Liquibase Flexible Configuration

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

Hibernate

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

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

MongoDB Client Customization

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

Redis

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

Web

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

Context Path Logging

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

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

Web Filter Initialization

Web filters 現(xiàn)在在所有容器內(nèi)都支持 eagerly 初始化。

Thymeleaf

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

JSON Support

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

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

Quartz

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

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

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

Testing

補充和調(diào)整了Spring Boot 2.0中提供的測試支持：

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

Miscellaneous

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

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

Animated ASCII Art

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