MyBatis-Plus如何通过注解使用TypeHandler

目录

• 通过注解使用TypeHandler
• 官方示例
• Kotlin案例
• 自定义TypeHandler使用

通过注解使用TypeHandler

在使用MyBatis时，我们与数据表中字段映射的java中的bean的属性字段，往往包含了自定义复杂类型，比如一个varchar保存的json字符串映射到的java字段是Person类型的时候，就需要用到 “字段类型处理器了”，也就是TypeHandler.

使用MyBatis的TypeHandler的时候，自定义实现起来还是比较麻烦，需要统一配置，自动识别java字段类型，然后匹配了才处理。

这样在开发的时候并不好控制，而且不是很直观。

在新版本的MyBatis-Plus中提供了一种新的配置 “字段处理器” 的方法，通过在javaBean中加入对应的注解即可实现。

下面我们先看一下MyBatis-Plus官方文档中的使用说明：

官方示例

类型处理器，用于 JavaType 与 JdbcType 之间的转换，用于 PreparedStatement 设置参数值和从 ResultSet 或 CallableStatement 中取出一个值，本文讲解 mybaits-plus 内置常用类型处理器如何通过TableField注解快速注入到 mybatis 容器中。

示例工程：

mybatis-plus-sample-typehandlerJSON 字段类型 

@Data
@Accessors(chain = true)
@TableName(autoResultMap = true)
public class User {
    private Long id;
    ...
    /**
     * 注意！！ 必须开启映射注解
     *
     * @TableName(autoResultMap = true)
     *
     * 以下两种类型处理器，二选一 也可以同时存在
     *
     * 注意！！选择对应的 JSON 处理器也必须存在对应 JSON 解析依赖包
     */
    @TableField(typeHandler = JacksonTypeHandler.class)
    // @TableField(typeHandler = FastjsonTypeHandler.class)
    private OtherInfo otherInfo;
}

该注解对应了 XML 中写法为

下面我们参照官方给出的案例，用kotlin实现一个具体的：

Kotlin案例

首先是kotlin实体类：

@TableName(autoResultMap = true)
data class Policy  (
    ...
    /**
     * 策略内容，json格式，规则参考文档
     */
    @TableField(typeHandler = PolicyBodyTypeHandler::class)
    var content: PolicyBody? = null,
    ...
)

然后是对应TypeHandler的实现，主要就是json序列化规则，因为我们再数据库存的就是json字符串。

class PolicyBodyTypeHandler : BaseTypeHandler() {
    override fun getNullableResult(p0: ResultSet?, p1: String?): PolicyBody? {
        val result = p0?.getString(p1) ?: return null
        return JSON.parseObject(result, PolicyBody::class.java)
    }
    override fun getNullableResult(p0: ResultSet?, p1: Int): PolicyBody? {
        val result = p0?.getString(p1) ?: return null
        return JSON.parseObject(result, PolicyBody::class.java)
    }
    override fun getNullableResult(p0: CallableStatement?, p1: Int): PolicyBody? {
        val result = p0?.getString(p1) ?: return null
        return JSON.parseObject(result, PolicyBody::class.java)
    }
    override fun setNonNullParameter(statement: PreparedStatement?, index: Int, javaObj: PolicyBody?, jdbcType: JdbcType?) {
        statement?.setString(index, JSON.toJSONString(javaObj))
    }
}

下面是xml中的使用：

自定义TypeHandler使用

可通过自定义的TypeHandler实现某个属性在插入数据库以及查询时的自动转换，本例中是要将Map类型的属性转化成CLOB，然后存入数据库。由于是复杂的Map，mp自带的json转换器会丢失部分信息。

类型转换器还可以通过注解配置 java 类型和 jdbc 类型：

• @MappedTypes：注解配置 java 类型
• @MappedJdbcTypes：注解配置 jdbc 类型

定义：

@Slf4j
@MappedTypes({Object.class})
@MappedJdbcTypes(JdbcType.VARCHAR)
public class WeightListTypeHandler  extends AbstractJsonTypeHandler