SpringBoot2.x升级后的变化
SpringBoot 2.x较之前的版本有不少的改动,以下记录在实际运用中已经遇到的一些问题:
注意:以下差异基于的SpringBoot两个版本分别为 1.5.9 和 2.0.2 。
1、context-path配置修改
SpringBoot 1.5.9 在properties文件中配置 context-path 的方式如下所示:
server.context-path = XXX
而在SpringBoot 2.0.2中其配置方式变成了
server.servlet.context-path = XXX
这样的改变使 context-path 的归属更加明确,与之一同更改的还有其他多个参数。
2、java时间类型通过Jackson转换后输出格式的变化
使用 SpringMVC 时,如果 Controller 中的方法使用 @ResponseBody 标注的话,则返回结果一般会使用 jackson 将返回结果转换为 json (并非绝对,如果没有引入 jackson 相关jar包而引入了 gson 相关jar包,则转换 json 的操作就由 gson 来完成,以下讨论只适用于 jackson 操作)。
在使用SpringBoot 1.5.9的时候,如果未指定具体的时间格式的话,通过 @ResponseBody 返回带有 java时间类型的结果时,默认会将 java 时间类型( java.util.Date、java.util.Calendar、java.sql.Date、java.sql.Timestamp 等)以时间戳(当前时间的毫秒数)返回,而在SpringBoot 2.0.2则返回格式是经过了格式化的: yyyy-mm-ddTHH:mi:ss。通过对比发现,在SpringBoot 2.0.2自动配置 jackson 时添加了如下配置:
其重点是 SerializationFeature.WRITE_DATES_AS_TIMESTAMPS 被设置为了 false,即输出时间格式不以时间戳形式展示,其最终影响的是 jackson 中的 ObjectMapper 对象。
如果想要继续返回时间戳格式的数据,则只需要在properties配置文件中添加如下配置即可:
spring.jackson.serialization.write-dates-as-timestamps=true
注意:SpringBoot 2.0.2 对 java 时间格式的影响对 java8 中新增的 java.time.LocalDateTime 并没有效果,当设置 spring.jackson.serialization.write-dates-as-timestamps=true 时,java.time.LocalDateTime会被转换成一个形如 [2018,5,31,17,58,35] 的数组,而非毫秒数。引用jackson-modules-java8中的描述:
LocalDate, LocalTime, LocalDateTime, and OffsetTime, which cannot portably be converted to timestamps and are instead represented as arrays when WRITE_DATES_AS_TIMESTAMPS is enabled.
3、@ConfigurationProperties配置的限制
SpringBoot 中可以使用 @ConfigurationProperties 将一个实体类转变为可配置的类(在properties文件中可以直接配置对应参数的值,如果使用IDE的话,会自动提示)。在 SpringBoot 1.5.9 中设置 @ConfigurationProperties 的 prefix 属性时,使用驼峰命名(如eclipseLink)不会有任何问题,但在 Spring Boot 2.x 启动时会报错:
InvalidConfigurationPropertyNameException: Configuration property name '********' is not valid.
当使用eclipse-link时就不会有任何问题。
4、多数据源配置问题
Spring Boot 2.x中如果配置了多个数据源的话,其中有一项配置是需要注意的:spring.datasource.url!这样的配置有可能是有问题的,需要将其设置成 spring.datasource.jdbc-url!
参考文章:https://www.toutiao.com/i6647092124950987278/