Mybatis中自定义TypeHandler处理枚举详解

发布时间 - 2026-01-10 23:10:19    点击率:

在Mybatis中,处理枚举类的TypeHandler有两个:

  • EnumTypeHandler: 用于保存枚举名
  • EnumOrdinalTypeHandler: 用于保存枚举的序号。

在实际项目中,以上往往不能满足我们的需求。

需求分析

枚举需要包含两个属性,label(用于显示), value(实际的枚举值)。数据库保存枚举值(value)。

这很明显Mybatis提供的两个枚举TypeHandler不能满足我们的需求。此时,我们可以自定义一个通用的枚举TypeHandler来满足我们的需求。

自定义枚举TypeHandler

通用枚举DisplayedEnum

public interface DisplayedEnum {
 String DEFAULT_VALUE_NAME = "value";
 String DEFAULT_LABEL_NAME = "label";
 default Integer getValue() {
 Field field = ReflectionUtils.findField(this.getClass(), DEFAULT_VALUE_NAME);
 if (field == null)
  return null;
 try {
  field.setAccessible(true);
  return Integer.parseInt(field.get(this).toString());
 } catch (IllegalAccessException e) {
  throw new RuntimeException(e);
 }
 }
 @JsonValue
 default String getLabel() {
 Field field = ReflectionUtils.findField(this.getClass(), DEFAULT_LABEL_NAME);
 if (field == null)
  return null;
 try {
  field.setAccessible(true);
  return field.get(this).toString();
 } catch (IllegalAccessException e) {
  throw new RuntimeException(e);
 }
 }
 static <T extends Enum<T>> T valueOfEnum(Class<T> enumClass, Integer value) {
 if (value == null)
  throw new IllegalArgumentException("DisplayedEnum value should not be null");
 if (enumClass.isAssignableFrom(DisplayedEnum.class))
  throw new IllegalArgumentException("illegal DisplayedEnum type");
 T[] enums = enumClass.getEnumConstants();
 for (T t: enums) {
  DisplayedEnum displayedEnum = (DisplayedEnum)t;
  if (displayedEnum.getValue().equals(value))
  return (T) displayedEnum;
 }
 throw new IllegalArgumentException("cannot parse integer: " + value + " to " + enumClass.getName());
 }
}

说明:

普通枚举类通过实现DisplayedEnum接口,就可以:

  1. 通过getValue()获取枚举值。
  2. 通过getLabel()获取枚举的label属性。
  3. 通过valueOfEnum()将Integer值转换为指定的枚举类型。

普通枚举类

public enum CommonsType implements DisplayedEnum {
 NORMAL("正常", 0), INVALID("无效", 1);
 String label;
 Integer value;
 private CommonsType(String label, Integer value) {
 this.label = label;
 this.value = value;
 }
}

以上就是一个普通枚举类的示例。

自定义枚举TypeHandler

@MappedJdbcTypes(value = JdbcType.TINYINT, includeNullJdbcType = true)
public class DefaultEnumTypeHandler extends BaseTypeHandler<DisplayedEnum> {
 private Class<DisplayedEnum> type;
 public EnumTypeHandler(){};
 public EnumTypeHandler(Class<DisplayedEnum> type) {
 if (type == null) throw new IllegalArgumentException("Type argument cannot be null");
 this.type = type;
 }
 @Override
 public void setNonNullParameter(PreparedStatement ps, int i, DisplayedEnum parameter, JdbcType jdbcType)
  throws SQLException {
 ps.setInt(i, parameter.getValue());
 }
 @Override
 public DisplayedEnum getNullableResult(ResultSet rs, String columnName) throws SQLException {
 return convert(rs.getInt(columnName));
 }
 @Override
 public DisplayedEnum getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
 return convert(rs.getInt(columnIndex));
 }
 @Override
 public DisplayedEnum getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
 return convert(cs.getInt(columnIndex));
 }
 private DisplayedEnum convert(int status){
 DisplayedEnum[] objs = type.getEnumConstants();
 for(DisplayedEnum em: objs){
  if(em.getValue() == status){
  return em;
  }
 }
 return null;
 }
}

使用我们自定义的DefaultEnumTypeHandler

由于Mybatis默认在处理枚举类型的时候会使用EnumTypeHandler(只保存及转换枚举类型的名字), 因此,我们需要手动指定使用DefaultEnumTypeHandler。示例如下:

<resultMap id="xxx" type="xxx">
 ...
 <result column="type" jdbcType="TINYINT" property="type" typeHandler="xxx.xxx.xxx.DefaultEnumTypeHandler" />
 ...
</resultMap> 

即我们需要通过使用typeHandler来指定。

小结

以上是我们应用在实际项目中的一个对于Mybatis处理枚举类的方案。我看大多数人也都是这样在用。然而,在实际项目中,我们会发现随着枚举类的增多,这样写起来会很繁琐。我看了一下网络上似乎也没人处理这种情况。那么,下一篇文章将针对这种情况进行处理。

以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,同时也希望多多支持!


# mybatis  # typehandler  # 枚举  # Mybatis实现自定义的typehandler三步曲  # MyBatis自定义typeHandler的完整实例  # MyBatis-Plus如何通过注解使用TypeHandler  # Mybatis实现自定义类型转换器TypeHandler的方法  # Mybatis自定义TypeHandler解决特殊类型转换问题详解  # Mybatis实战之TypeHandler高级进阶  # Mybatis之类型处理器TypeHandler的作用与自定义方式  # MyBatis使用自定义TypeHandler转换类型的实现方法  # MyBatis-Plus 中 typeHandler 的使用实例详解  # MyBatis中TypeHandler的使用教程详解  # 一文搞懂MyBatis中TypeHandler机制  # 自定义  # 这种情况  # 在实际  # 我看  # 是这样  # 没人  # 我们可以  # 下一  # 也都  # 会很  # 很明显  # 大多数人  # 转换为  # 一个普通  # 就可以  # 有两个  # 我看了  # findField  # field  # catch 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: 微信小程序 input输入框控件详解及实例(多种示例)  Laravel怎么实现搜索功能_Laravel使用Eloquent实现模糊查询与多条件搜索【实例】  网站制作企业,网站的banner和导航栏是指什么?  Laravel如何使用查询构建器?(Query Builder高级用法)  Laravel如何实现登录错误次数限制_Laravel自带LoginThrottles限流配置【方法】  独立制作一个网站多少钱,建立网站需要花多少钱?  Laravel如何操作JSON类型的数据库字段?(Eloquent示例)  Laravel队列任务超时怎么办_Laravel Queue Timeout设置详解  如何在HTML表单中获取用户输入并结合JavaScript动态控制复利计算循环  详解CentOS6.5 安装 MySQL5.1.71的方法  Claude怎样写约束型提示词_Claude约束提示词写法【教程】  Laravel如何使用Gate和Policy进行权限控制_Laravel权限判定与策略规则配置  javascript事件捕获机制【深入分析IE和DOM中的事件模型】  javascript中数组(Array)对象和字符串(String)对象的常用方法总结  Laravel如何实现文件上传和存储?(本地与S3配置)  JavaScript模板引擎Template.js使用详解  Internet Explorer官网直接进入 IE浏览器在线体验版网址  ,在苏州找工作,上哪个网站比较好?  企业在线网站设计制作流程,想建设一个属于自己的企业网站,该如何去做?  如何在沈阳梯子盘古建站优化SEO排名与功能模块?  极客网站有哪些,DoNews、36氪、爱范儿、虎嗅、雷锋网、极客公园这些互联网媒体网站有什么差异?  使用PHP下载CSS文件中的所有图片【几行代码即可实现】  Gemini手机端怎么发图片_Gemini手机端发图方法【步骤】  Laravel如何配置和使用缓存?(Redis代码示例)  齐河建站公司:营销型网站建设与SEO优化双核驱动策略  Laravel怎么实现搜索高亮功能_Laravel结合Scout与Algolia全文检索【实战】  Laravel如何实现全文搜索功能?(Scout和Algolia示例)  微信小程序 闭包写法详细介绍  Bootstrap整体框架之CSS12栅格系统  打开php文件提示内存不足_怎么调整php内存限制【解决方案】  如何在建站之星网店版论坛获取技术支持?  1688铺货到淘宝怎么操作 1688一键铺货到自己店铺详细步骤  桂林网站制作公司有哪些,桂林马拉松怎么报名?  LinuxShell函数封装方法_脚本复用设计思路【教程】  Android自定义listview布局实现上拉加载下拉刷新功能  WordPress 子目录安装中正确处理脚本路径的完整指南  java获取注册ip实例  Laravel PHP版本要求一览_Laravel各版本环境要求对照  Laravel如何处理JSON字段_Eloquent原生JSON字段类型操作教程  网站制作报价单模板图片,小松挖机官方网站报价?  如何快速使用云服务器搭建个人网站?  Swift中switch语句区间和元组模式匹配  东莞市网站制作公司有哪些,东莞找工作用什么网站好?  网站页面设计需要考虑到这些问题  中山网站制作网页,中山新生登记系统登记流程?  中山网站推广排名,中山信息港登录入口?  如何快速生成橙子建站落地页链接?  成都网站制作公司哪家好,四川省职工服务网是做什么用?  如何在Tomcat中配置并部署网站项目?  JavaScript 输出显示内容(document.write、alert、innerHTML、console.log)