让 Spring Data 兼容 Java 8 的时间 API（java.time 包，JSR310)

这个内容，在官方博客里面有介绍，地址在：
https://spring.io/blog/2015/03/26/what-s-new-in-spring-data-fowler#jsr-310-and-threeten-backport-support

Stackoverflow 上也有一个关于这个问题的讨论，地址在：
http://stackoverflow.com/questions/29241575/new-spring-data-jdk8-jsr310jpaconverters-not-working-automatically

官方博客说，如果用的是 MongoDB，默认就自动支持了这个转换，如果用的 JPA，你就需要手动开启这个配置。
方法如下，在你的启动类上添加注解：

1
2
3
4
5

@EntityScan(
    basePackageClasses = { Application.class, Jsr310JpaConverters.class }
)
@SpringBootApplication
class Application { ...... }

注意，@EntityScan扫描类必须添加你的启动类Application.class。
因为这个注解是覆盖的，你添加了之后，@SpringBootApplication本身的扫描就无效了。
这会造成你的项目启动失败，以为你项目本身的包不会被扫描了。

这样你就可以在 JPA 中使用 Java 8 的时间 API 了，可以直接这么写：

1
2
3
4
5
6
7
8
9
10
11

@Entity
public class User {
    @Id
    private int id;
    private LocalDateTime createTime;   // JSR310
    ......
}

在 MySql 中会直接映射为 datetime 类型。
要注意的是，只支持LocalDateTime等类型，不支持ZonedDateTime以及其他类型。
因为，MySql 的 datetime 不支持时区。官方博客原文是这样的：

Note, that due to the fact that the converter simply converts the JSR-310 types to legacy Date instances, only non-time-zoned (e.g. LocalDateTime etc.) are supported.

打开Jsr310JpaConverters.java你会发现这个类实现上就是提供了一批 Converter，来支持时间类型的转换。

官方博客也提到了另外一个转化器类，叫做ThreeTenBackPortJpaConverters.java，名字翻译过来也是310。
他的实现跟Jsr310JpaConverters.java是相同的，差别在于：
Jsr310JpaConverters.java转换的是java.time里面的类型，而
ThreeTenBackPortJpaConverters.java转换的则是org.threeten.bp里面的类型，
这其实是一个 Java 8 时间类型的兼容项目，项目主页在：http://www.threeten.org
当然，如果你本身用的就是 Java 8 的环境，就没必要关心这个了。

This blog is under a CC BY-NC-SA 3.0 Unported License
本文链接： http://blog.takwolf.com/2016/06/16/spring-data-support-jsr-310-datetime/