MyBatis 配置 typeHandlers 详解_mybatis type-handler-package

public void setParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType)
public String getResult(ResultSet rs,String columnName)
public String getResult(ResultSet rs,int columnIndex)
public String getResult(CallableStatement cs,int columnIndex)
1
2
3
4

setParameter 方法是在 sql 配置传入参数时（新增、删除、修改、查询）执行的操作，可以在将参数传入数据库之前在该方法中对数据类型做处理。

另外三个 getResult 方法则在数据库返回结果时，将结果信息转换为相应的 Java 类型。区别在于前两个 getResult 方法供普通 select 方法使用，一个根据字段名，一个根据字段下标来获取数据，最后一个 getResult 方法供存储过程使用，根据字段下标获取数据。

0x03：代码示例

以下代码是编写一个将 JDBC 的 timestamp 类型与 Date 类型相互转换的类型处理器配置示例：

package cn.com.mybatis.test;
 
import java.sql.CallableStatement;
import java.sql.Date;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.text.SimpleDateFormat;
import org.apache.ibatis.type.TypeHandler;
import org.apache.ibatis.type.JdbcType;
 
public class DateTypeHandler implements TypeHandler<Date> {
 
    //转换日期类型的辅助类
    SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
    public void setParameter(PreparedStatement ps, int i, Date parameter, JdbcType jdbcType) throws SQLException{
        //指定传入的Java参数对应JDBC中的数据库类型
        System.out.println("其他逻辑");
        ps.setDate(i, parameter);
        System.out.println("其他逻辑");
    }
    public Date getResult(ResultSet rs,String columnName) throws SQLException{
        System.out.println("其他逻辑");
        return rs.getDate(columnName);
    }
    public Date getResult(ResultSet rs,int columnIndex) throws SQLException{
        System.out.println("其他逻辑");
        return rs.getDate(columnIndex);
    }
    public Date getResult(CallableStatement cs,int columnIndex) throws SQLException{
        System.out.println("其他逻辑");
        return cs.getDate(columnIndex);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

之后在 MyBatis 的全局配置文件 SqlMapConfig 中使用 typeHandlers 标签来注册类型处理器，示例代码如下：

 <typeHandlers>
    <typeHandler handler="cn.com.mybatis.test.DateTypeHandler" javaType="java.util.Date" jdbcType="TIMESTAMP"/>
</typeHandlers>
1
2
3

然后在 sql 映射文件 xxxMapper.xml 中的 sql 语句中添加自定义的类型处理器的处理配置即可，代码示例如下：

insert into user(username,password,regdate) value(#{username},#{password},
    #{regdate,javaType=date,jdbcType=TIMESTAMP,
    typeHandler=cn.com.mybatis.test.DateTypeHandler})
1
2
3

如果设置了参数 regdate，就会将 Java 的 Date 类型转换为数据库需要的 timestamp 类型。另外，对于查询结果，如果定义了 resultMap 来设置结果集对象的映射，同样可以在标签内指定 javaType，jdbcType 和 typeHandler 的名称。

0x04：知识拓展

在编写自定义的类型处理器时，可以不实现 TypeHandler 接口，转而继承另一个类 org.apache.ibatis.type.BaseTypeHandler, 它是 MyBatis 的一个标准基础类型处理器类。

BaseTypeHandler 本身已经实现了 TypeHandler 接口，并继承了 TypeReferance 抽象类，在它内部简单的实现了 TypeHandler 接口中定义的四个方法的部分功能。

继承 BaseTypeHandler 类之后，可以通过改写 setNonNullParameter、getNullableResult 方法（三个）来实现类型处理器。示例代码如下：

public abstract void setNonNullParameter(PreparedStatement ps,int i,T parameter,JdbcType jdbcType)
public abstract T getNullableResult(ResultSet rs,String columnName)
public abstract T getNullableResult(ResultSet rs,int columnIndex)
public abstract T getNullableResult(CallableStatement cs,int columnIndex)
1
2
3
4

因为 BaseTypeHandler 继承 TypeReferance 抽象类，所以它本身也是一个抽象类，类中的 4 个方法也为抽象方法。

0x05：总结

MyBatis 中，其内部的类型处理器大部分都是继承上面的 4 个方法来实现的，当其内部的类型处理器无法满足开发需求时，就需要自己定义类型处理类，步骤为先编写类型处理器类，其次将该处理器类配置到全局配置文件中，最后在 sql 映射配置文件中使用即可。