在Mybatis-Plus中指定TypeHandler后不生效的问题与解决办法

本文探讨了在Mybatis-Plus中为字段指定TypeHandler后仅在插入时生效的问题及解决方案。通过设置@TableName的autoResultMap属性为true来确保TypeHandler在更新和查询时也生效。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

文章首发于个人博客,欢迎访问关注:https://www.lin2j.tech

问题:

Mybatis-Plus 中为字段指定 TypeHandler 之后,TypeHandler 只在插入时生效,更新或者查询时未生效。

/**
* 设备IP
*/
@TableField(value = "IP", typeHandler = IpTypeHandler.class, jdbcType = JdbcType.INTEGER)
private String ip;

IpTypeHandler 是一个将 32 位无符号数转换为字符串(或者反过来)的处理器。

经过如此指定之后,在插入时,表现正常,查询时则查出来一个无符号数。

解决办法:

@TableName 中指定 autoResultMaptrue

/**
 * 是否自动构建 resultMap 并使用,
 * 只生效与 mp 自动注入的 method,
 * 如果设置 resultMap 则不会进行 resultMap 的自动构建并注入,
 * 只适合个别字段 设置了 typeHandler 或 jdbcType 的情况
 *
 * @since 3.1.2
 */
boolean autoResultMap() default false;

注意点:

上述问题出现,还有另一个要点就是,我是直接调用 Mybatis-Plus 的方法,并没有在 xxxMapper.xml 文件中书写 SQL 语句。如果是自己写 SQL 语句,则需要指定 resultMap,并在对应列指定 TypeHandler

<result column="IP" jdbcType="INTEGER" property="ip" typeHandler="com.suntek.vias.portal.typehandler.IpTypeHandler"/>
### MyBatis-Plus 中 Long 和 String 类型匹配解决方案 在 MyBatis-Plus 的实际开发过程中,可能会遇到 Java 属性类型数据库字段类型不一致的情况。例如,在实体类中定义了一个 `Long` 类型的属性,而对应的数据库字段却是 `VARCHAR` 或者其他字符串类型的列。这种情况下可以通过自定义注解或者配置来解决类型匹配问题。 #### 方法一:通过 `@TableField` 注解指定映射关系 当 Java 属性名数据库字段名称不同步时,可以使用 `@TableField` 注解显式声明两者之间的对应关系[^4]。即使两者的数据类型存在差异,也可以通过该方式完成基本的映射操作。 ```java public class User { @TableId(type = IdType.ASSIGN_ID) private Long id; @TableField("user_code") // 数据库中的字段名为 user_code (String 类型) private Long userCode; // Getter and Setter methods... } ``` 上述代码片段展示了如何将数据库表中的 `user_code` 字段(假设其为 `VARCHAR` 类型)映射到 Java 实体类中的 `Long` 类型属性上。需要注意的是,这种方式仅适用于简单的场景,对于复杂的转换需求可能不够灵活。 --- #### 方法二:利用 TypeHandler 自定义类型处理器 为了更精确地控制不同类型间的转换过程,MyBatis 提供了 **TypeHandler** 功能。开发者可以根据业务逻辑编写特定的类型处理程序,从而实现从数据库读取数据时自动完成由 `String -> Long` 转换的过程以及保存数据前执行反向变换的任务。 下面是一个具体的例子: 1. 创建一个继承自 `BaseTypeHandler<Long>` 的类作为自定义类型处理器。 ```java import org.apache.ibatis.type.BaseTypeHandler; import org.apache.ibatis.type.JdbcType; import java.sql.CallableStatement; import java.sql.PreparedStatement; import java.sql.ResultSet; import java.sql.SQLException; public class LongToStringTypeHandler extends BaseTypeHandler<Long> { @Override public void setNonNullParameter(PreparedStatement ps, int i, Long parameter, JdbcType jdbcType) throws SQLException { ps.setString(i, parameter.toString()); } @Override public Long getNullableResult(ResultSet rs, String columnName) throws SQLException { String value = rs.getString(columnName); return null == value ? null : Long.parseLong(value); } @Override public Long getNullableResult(ResultSet rs, int columnIndex) throws SQLException { String value = rs.getString(columnIndex); return null == value ? null : Long.parseLong(value); } @Override public Long getNullableResult(CallableStatement cs, int columnIndex) throws SQLException { String value = cs.getString(columnIndex); return null == value ? null : Long.parseLong(value); } } ``` 2. 配置全局或局部注册此类型处理器。 如果希望在整个项目范围内生效,则需修改 MyBatis 的核心配置文件;如果是针对某个单独的字段应用,则可以直接在实体类里标注出来。 ```xml <!-- mybatis-config.xml --> <typeHandlers> <typeHandler handler="com.example.handler.LongToStringTypeHandler" javaType="long" jdbcType="VARCHAR"/> </typeHandlers> ``` 或者直接加在 Entity 上面: ```java public class User { @TableId(type = IdType.ASSIGN_ID) private Long id; @TableField(typeHandler = LongToStringTypeHandler.class) private Long userCode; // Other fields & methods ... } ``` 这样就完成了对 `Long <-> String` 这种跨类型的数据交互的支持。 --- #### 注意事项 尽管以上两种方法都可以有效解决问题,但在设计之初应尽量保持双方的一致性以减少不必要的麻烦。另外值得注意的是,虽然理论上支持任意组合形式下的相互转化,但由于浮点数精度丢失等原因可能导致某些极端条件下无法完全还原原始数值,请务必谨慎对待此类情况[^3]。 ---
评论 16
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值