Mybatis之TypeHandler使用教程

引言
MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。

1、typeHandles的基础知识

TypeHandler 在 MyBatis 中是一个用于处理 Java 类型和数据库类型之间映射转换的接口。简而言之，它负责：

1. Java到数据库的映射：在执行 SQL 语句时，TypeHandler 将 Java 类型转换为数据库可以理解的类型。

2. 数据库到Java的映射：在读取数据库结果时，TypeHandler 将数据库类型转换回 Java 类型。

2、场景复现

首先建立了一个t_user表存储用户信息，这个表中有一栏favorites是记录个人爱好的，爱好包括篮球、足球、排球：

在Java的User对象对应的是一个String类型的List，而在数据库中是用分号分隔的字符表示，比如：”basketball;football;volleyball”,
所以我们需要创建一个继承了BaseTypeHandler的类（BaseTypeHandler实现了TypeHandler接口,使用BaseTypeHandler更简单）,
@MappedTypes定义需要被拦截的java类型 @MappedJdbcTypes配置jdbc类型,这里的JdbcType必须org.apache.ibatis.type.JdbcType中的枚举类型,
然后还需要实现BaseTypeHandler抽象类中一系列的get set方法,具体实现的代码如下:

@MappedJdbcTypes(JdbcType.VARCHAR)
@MappedTypes(List.class)
public class ListVarcharTypeHandler extends BaseTypeHandler> {
 @Override
    public void setNonNullParameter(PreparedStatement ps, int i, List list, JdbcType jdbcType) throws SQLException {
        System.out.println("setNonNullParameter ...... "); //a,b,c,d
        //处理数据 将List转换为特定格式的字符串
        StringBuffer sb = new StringBuffer();
        String msg = null;
        if(list != null){
            for(String p : list){
                sb.append(p).append(";");
            }
            msg = sb.toString();
            msg = msg.substring(0,msg.length()-1);
        }
        ps.setString(i,msg);
    }

    /**
     * 获取非空的结果集
     * @param rs
     * @param columnName
     * @return
     * @throws SQLException
     */
    @Override
    public List getNullableResult(ResultSet rs, String columnName) throws SQLException {
        System.out.println(111);
        System.out.println( Arrays.asList(rs.getString(columnName).split(";")));
        return Arrays.asList(rs.getString(columnName).split(";"));
    }

    @Override
    public List getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
        System.out.println(222);
        return Arrays.asList(rs.getString(columnIndex).split(";"));
    }

    @Override
    public List getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
        System.out.println(333);
        return Arrays.asList(cs.getString(columnIndex).split(";"));
    }
}

创建完类后，我们还需要配置xml文件，一个是映射文件，一个mybatis配置文件：

...
    
    
...

...
    
    
        insert into t_user (id,username,address,gender,favorites)values(#{id},#{username},#{address},#{gender},#{favorites,typeHandler=com.doing.typehandle.ListVarcharTypeHandler})
    
        select * from t_user
    
        select * from t_user where id = #{id};
    
...

在配置完成之后，点击运行：

3、总结

TypeHandler是一个用于处理 Java 类型和数据库类型之间映射转换的接口，BaseTypeHandler是实现了TypeHandler接口的抽象类，
使用BaseTypeHandler能够处理数据库数据结构和bean对象数据类型之间的转换。