【MyBatis学习16】自定义类型处理器typeHandlers介绍

本文博客地址：http://blog.csdn.net/soonfly/article/details/65628372 （转载请注明出处）
我们在写mapper映射器的配置文件时，不经意间已经用到类型转换，不过是mybatis帮我们完成的。

<update id="update" parameterType="twm.mybatisdemo.pojo.User">    update user set    username=#{username},password=#{password},address=#{address}  where id=#{id}</update>

像上面例子，只需要向update方法传入一个user对象，mybatis利用反射拆开user对象，然后根据对象中的字段在预处理语句（PreparedStatement）中设置参数，并且根据字段的类型，使用setXXX()方式设置相应的值。XXX可以是Integer，String，Date等Java类型。
同理，在从结果集（ResultSet）中取出一个值时，将使用rs.getInt、rs.getString、rs.getTimeStamp等方法将数据转换为Java对象。

那么问题来了，javaType和jdbcType的转换关系由谁来定呢？这就是类型处理器（type handlers）的功能所在。
比如java.lang.String转成JDBC.Varchar，java.lang.Integer转成JDBC.int。MyBatis使用内建的类型处理器能转换所有的基本数据类型、基本类型的包装类型、byte[] 、java.util.Date、java.sql.Date、java,sql.Time、java.sql.Timestamp、java枚举类型等。

不过对于自定义的类型怎么办呢？
假设上面的address在数据库字段类型是varchar(50)，但是在JAVA twm.mybatisdemo.pojo.User类中的address字段并不是String类型，而是一个自定义的Address类型：

public class Address {    String province;    String city;    public Address() {}    public Address(String province, String city) {        this.province = province;        this.city = city;    }    //getter and setter......}

碰到这种情况，mybatis基本懵逼了。。。
如果运行的话就报错误：

Type handler was null on parameter mapping for property ‘address’. It
was either not specified and/or could not be found for the javaType /
jdbcType combination specified.

address字段需要传递给#{address}，而address字段是Address类型的，MyBatis并不知道该怎样来处理这个类型的对象。
因此，需要创建一个自定义的类型处理器(TypeHandler)了

1、创建类型处理器：

class AddressTypeHandler extends BaseTypeHandler<Address>{}

通过ide自动生成代码，可以看到父类BaseTypeHandler有四个方法需要我们实现，包括三个get方法，一个set方法。

2、实现get方法
三个get方法都是用于将数据库获得的记录集里的address字段转成java Address类型的对象。
所以我们首先给Address类增加一个构造方法，用途：根据字符串生成一个实例对象。

//假设我们存储在db中的字符串是以","号分隔省市关系的public Address(String address) {      if (address != null) {          String[] segments = address.split(",");          if (segments.length > 1) {              this.province = segments[0];            this.city = segments[1];          }         else if (segments.length > 0) {              this.city = segments[0];          }      }  }

然后实现AddressTypeHandler类中的三个get方法：（有强迫症，不喜欢看arg0，arg1。所以顺便也改一下）

@Overridepublic Address getNullableResult(ResultSet rSet, String columnName)        throws SQLException {    return new Address(rSet.getString(columnName));}@Overridepublic Address getNullableResult(ResultSet rSet, int columnIndex)        throws SQLException {    return new Address(rSet.getString(columnIndex));}@Overridepublic Address getNullableResult(CallableStatement cStatement, int columnIndex)        throws SQLException {    return new Address(cStatement.getString(columnIndex));}

3、实现set方法

set方法是用来将java类型转成数据库存储的类型。
这里我们先实现一下Address类的toString()方法（如果toString另有它用，那么就另外用一个方法名）

@Overridepublic String toString() {    return this.province + "," + this.city;}

然后实现AddressTypeHandler类中的setNonNullParameter

@Overridepublic void setNonNullParameter(PreparedStatement pStatement, int index,        Address address, JdbcType jdbcType) throws SQLException {    pStatement.setString(index, address.toString());}

4、在myBatis配置文件中注册该类

<!-- 注册自定义类型处理器 --><typeHandlers>    <typeHandler handler="twm.mybatisdemo.type.AddressTypeHandler" /></typeHandlers>

这里有个小插曲，我当时在配置文件最后插入了这段，结果提示错误：

The content of element type “configuration” must match
“(properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,reflectorFactory?,plugins?,environments?,databaseIdProvider?,mappers?)”.

原来在configuration里的标签，必须按照提示的这个顺序写，不然就报错。
因此typeHandlers必须放在environments前面，typeAliases后面。
回顾一下，是不是感觉跟序列化/反序列化这套路很相似？

本文博客地址：http://blog.csdn.net/soonfly/article/details/65628372 （转载请注明出处）