jdbc源码调试之查看jdbc对LocalDateTime和Date类型的处理

前提

相信很多人在知道serverTimezone参数的设置之后，都会想知道jdbc在我们查询和插入时间类型数据的时候都时怎么进行处理的。下面就以查询来调试跟踪一下jdbc源码看看

当前jdbc依赖的版本和mybatis依赖的版本

<dependency>
	<groupId>org.mybatis</groupId>
	<artifactId>mybatis</artifactId>
	<version>3.5.7</version>
</dependency>
<dependency>
	<groupId>mysql</groupId>
	<artifactId>mysql-connector-java</artifactId>
	<version>8.0.25</version>
	<scope>runtime</scope>
</dependency>

先放一下博主调试过程中打断点的位置，也方便大家一起来跟着走一下源码逻辑：

调试过程：
1.ConnectionImpl.prepareStatement(String sql, int resultSetType, int resultSetConcurrency)--从这里开始断点，可以看到查询使用的sql
2.PreparedStatementHandler.query(Statement statement, ResultHandler resultHandler)--从这里断点，可以看到查询完成，并且开始处理结果的入口
3.DefaultResultSetHandler.getPropertyMappingValue(ResultSet rs, MetaObject metaResultObject, ResultMapping propertyMapping, ResultLoaderMap lazyLoader, String columnPrefix)-- 从这里断点,可以看到调用typeHandler对应的类型处理器去处理列的数据，比如LocalDateTimeTypeHandler和DateTypeHandler
4.AbstractResultsetRow.decodeAndCreateReturnValue(int columnIndex, byte[] bytes, int offset, int length, ValueFactory<T> vf)--从这里断点，可以看到开始选择适合valueDecoder来解析从数据库返回的数据并转换成对应的java类型
5.LocalDateTimeValueFactory.localCreateFromTimestamp(InternalTimestamp its)--从这里断点，可以看到这是最终生成LocalDateTime类型数据的地方
6.SqlTimestampValueFactory.localCreateFromTimestamp(InternalTimestamp its)--从这里断点，可以看到这是最终生成Date类型数据的地方，会将数据库中的时间InternalTimestamp加上serverZoneId转换成一个服务器对应时区的时间对象TimeStamp

1.ConnectionImpl.prepareStatement(String sql, int resultSetType, int resultSetConcurrency)–从这里开始断点，可以看到查询使用的sql

2.PreparedStatementHandler.query(Statement statement, ResultHandler resultHandler)–从这里断点，可以看到查询完成，并且开始处理结果的入口

3.DefaultResultSetHandler.getPropertyMappingValue(ResultSet rs, MetaObject metaResultObject, ResultMapping propertyMapping, ResultLoaderMap lazyLoader, String columnPrefix)-- 从这里断点,可以看到调用typeHandler对应的类型处理器去处理列的数据，比如LocalDateTimeTypeHandler和DateTypeHandler

4.AbstractResultsetRow.decodeAndCreateReturnValue(int columnIndex, byte[] bytes, int offset, int length, ValueFactory vf)–从这里断点，可以看到开始选择适合valueDecoder来解析从数据库返回的数据并转换成对应的java类型

5.LocalDateTimeValueFactory.localCreateFromTimestamp(InternalTimestamp its)–从这里断点，可以看到这是最终生成LocalDateTime类型数据的地方

6.SqlTimestampValueFactory.localCreateFromTimestamp(InternalTimestamp its)–从这里断点，可以看到这是最终生成Date类型数据的地方，会将数据库中的时间InternalTimestamp加上serverZoneId转换成一个服务器对应时区的时间对象TimeStamp

大概的逻辑整理了下：

1.当你调用Mybatis的查询时候，他已经有了每一个mapper.xml文件对应的对象了，其中包括每一条查询所需要对应结果处理器
2.每一种java类型对应一种结果处理器xxxTypeHandler，Date类型对应的结果处理器为DateTypeHandler，LocalDateTime类型的结果处理器为LocalDateTimeTypeHandler
3.所有的结果处理器都继承了BaseTypeHandler，并实现了其中的getNullableResult方法，这个方法会决定调用ResultSetImpl类的哪个方法去解析数据。
4.接着就是会调用AbstractResultsetRow.decodeAndCreateReturnValue方法去根据列对应的数据库类型去调用ValueDecoder对应的方法，ValueDecoder会使用ValueFactory去解码数据。
5.最终LocalDateTime类型会调用LocalDateTimeValueFactory.localCreateFromTimestamp(InternalTimestamp its)会将数据库中的时间InternalTimestamp转换成LocalDateTime对象
6.而Date类型会调用SqlTimestampValueFactory.localCreateFromTimestamp(InternalTimestamp its)会将数据库中的时间InternalTimestamp加上serverZoneId转换成一个服务器对应时区的时间对象TimeStamp

总结：

在mybatis 3.5.7 + jdbc 8.0.25版本中,jdbc处理LocalDateTime类型数据不会受serverTimezone影响，但是Date类型的数据会。

另话：

如果是以前的版本的jdbc和mybatis的话，逻辑变了。

<dependency>
	<groupId>org.mybatis</groupId>
	<artifactId>mybatis</artifactId>
	<version>3.4.6</version>
</dependency>
<dependency>
	<groupId>mysql</groupId>
	<artifactId>mysql-connector-java</artifactId>
	<version>8.0.20</version>
	<scope>runtime</scope>
</dependency>

简单给个截图，感兴趣的朋友可以根据博主的断点走以下流程，看看jdbc+mybatis去解析Date和LocalDateTime类型数据有什么变化，或者等博主有时间了补上
1.ConnectionImpl.prepareStatement(String sql, int resultSetType, int resultSetConcurrency)–从这里开始断点，可以看到查询使用的sql

2.PreparedStatementHandler.query(Statement statement, ResultHandler resultHandler)–从这里断点，可以看到查询完成，并且开始处理结果的入口

3.DefaultResultSetHandler.getPropertyMappingValue(ResultSet rs, MetaObject metaResultObject, ResultMapping propertyMapping, ResultLoaderMap lazyLoader, String columnPrefix)-- 从这里断点,可以看到调用typeHandler对应的类型处理器去处理列的数据，比如LocalDateTimeTypeHandler和DateTypeHandler

4.AbstractResultsetRow.decodeAndCreateReturnValue(int columnIndex, byte[] bytes, int offset, int length, ValueFactory vf)–从这里断点，可以看到开始选择适合valueDecoder来解析从数据库返回的数据并转换成对应的java类型

5.SqlTimestampValueFactory.localCreateFromTimestamp(InternalTimestamp its)–从这里断点，可以看到这是最终生成Date类型数据的地方，会将数据库中的时间InternalTimestamp加上serverZoneId转换成一个服务器对应时区的时间对象TimeStamp,然后再将TimeStamp转换成Date对象。

大概变化就是：mybatis 3.4.6 + jdbc 8.0.20的话LocalDateTime和Date类型的数据处理器TypeHandler都只会调用jdbc 8.0.20 的SqlTimestampValueFactory.localCreateFromTimestamp(InternalTimestamp its)方法生成一个TimeStamp类型数据，然后mybatis再根据这个数据转换成相应的Date和LocalDateTime类型数据，因为TimeStamp类型数据的生成时需要依赖serverTimezone的，所以mybatis 3.4.6这个版本的LocalDateTime和Date类型的数据处理都会被serverTimezone所影响
如下图所示：

mybatis 3.4.6 和3.5.7版本的比较：

1. 在mybatis 3.5.7版本中处理LocalDateTime类型数据不会受serverTimezone影响，但是Date类型的数据会。

2. 在mybatis 3.4.6这个版本的LocalDateTime和Date类型的数据处理都会被serverTimezone所影响