【官方文档】Spring Boot 2.0 迁移指南【已翻译54%】

逃离我推掉我的手 2022-05-30 02:16 207阅读 0赞

英文原文： [Spring Boot 2.0 Migration Guide][]

标签： [Spring Boot][]

本文档主要通过开发指南的方式来帮助您将应用程序迁移到 Spring Boot 2.0。

# 在你开始之前 #

首先，**Spring Boot 2.0.0 要求 Java 8 或更高版本**，不再支持 Java 6 和 7。

在 Spring Boot 2.0 中，许多配置属性已被重命名或被删除，相应地，开发者需要升级他们的 `application.properties`/`application.yml`。为了方便升级，Spring Boot 发布了一个新的 `spring-boot-properties-migrator` 模块。只要将其作为依赖添加到项目中，它不仅会分析应用程序的环境并在启动时打印诊断信息，而且还会在运行时为项目临时迁移属性。在您的应用程序迁移期间，这个模块是必备的：

<dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-properties-migrator</artifactId>
    </dependency>

<table style="font-size:14px;max-width:100%;border-spacing:1px;color:rgb(68,68,68);border:0px;"> 
 <tbody> 
  <tr> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);"><p style="margin-bottom:16px;">注意<br></p></td> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);">迁移完成之后，请确保从项目的依赖关系中移除该模块。</td> 
  </tr> 
 </tbody> 
</table>

如果你想查看具体内容，请参阅以下资源，或者继续阅读下一节

*  [Spring Boot 2.0.0 发布说明][Spring Boot 2.0.0]
 *  [使用 Java 9 运行 Spring Boot][Java 9 _ Spring Boot]

[![AmosWang][]][AmosWang 1]

AmosWang

翻译于 3天前

0人顶

顶  翻译得不错哦！

# 构建你的 Spring Boot 应用 #

## Spring Boot 的 Maven 插件 ##

为保持一致性，以及避免与其它插件的冲突，现在暴露的插件配置属性都以 `spring-boot` 为前缀。

例如，使用下面的命令行能启用名字为 foo 的配置文件：

mvn spring-boot:run -Dspring-boot.run.profiles=foo

### Surefire 插件的默认值 ###

惯用的 include/exclude 配置模式已经和最新的 Surefire 插件默认集成。如果依赖于此插件，需要相应地更新插件配置。之前对应的配置如下：

<plugin>
    	<groupId>org.apache.maven.plugins</groupId>
    	<artifactId>maven-surefire-plugin</artifactId>
    	<configuration>
    		<includes>
    			 <include>**/*Tests.java</include>
    			 <include>**/*Test.java</include>
    		</includes>
    		<excludes>
    			<exclude>**/Abstract*.java</exclude>
    		</excludes>
    	</configuration>
    </plugin>

> 注意：如果你使用的是 JUnit 5 版本，你应该将 Surefire [降级到 2.19.1 版本][2.19.1]。`**/*Tests.java`  模式不包含在此版本，所以如果你依赖于它，请确保在你已配置文件中将其添加。

[![dreamanzhao][]][dreamanzhao 1]

dreamanzhao

翻译于 2天前

2人顶

顶  翻译得不错哦！

其它翻译版本(1)

## Spring Boot 的 Gradle 插件 ##

Spring Boot 的 Gradle 插件经过了重大的重写，并带来了大量的改进。你可以通过参阅[手册][Link 1]和 [api][] 文档以了解插件的功能。

### 依赖管理 ###

Spring Boot 的 Gradle 插件不再自动应用依赖管理插件。与之代替的是，Spring Boot 的插件现在可以通过导入正确版本的 spring-boot-dependencies bom 来应用依赖管理插件。当依赖管理被配置的时候，这一点会让你有更多的控制权。

对于大多数应用程序，使用应用依赖管理插件就足够了：

apply plugin: 'org.springframework.boot'
    apply plugin: 'io.spring.dependency-management' // <-- 添加这个到你的 build.gradle

<table style="font-size:14px;max-width:100%;border-spacing:1px;color:rgb(68,68,68);border:0px;"> 
 <tbody> 
  <tr> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);"><p style="margin-bottom:16px;"><br></p><p style="margin-bottom:16px;">注意</p></td> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);">依赖管理插件仍然是 spring-boot-gradle-plugin 的传递依赖项，所以不需要在 buildscript 配置中将其列为类路径依赖项。</td> 
  </tr> 
 </tbody> 
</table>

### 构建可执行的 jar 和 war ###

bootRepackage 任务已经被替换成 bootJar 和 bootWar 任务，分别用于构建可执行的 jar 包和 war 包。

[![无若][553781_100.jpeg_t_1514855267000]][553781_100.jpeg_t_1514855267000 1]

无若

翻译于 2天前

0人顶

顶  翻译得不错哦！

# Spring Boot 特性    #

## 默认动态代理策略 ##

Spring Boot现在默认使用CGLIB动态代理(基于类的动态代理), 包括AOP. 如果需要基于接口的动态代理(JDK基于接口的动态代理) , 需要设置spring.aop.proxy-target-class属性为false.

## SpringApplication ##

### Web Environment ###

Spring Boot 应用现状可以运行于更多的模式, 所以spring.main.web-environment属性现在不赞成使用, 可以使用spring.main.web-application-type提供更多功能.

如果想让应用以非web服务方式启动, 需要更改属性值:

spring.main.web-application-type=none

<table style="font-size:14px;max-width:100%;border-spacing:1px;color:rgb(0,0,0);border:0px;"> 
 <tbody> 
  <tr> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);"><p style="margin-bottom:16px;">Tip</p></td> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);">可以通过SpringApplication的setWebApplicationType方法实现</td> 
  </tr> 
 </tbody> 
</table>

### Spring Boot 应用时间变更 ###

我们提供了一个新的事件(event)-ApplicationStartedEvent. ApplicationStartedEvent在context刷新之后, 应用或命令行调用之前发送(send). ApplicationReadyEvent在应用活命令行调用之后发送. 表名应用以准备好提供服务.

参考 [updated reference documentation][].

### Banner    ###

我们想要减少Spring Boot使用的命名空间数量, banner-related属性迁移到spring.banner.

[![浪子\_仗剑走天涯][1404252_100.jpg_t_1469542438000]][1404252_100.jpg_t_1469542438000 1]

浪子\_仗剑走天涯

翻译于 22小时前

0人顶

顶  翻译得不错哦！

## 外部化配置    ##

### Relaxed binding 宽松绑定 ###

有关宽松绑定的规则[已经收紧][Link 2]。 我们假设有一个的acme.my-project.my-name属性：

1.  所有前缀必须是kebab格式（小写，连字符分隔），acme.myProject或acme.my\_project是无效的 - 你必须在此处使用acme.my-project
2.  属性名称可以使用kebab-case（my-name），camel-case（myName）或snake-case（my\_name）
3.  环境属性（来自OS环境变量）必须使用常规的大写下划线格式，其中下划线只能用于分隔关键词的各个部分，ACME\_MYPROJECT\_MYNAME

[![Tocy][]][Tocy 1]

Tocy

翻译于 2天前

2人顶

顶  翻译得不错哦！

This new relaxed bindings as several advantages:

*  There is no need to worry about the structure of the key in `@ConditionalOnProperty`: as long as the key is defined in the canonical format, the supported relaxed variants will work transparently. If you were using the `prefix` attribute you can now simply put the full key using the `name` or `value` attributes
 *  `RelaxedPropertyResolver` is no longer available as the `Environment` takes care of that automatically: `env.getProperty("com.foo.my-bar")` will find a `com.foo.myBar` property

The `org.springframework.boot.bind` package is no longer available and is replaced by the [new relaxed binding infrastructure][]. In particular, `RelaxedDataBinder` and friends have been replaced with a new `Binder` API. The following samples binds a POJO from the `com.foo` prefix

new Binder(ConfigurationPropertySources.from(propertySource))
    		.bind("com.foo", Bindable.of(target)))

### `@ConfigurationProperties` validation ###

It is now mandatory that your `@ConfigurationProperties` object is annotated with `@Validated` if you want to turn on validation.

### Configuration location    ###

The behavior of the `spring.config.location` configuration has been fixed; it previously added a location to the list of default ones, now it replaces the default locations. If you were relying on the way it was handled previously, you should now use `spring.config.additional-location` instead.

还没有人翻译此段落 [我来翻译][Link 3]

**开发网页应用**

**嵌入式容器封装结构**

为了支持响应式的使用案例，嵌入式容器封装结构已经很大程度上进行重构。EmbeddedServletContainer已经被重命名为WebServer, 同时org.springframework.boot.context.embedded包已经被迁移至org.springframework.boot.web.embedded。例如，如果你之前使用TomcatEmbeddedServletContainerFactory回调接口来自定义嵌入式的Tomcat容器，现在你应该使用TomcatServletWebServerFactory。

**Servlet-specific的关于server的属性**

一些Servlet-specific已经移动到server.servlet的server.\*属性：

<table style="font-size:14px;max-width:100%;border-spacing:1px;color:rgb(0,0,0);border:0px;"> 
 <tbody> 
  <tr> 
   <th style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);">旧属性</th> 
   <th style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);">新属性</th> 
  </tr> 
 </tbody> 
 <tbody> 
  <tr> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);"><p style="margin-bottom:16px;">server.context-parameters.*</p></td> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);"><p style="margin-bottom:16px;">server.servlet.context-parameters.*</p></td> 
  </tr> 
  <tr> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);"><p style="margin-bottom:16px;">server.context-path</p></td> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);"><p style="margin-bottom:16px;">server.servlet.context-path</p></td> 
  </tr> 
  <tr> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);"><p style="margin-bottom:16px;">server.jsp.class-name</p></td> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);"><p style="margin-bottom:16px;">server.servlet.jsp.class-name</p></td> 
  </tr> 
  <tr> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);"><p style="margin-bottom:16px;">server.jsp.init-parameters.*</p></td> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);"><p style="margin-bottom:16px;">server.servlet.jsp.init-parameters.*</p></td> 
  </tr> 
  <tr> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);"><p style="margin-bottom:16px;">server.jsp.registered</p></td> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);"><p style="margin-bottom:16px;">server.servlet.jsp.registered</p></td> 
  </tr> 
  <tr> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);"><p style="margin-bottom:16px;">server.servlet-path</p></td> 
   <td style="padding-top:5px;padding-bottom:5px;border-color:rgb(204,204,204);"><p style="margin-bottom:16px;">server.servlet.path</p></td> 
  </tr> 
 </tbody> 
</table>

**作为传递性依赖的Web Starter**

先前一些Spring Boot Starter是依赖于Spring MVC的 spring-boot-starter-web。在Spring WebFlux的新的支持下，spring-boot-starter-mustache, spring-boot-starter-freemarker 和spring-boot-starter-thymeleaf不再依赖它了。选择并添加spring-boot-starter-web 或spring-boot-starter-webflux是开发者的职责。

[![dreamanzhao][]][dreamanzhao 1]

dreamanzhao

翻译于 2天前

1人顶

顶  翻译得不错哦！

**模板引擎**

Mustache模板默认的文件扩展名

Mustache模板的文件扩展名曾经是.html。现在的扩展名为.mustache,与官方规格和大多数的IDE插件保持一致。你可以通过更改spring.mustache.suffix配置文件的configuration key来重写这个新的默认值。

**Jackson/JSON支持**

在2.0版本，我们已经设置Jackson配置文件的默认值，将ISO-8601 strings写作了JSR-310。如果你希望返回之前的设置，可以添加spring.jackson.serialization.write-dates-as-timestamps=true 到你的配置文件中。

一个新的spring-boot-starter-json starter收集了必要的位去读写JSON。它不仅提供了jackson-databind，而且提供了和Java8一起运作的时候相当有用的组件：jackson-datatype-jdk8, jackson-datatype-jsr310 和jackson-module-parameter-names。如果你曾经手动地依赖这些组件，现在可以依赖这个新的starter取代。

[![dreamanzhao][]][dreamanzhao 1]

dreamanzhao

翻译于 2天前

0人顶

顶  翻译得不错哦！

**符合默认行为变化的Spring MVC路径**

我们已经决定更改默认关于Spring MVC应用的后缀路径（看[\#11105][11105]）。这个性质已经不再默认启动，请参照[best practice documented in Spring Framework][]。

如果你的应用期望像 "GET /projects/spring-boot.json" 这样的请求可以被映射到@GetMapping("/projects/spring-boot")，这一变化正在影响你。

有关的更多信息和如何减少这种变化，请参考[ Spring Boot有关路径匹配和内容协商的参考文档][Spring Boot 1]。

**Servlet过滤器**

现在Servlet过滤器默认的dispatcher控制器类型是DipatcherType.REQUEST；这个Spring Boot的默认值与Servlet specification的默认值保持一致。如果你想要映射一个过滤器到其它的控制器类型，请使用FilterRegistrationBean注册你的过滤器。

注意：Spring Security和Spring Session过滤器是用来配置 ASYNC, ERROR, 和REQUEST的控制器类型。

[![dreamanzhao][]][dreamanzhao 1]

dreamanzhao

翻译于 22小时前

0人顶

顶  翻译得不错哦！

### RestTemplateBuilder    ###

requestFactory(ClientHttpRequestFactory) 被替换成一个新的requestFactory(Supplier<ClientHttpRequestFactory> requestFactorySupplier). Supplier接口允许每个template使用自己的request factory创建, 从而避免了共享一个工厂方法的不良影响. 参考 [\#11255][11255].

### WebJars Locator ###

Spring Boot 1.x 提供的org.webjars:webjars-locator. webjars-locator依赖管理是 ["poorly named library … that wraps the webjars-locator-core project"][poorly named library _ that wraps the_webjars-locator-core_project]. org.webjars:webjars-locator依赖应替换成org.webjars:webjars-locator-core.

[Spring Boot 2.0 Migration Guide]: https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-2.0-Migration-Guide
[Spring Boot]: https://www.oschina.net/translate/tag/spring-boot
[Spring Boot 2.0.0]: https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-2.0.0-Release-Notes
[Java 9 _ Spring Boot]: https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-with-Java-9
[AmosWang]: https://static.oschina.net/uploads/user/1405/2811278_100.jpg?t=1516289272000
[AmosWang 1]: https://my.oschina.net/AmosWang
[2.19.1]: http://junit.org/junit5/docs/5.0.0/user-guide/#running-tests-build-maven
[dreamanzhao]: https://static.oschina.net/uploads/user/1756/3512005_100.jpg?t=1519524681000
[dreamanzhao 1]: https://my.oschina.net/u/3512005
[Link 1]: https://docs.spring.io/spring-boot/docs/current-SNAPSHOT/gradle-plugin/reference
[api]: https://docs.spring.io/spring-boot/docs/current-SNAPSHOT/gradle-plugin/api
[553781_100.jpeg_t_1514855267000]: https://static.oschina.net/uploads/user/276/553781_100.jpeg?t=1514855267000
[553781_100.jpeg_t_1514855267000 1]: https://my.oschina.net/crooner
[updated reference documentation]: https://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference/htmlsingle/#boot-features-application-events-and-listeners
[1404252_100.jpg_t_1469542438000]: https://static.oschina.net/uploads/user/702/1404252_100.jpg?t=1469542438000
[1404252_100.jpg_t_1469542438000 1]: https://my.oschina.net/u/1404252
[Link 2]: https://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference/htmlsingle/#boot-features-external-config-relaxed-binding
[Tocy]: https://static.oschina.net/uploads/user/367/734219_100.jpeg?t=1488431231000
[Tocy 1]: https://my.oschina.net/tocy
[new relaxed binding infrastructure]: https://github.com/spring-projects/spring-boot/wiki/Relaxed-Binding-2.0
[Link 3]: https://www.oschina.net/translate/translate?id=62829
[11105]: https://github.com/spring-projects/spring-boot/issues/11105
[best practice documented in Spring Framework]: https://docs.spring.io/spring/docs/current/spring-framework-reference/web.html#mvc-ann-requestmapping-suffix-pattern-match
[Spring Boot 1]: https://docs.spring.io/spring-boot/docs/2.0.0.RC1/reference/html/boot-features-developing-web-applications.html#boot-features-spring-mvc-pathmatch
[11255]: https://github.com/spring-projects/spring-boot/issues/11255
[poorly named library _ that wraps the_webjars-locator-core_project]: https://github.com/webjars/webjars-locator/tree/ec6b793f2d6f031f6aa384a06c059ff499055652