Mybatis 系列5-结合源码解析TypeHandler

【Mybatis 系列10-结合源码解析mybatis 执行流程】

【Mybatis 系列9-强大的动态sql 语句】

【Mybatis 系列8-结合源码解析select、resultMap的用法】 

【Mybatis 系列7-结合源码解析核心CRUD配置及用法】

【Mybatis 系列6-结合源码解析节点配置objectFactory、databaseIdProvider、plugins、mappers】

【Mybatis 系列5-结合源码解析TypeHandler】 

【Mybatis 系列4-结合源码解析节点typeAliases】

【Mybatis 系列3-结合源码解析properties节点和environments节点】

【Mybatis 系列2-配置文件】

【Mybatis 系列1-环境搭建】

 

 

上篇系列4中 为大家介绍了mybatis中别名的使用，以及其源码。本篇将为大家介绍TypeHandler， 并简单分析其源码。

Mybatis中的TypeHandler是什么？

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

那么，Mybatis为我们实现了哪些TypeHandler呢? 我们怎么自定义实现一个TypeHandler ?

这些都会在接下来的mybatis的源码中看到。

 

在看源码之前，先看看怎么配置吧？

 

配置TypeHandler:

 1 
 2     
 3       
 7       
 8       
 9       
10       
11       
12       
13       
14       
15       
16       
17       
18       
19       
20   
21   
22   ......
23   
24 

 

上面简单介绍了一下TypeHandler, 下面就看看mybatis中TypeHandler的源码了。

=我是源码分割线==

老规矩，先从对xml的解析讲起：

 1 /**
 2  * 解析typeHandlers节点
 3  */
 4 private void typeHandlerElement(XNode parent) throws Exception {
 5     if (parent != null) {
 6       for (XNode child : parent.getChildren()) {
 7         //子节点为package时，获取其name属性的值，然后自动扫描package下的自定义typeHandler
 8         if ("package".equals(child.getName())) {
 9           String typeHandlerPackage = child.getStringAttribute("name");
10           typeHandlerRegistry.register(typeHandlerPackage);
11         } else {
12           //子节点为typeHandler时， 可以指定javaType属性， 也可以指定jdbcType, 也可两者都指定
13           //javaType 是指定java类型
14           //jdbcType 是指定jdbc类型（数据库类型： 如varchar）
15           String javaTypeName = child.getStringAttribute("javaType");
16           String jdbcTypeName = child.getStringAttribute("jdbcType");
17           //handler就是我们配置的typeHandler
18           String handlerTypeName = child.getStringAttribute("handler");
19           //resolveClass方法就是我们上篇文章所讲的TypeAliasRegistry里面处理别名的方法
20           Class javaTypeClass = resolveClass(javaTypeName);
21           //JdbcType是一个枚举类型，resolveJdbcType方法是在获取枚举类型的值
22           JdbcType jdbcType = resolveJdbcType(jdbcTypeName);
23           Class typeHandlerClass = resolveClass(handlerTypeName);
24           //注册typeHandler, typeHandler通过TypeHandlerRegistry这个类管理
25           if (javaTypeClass != null) {
26             if (jdbcType == null) {
27               typeHandlerRegistry.register(javaTypeClass, typeHandlerClass);
28             } else {
29               typeHandlerRegistry.register(javaTypeClass, jdbcType, typeHandlerClass);
30             }
31           } else {
32             typeHandlerRegistry.register(typeHandlerClass);
33           }
34         }
35       }
36     }
37 }

 

接下来看看TypeHandler的管理注册类：

TypeHandlerRegistry：

  1 /**
  2  * typeHandler注册管理类
  3  */
  4 public final class TypeHandlerRegistry {
  5 
  6   //源码一上来，二话不说，几个大大的HashMap就出现，这不又跟上次讲的typeAliases的注册类似么
  7 
  8   //基本数据类型与其包装类
  9   private static final Map, Class> reversePrimitiveMap = new HashMap, Class>() {
 10     private static final long serialVersionUID = 1L;
 11     {
 12       put(Byte.class, byte.class);
 13       put(Short.class, short.class);
 14       put(Integer.class, int.class);
 15       put(Long.class, long.class);
 16       put(Float.class, float.class);
 17       put(Double.class, double.class);
 18       put(Boolean.class, boolean.class);
 19       put(Character.class, char.class);
 20     }
 21   };
 22 
 23   //这几个MAP不用说就知道存的是什么东西吧，命名的好处
 24   private final Map> JDBC_TYPE_HANDLER_MAP = new EnumMap>(JdbcType.class);
 25   private final Map>> TYPE_HANDLER_MAP = new HashMap>>();
 26   private final TypeHandler