Mybatis中使用JDK8的日期API-LocalDateTime

序言

  本次所学习使用的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，所以我们基于这几种类型进行如下两个简单的例子：

1. 新建表结构：

    

   

   表结构.png

    

   

   数据.png

2. 对应的实体：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 +
                '}';
    }
}

1. 其他的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>

1. 执行：

 

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);

1. 打印结果：

 

[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}]

可以看到，已经实现了数据映射的功能。

不过有一些问题需要注意：

1. 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>

1. 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. (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/

 

原文地址：https://www.jianshu.com/p/ab40e1eedc02