13、类型转换（TypeHandler）介绍

Mybatis中的TypeHandler是什么

无论是 MyBatis 在预处理语句（PreparedStatement）中设置一个参数时，还是从结果集中取出一个值时，都会用类型处理器将获取的值以合适的方式转换成 Java 类型。Mybatis默认为我们实现了许多TypeHandler, 当我们没有配置指定TypeHandler时，Mybatis会根据参数或者返回结果的不同，默认为我们选择合适的TypeHandler处理。

如果你使用JSR-310(Date和Time API)，你可以使用mybatis-typehandlers-jsr310

配置TypeHandler

 <typeHandlers>
   
        
        
        <typeHandler handler=""/>

        
        <typeHandler javaType="" handler=""/>

        
        <typeHandler jdbcType="" handler=""/>

        
        <typeHandler javaType="" jdbcType="" handler=""/>
 typeHandlers>

mybatis实现的类型转换

类型处理器	Java 类型	JDBC 类型
BooleanTypeHandler	java.lang.Boolean, boolean	数据库兼容的 BOOLEAN
ByteTypeHandler	java.lang.Byte, byte	数据库兼容的 NUMERIC 或 BYTE
ShortTypeHandler	java.lang.Short, short	数据库兼容的 NUMERIC 或 SHORT INTEGER
IntegerTypeHandler java.lang.Integer, int	数据库兼容的 NUMERIC 或 INTEGER
LongTypeHandler	java.lang.Long, long	数据库兼容的 NUMERIC 或 LONG INTEGER
FloatTypeHandler	java.lang.Float, float	数据库兼容的 NUMERIC 或 FLOAT
DoubleTypeHandler	java.lang.Double, double	数据库兼容的 NUMERIC 或 DOUBLE
BigDecimalTypeHandler	java.math.BigDecimal	数据库兼容的 NUMERIC 或 DECIMAL
StringTypeHandler	java.lang.String	CHAR, VARCHAR
ClobReaderTypeHandler	java.io.Reader	-
ClobTypeHandler	java.lang.String	CLOB, LONGVARCHAR
NStringTypeHandler	java.lang.String	NVARCHAR, NCHAR
NClobTypeHandler	java.lang.String	NCLOB
BlobInputStreamTypeHandler	java.io.InputStream	-
ByteArrayTypeHandler	byte[]	数据库兼容的字节流类型
BlobTypeHandler	byte[] BLOB,	LONGVARBINARY
DateTypeHandler	java.util.Date	TIMESTAMP
DateOnlyTypeHandler	java.util.Date	DATE
TimeOnlyTypeHandler	java.util.Date	TIME
SqlTimestampTypeHandler	java.sql.Timestamp	TIMESTAMP
SqlDateTypeHandler	java.sql.Date	DATE
SqlTimeTypeHandler	java.sql.Time	TIME
ObjectTypeHandler	Any OTHER	或未指定类型
EnumTypeHandler	Enumeration Type	VARCHAR-任何兼容的字符串类型，存储枚举的名称（而不是索引）
EnumOrdinalTypeHandler	Enumeration Type	任何兼容的 NUMERIC 或 DOUBLE 类型，存储枚举的索引（而不是名称）。

xml配置源码

private void typeHandlerElement(XNode parent) throws Exception {
       if (parent != null) {
             for (XNode child : parent.getChildren()) {
               //子节点为package时，获取其name属性的值，然后自动扫描package下的自定义typeHandler
               if ("package".equals(child.getName())) {
                 String typeHandlerPackage = child.getStringAttribute("name");
                 typeHandlerRegistry.register(typeHandlerPackage);
               } else {
                 //子节点为typeHandler时， 可以指定javaType属性， 也可以指定jdbcType, 也可两者都指定
                 //javaType 是指定java类型
                 //jdbcType 是指定jdbc类型（数据库类型： 如varchar）
                 String javaTypeName = child.getStringAttribute("javaType");
                 String jdbcTypeName = child.getStringAttribute("jdbcType");
                 //handler就是我们配置的typeHandler
                 String handlerTypeName = child.getStringAttribute("handler");
                 //resolveClass方法就是我们上篇文章所讲的TypeAliasRegistry里面处理别名的方法
                 Class javaTypeClass = resolveClass(javaTypeName);
                 //JdbcType是一个枚举类型，resolveJdbcType方法是在获取枚举类型的值
                 JdbcType jdbcType = resolveJdbcType(jdbcTypeName);
                 Class typeHandlerClass = resolveClass(handlerTypeName);
                 //注册typeHandler, typeHandler通过TypeHandlerRegistry这个类管理
                 if (javaTypeClass != null) {
                   if (jdbcType == null) {
                     typeHandlerRegistry.register(javaTypeClass, typeHandlerClass);
                   } else {
                     typeHandlerRegistry.register(javaTypeClass, jdbcType, typeHandlerClass);
                   }
                 } else {
                   typeHandlerRegistry.register(typeHandlerClass);
                 }
               }
             }
           }
    }

TypeHandler的管理注册类

package org.apache.ibatis.type;

import org.apache.ibatis.io.ResolverUtil;
import org.apache.ibatis.io.Resources;

import java.io.InputStream;
import java.io.Reader;
import java.lang.reflect.Constructor;
import java.lang.reflect.Modifier;
import java.lang.reflect.Type;
import java.math.BigDecimal;
import java.math.BigInteger;
import java.util.*;
import java.util.concurrent.ConcurrentHashMap;

/**
 * @author Clinton Begin
 * @author Kazuki Shimizu
 */
public final class TypeHandlerRegistry {
    private static final Map> NULL_TYPE_HANDLER_MAP = new HashMap>();

    //保存Mybatis内部提供的枚举JdbcType类型和对应的TypeHandler
    private final Map> JDBC_TYPE_HANDLER_MAP = new EnumMap>(JdbcType.class);

    //javaType的Class类型(Type是Class的接口)，value是一个Map集合（比如String，可能对应数据库的clob、char、varchar等，所以是一对多关系）
    private final Map>> TYPE_HANDLER_MAP = new ConcurrentHashMap>>();

    //处理Object类型（运行时，会尝试进行向下类型转换找到合适的TypeHandler，如果依然失败，最后选择ObjectTypeHandler）
    private final TypeHandler