MyBatis-Plus通过注解使用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-typehandler

• JSON 字段类型

@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 中写法为

<result column="other_info" jdbcType="VARCHAR" property="otherInfo" typeHandler="com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler" />

---

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

Kotlin案例

首先是kotlin实体类：

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

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

class PolicyBodyTypeHandler : BaseTypeHandler<PolicyBody>() {
    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中的使用：

    <resultMap id="BaseResultMap" type="com.inooy.write.ucenter.entity.Policy">
        <id column="id" property="id" />
        <result column="code" property="code" />
        <result column="name" property="name" />
        <result column="description" property="description" />
        <result column="content" property="content" typeHandler="com.inooy.write.ucenter.policy.PolicyBodyTypeHandler"/>
        <result column="deleted" property="deleted" />
        <result column="createTime" property="createTime" />
        <result column="updateTime" property="updateTime" />
        <result column="version" property="version" />
    resultMap>

参考链接：

https://baomidou.com/guide/typehandler.html