精尽 MyBatis 源码分析 —— 类型模块

作者简介：大家好，我是smart哥，前中兴通讯、美团架构师，现某互联网公司CTO

联系qq：184480602，加我进群，大家一起学习，一起进步，一起对抗互联网寒冬

学习必须往深处挖，挖的越深，基础越扎实！

阶段1、深入多线程

阶段2、深入多线程设计模式

阶段3、深入juc源码解析

阶段4、深入jdk其余源码解析

阶段5、深入jvm源码解析

码哥源码部分

码哥讲源码-原理源码篇【2024年最新大厂关于线程池使用的场景题】

码哥讲源码【炸雷啦！炸雷啦！黄光头他终于跑路啦！】

码哥讲源码-【jvm课程前置知识及c/c++调试环境搭建】

​​​​​​码哥讲源码-原理源码篇【揭秘join方法的唤醒本质上决定于jvm的底层析构函数】

码哥源码-原理源码篇【Doug Lea为什么要将成员变量赋值给局部变量后再操作？】

码哥讲源码【你水不是你的错,但是你胡说八道就是你不对了！】

码哥讲源码【谁再说Spring不支持多线程事务，你给我抽他！】

终结B站没人能讲清楚红黑树的历史，不服等你来踢馆！

打脸系列【020-3小时讲解MESI协议和volatile之间的关系，那些将x86下的验证结果当作最终结果的水货们请闭嘴】

1. 概述

① MyBatis 为简化配置文件提供了别名机制，该机制是类型转换模块的主要功能之一。

② 类型转换模块的另一个功能是实现 JDBC 类型与 Java 类型之间的转换，该功能在为 SQL 语句绑定实参以及映射查询结果集时都会涉及：

在为 SQL 语句绑定实参时，会将数据由 Java 类型转换成 JDBC 类型。
而在映射结果集时，会将数据由 JDBC 类型转换成 Java 类型

2. TypeHandler

org.apache.ibatis.type.TypeHandler ，类型转换处理器。代码如下：

    public interface TypeHandler<T> {
    
        /**
         * 设置 PreparedStatement 的指定参数
         *
         * Java Type => JDBC Type
         *
         * @param ps PreparedStatement 对象
         * @param i 参数占位符的位置
         * @param parameter 参数
         * @param jdbcType JDBC 类型
         * @throws SQLException 当发生 SQL 异常时
         */
        void setParameter(PreparedStatement ps, int i, T parameter, JdbcType jdbcType) throws SQLException;
    
        /**
         * 获得 ResultSet 的指定字段的值
         *
         * JDBC Type => Java Type
         *
         * @param rs ResultSet 对象
         * @param columnName 字段名
         * @return 值
         * @throws SQLException 当发生 SQL 异常时
         */
        T getResult(ResultSet rs, String columnName) throws SQLException;
    
        /**
         * 获得 ResultSet 的指定字段的值
         *
         * JDBC Type => Java Type
         *
         * @param rs ResultSet 对象
         * @param columnIndex 字段位置
         * @return 值
         * @throws SQLException 当发生 SQL 异常时
         */
        T getResult(ResultSet rs, int columnIndex) throws SQLException;
    
        /**
         * 获得 CallableStatement 的指定字段的值
         *
         * JDBC Type => Java Type
         *
         * @param cs CallableStatement 对象，支持调用存储过程
         * @param columnIndex 字段位置
         * @return 值
         * @throws SQLException
         */
        T getResult(CallableStatement cs, int columnIndex) throws SQLException;
    }

一共有两类方法，分别是：
#setParameter(…) 方法，是 Java Type => JDBC Type 的过程。
#getResult(…) 方法，是 JDBC Type => Java Type 的过程。

左边是 #setParameter(…) 方法，是 Java Type => JDBC Type 的过程，从上往下看。
右边是 #getResult(…) 方法，是 JDBC Type => Java Type 的过程，从下往上看。

2.1 BaseTypeHandler

org.apache.ibatis.type.BaseTypeHandler ，实现 TypeHandler 接口，继承 TypeReference 抽象类，TypeHandler 基础抽象类。

2.1.1 setParameter

setParameter(PreparedStatement ps, int i, T parameter, JdbcType jdbcType) 方法，代码如下：

    @Override
    public void setParameter(PreparedStatement ps, int i, T parameter, JdbcType jdbcType) throws SQLException {
        // <1> 参数为空时，设置为 null 类型
        if (parameter =