序言
本次所学习使用的Mysql版本：5.7.20，Mybatis版本3.4.0，JDBC版本5.1.30。
概述
在使用Mybatis这种半自动化的框架中，我们都知道，实体Entity的属性与数据库中表的字段存在着一种映射关系，我们以MySql举例，比如表中varchar与java中String的映射，date与java.sql.Date，time与java.sql.Time，datetime与java.util.Date等之间的这种映射关系。而在JDK8中，目前是没有直接提供与LocalDate这种相关联的映射的。如果直接使用，会提示类似错误：
No typehandler found for property create
不过，Mybatis也提供了一个间接的方式来实现这种转换。
也就是说，我们直接在pom.xml中添加以下依赖就可以完成相应的转换：
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-typehandlers-jsr310</artifactId>
<version>1.0.2</version>
</dependency>
实例
再多说一点，Mysql中与日期时间相关的类型有如下5种：time, date, datetime, timestamp, year，所以我们基于这几种类型进行如下两个简单的例子：
-
新建表结构：
表结构.png
数据.png 对应的实体：Student（JDK8之前），Student2（JDK8之后），注意其中的参数类型；
import java.sql.Date;
import java.sql.Time;
import java.sql.Timestamp;
/**
* Student实体
*
* @author zhangwugui
* @since 2018/1/24 17:22
*/
public class Student {
private Integer id;
private String name;
private Integer age;
private Date create;
private java.util.Date update;
private Time modify;
private Timestamp stamp;
private Integer year;
// get, set方法省略
@Override
public String toString() {
return "Student{" +
"id=" + id +
", name='" + name + '\'' +
", age=" + age +
", create=" + create +
", update=" + update +
", modify=" + modify +
", stamp=" + stamp +
", year=" + year +
'}';
}
}
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
/**
* Student实体
*
* @author zhangwugui
* @since 2018/1/24 17:22
*/
public class Student2 {
private Integer id;
private String name;
private Integer age;
private LocalDate create;
private LocalDateTime update;
private LocalTime modify;
private LocalDateTime stamp;
private Integer year;
// get,set方法省略
@Override
public String toString() {
return "Student{" +
"id=" + id +
", name='" + name + '\'' +
", age=" + age +
", create=" + create +
", update=" + update +
", modify=" + modify +
", stamp=" + stamp +
", year=" + year +
'}';
}
}
- 其他的Mapper配置相关的就不多说了，因为这不是本文的重点。如果需要，可以参考我另一篇文章，链接：Mybatis环境配置。
pom.xml添加JSR-310支持即可：
<dependencies>
<!-- mybatis 配置 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>${mybatis.version}</version>
</dependency>
<!-- mysql驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.30</version>
</dependency>
<!-- JSR 310支持 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-typehandlers-jsr310</artifactId>
<version>1.0.1</version>
</dependency>
</dependencies>
- 执行：
String statement = "com.mapper.IStudentMapper.getAll";
List<Student> student = sessionManager.selectList(statement);
System.out.println(student);
String statement2 = "com.mapper.IStudent2Mapper.getAll";
List<Student2> student2 = sessionManager.selectList(statement2);
System.out.println(student2);
- 打印结果：
[Student{id=1, name='test', age=13, create=2018-01-31, update=Wed Jan 31 15:20:15 CST 2018,
modify=15:20:22, stamp=2018-01-31 07:20:31.0, year=2018}]
[Student{id=1, name='test', age=13, create=2018-01-31, update=2018-01-31T15:20:15,
modify=15:20:22, stamp=2018-01-31T07:20:31, year=2018}]
可以看到，已经实现了数据映射的功能。
不过有一些问题需要注意：
- Mybatis版本必须是3.4.0或之后版本，如果是之前的版本，还需要在mybatis-config.xml中配置：
<typeHandlers>
<!-- ... -->
<typeHandler handler="org.apache.ibatis.type.InstantTypeHandler" />
<typeHandler handler="org.apache.ibatis.type.LocalDateTimeTypeHandler" />
<typeHandler handler="org.apache.ibatis.type.LocalDateTypeHandler" />
<typeHandler handler="org.apache.ibatis.type.LocalTimeTypeHandler" />
<typeHandler handler="org.apache.ibatis.type.OffsetDateTimeTypeHandler" />
<typeHandler handler="org.apache.ibatis.type.OffsetTimeTypeHandler" />
<typeHandler handler="org.apache.ibatis.type.ZonedDateTimeTypeHandler" />
<typeHandler handler="org.apache.ibatis.type.YearTypeHandler" />
<typeHandler handler="org.apache.ibatis.type.MonthTypeHandler" />
<typeHandler handler="org.apache.ibatis.type.YearMonthTypeHandler" />
<typeHandler handler="org.apache.ibatis.type.JapaneseDateTypeHandler" />
</typeHandlers>
- NOTE ：Since version 3.4.5, The MyBatis has been supported JSR-310(Date and Time API) by default。
也就是说在Mybatis3.4.5之后，官方已经默认支持了JSR-310，所以我们也不用添加额外配置了。
- (1) mybatis-typehandlers-jsr310 GitHub地址：
https://github.com/mybatis/typehandlers-jsr310
(2) mybatis的typeHandlers类型转换器配置说明：
http://www.mybatis.org/mybatis-3/zh/configuration.html#typeHandlers
(3) JDK1.8API说明：
https://docs.oracle.com/javase/8/docs/api/
