Mybatis之类型处理器

前言

上文Mybatis之XML如何映射到方法中讲到了类型处理器，分别用在两个地方设置参数到数据库和从结果集中取出数据，根据不同的数据类型从类型注册器里面获取具体的类型处理器，分别进行处理；本文将重点介绍一下类型处理器，注册器，如何处理数据以及如何扩展。

类型处理器

类型处理器Mybatis提供了接口TypeHandler，并且Mybatis实现了主流数据库支持类型的处理器实现，具体有哪些类型如下所示：

处理器	java类型	数据库类型
BooleanTypeHandler	Boolean,boolean	BOOLEAN,BIT
ByteTypeHandler	Byte,byte	TINYINT
ShortTypeHandler	Short,short	SMALLINT
IntegerTypeHandler	Integer,int	INTEGER
LongTypeHandler	Long,long	BIGINT
FloatTypeHandler	Float,float	FLOAT
DoubleTypeHandler	Double,double	DOUBLE
StringTypeHandler	String	CHAR,VARCHAR
ClobTypeHandler	String	CLOB,LONGVARCHAR
NStringTypeHandler	String	NVARCHAR,NCHAR
NClobTypeHandler	String	NCLOB
ArrayTypeHandler	Object	ARRAY
BigDecimalTypeHandler	BigDecimal	REAL,DECIMAL,NUMERIC
BlobTypeHandler	byte[]	BLOB,LONGVARBINARY
UnknownTypeHandler	Object	OTHER或者未指定类型
DateTypeHandler	Date	TIMESTAMP
DateOnlyTypeHandler	Date	DATE
TimeOnlyTypeHandler	Date	TIME
SqlDateTypeHandler	java.sql.Date	DATE
SqlTimeTypeHandler	java.sql.Time	TIME
SqlTimestampTypeHandler	java.sql.Timestamp	TIMESTAMP
EnumTypeHandler	枚举类	VARCHAR或兼容的字符串类型

上面所有的类型处理器都可以在TypeHandlerRegistry注册器中找到，再来看一下TypeHandler提供的接口方法：

public interface TypeHandler {

  void setParameter(PreparedStatement ps, int i, T parameter, JdbcType jdbcType) throws SQLException;

  T getResult(ResultSet rs, String columnName) throws SQLException;

  T getResult(ResultSet rs, int columnIndex) throws SQLException;

  T getResult(CallableStatement cs, int columnIndex) throws SQLException;

}

四个方法分别表示：setParameter用来设置写入数据库的参数，getResult用来处理结果集和存储过程，可以通过字段名称和下标来处理；以上处理器并没有直接实现TypeHandler，而是继承于公共的BaseTypeHandler，以StringTypeHandler为例只需要实现很简单的操作：

  @Override
  public void setNonNullParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType)
      throws SQLException {
    ps.setString(i, parameter);
  }

  @Override
  public String getNullableResult(ResultSet rs, String columnName)
      throws SQLException {
    return rs.getString(columnName);
  }

  @Override
  public String getNullableResult(ResultSet rs, int columnIndex)
      throws SQLException {
    return rs.getString(columnIndex);
  }

  @Override
  public String getNullableResult(CallableStatement cs, int columnIndex)
      throws SQLException {
    return cs.getString(columnIndex);
  }

分别表示往PreparedStatement中设置字符串参数，从ResultSet获取指定字段名称或者下标的字符串数据，以及从存储过程中获取指定下标字符串数据。

处理器注册器

所有处理器在启动的时候都注册到了TypeHandlerRegistry中，需要根据javaType或者jdbcType获取处理器时直接在注册器中获取即可，注册器中保存了相关的对应关系如下所示：

  private final Map> JDBC_TYPE_HANDLER_MAP;
  private final Map>> TYPE_HANDLER_MAP;
  private final TypeHandler