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 。