java枚举在mybatis中需通过@enumvalue注解或自定义typehandler实现双向映射，优先使用稳定字段（如code/value）而非name()，并注意数据库类型匹配与非法值兜底处理。
Java 枚举在 MyBatis 中默认无法直接映射到数据库字段，因为枚举是对象类型，而数据库只存原始值（如字符串或整数）。要正确持久化和读取枚举，需明确告诉 MyBatis “这个枚举该用哪个字段值来存、怎么从数据库值还原成枚举”。核心在于定义**类型转换规则**，而不是依赖默认行为。
使用 @EnumValue 注解（MyBatis 3.4.0+）
如果枚举中已定义一个带 @EnumValue 的属性（比如 code 或 name），MyBatis 会自动识别并用于映射。前提是该属性有 getter 方法，且类型与数据库列一致（如 String 或 Integer）。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 枚举类示例：
public enum OrderStatus {<br> CREATED("created", 1),<br> PAID("paid", 2),<br> SHIPPED("shipped", 3);<br><br> private final String code;<br> private final int value;<br><br> OrderStatus(String code, int value) {<br> this.code = code;<br> this.value = value;<br> }<br><br> @EnumValue<br> public String getCode() {<br> return code;<br> }<br><br> public static OrderStatus fromCode(String code) {<br> // 手动实现反向查找逻辑<br> }<br>>}
- MyBatis 会用
getCode()的返回值写入数据库；查询时，也用该值匹配构造器参数或静态方法（需配合@EnumType或自定义 TypeHandler）。
自定义 TypeHandler 实现双向转换
这是最灵活、推荐的方式，尤其适用于复杂映射逻辑（如按数字码存、按中文名查，或需要容错处理空值/非法值）。
- 继承
BaseTypeHandler<e></e>，重写setNonNullParameter（写库）和getNullableResult（读库）； - 注册方式二选一：
– 在 mybatis-config.xml 中全局注册：<typehandlers><typehandler handler="com.example.OrderStatusTypeHandler"></typehandler></typehandlers>
– 或在 Mapper XML 的中局部指定： <result property="status" column="status_code" javatype="com.example.OrderStatus" typehandler="com.example.OrderStatusTypeHandler"></result> - 建议在 handler 内部使用
Enum.valueOf()或自定义查找表（HashMap），避免每次反射调用；对 null 和非法值做兜底（如返回 UNKNOWN 枚举项或抛异常）。
在 XML 映射文件中用 typeHandler 属性显式指定
即使有全局 TypeHandler，某些字段仍可能需要覆盖。直接在
- 插入时指定枚举字段的处理器：
<insert id="insertOrder"><br> INSERT INTO orders (status_code) VALUES (#{status, typeHandler=com.example.OrderStatusTypeHandler})<br></insert> - 查询时绑定结果：
<resultmap id="OrderMap" type="Order"><br> <result property="status" column="status_code" typehandler="com.example.OrderStatusTypeHandler"></result><br></resultmap>
注意事项与常见坑
- 数据库字段类型要和枚举序列化方式匹配：存字符串就用 VARCHAR，存数字就用 TINYINT/SMALLINT；
- 不要依赖
name()—— 一旦枚举名重构，历史数据就失效；优先用稳定字段（如 code、value）； - MyBatis 默认的 EnumTypeHandler 只支持按
name()映射，且不支持自定义反序列化逻辑，慎用； - Spring Boot + MyBatis Starter 下，可通过
@Configuration类注册 TypeHandler Bean，自动被扫描； - 单元测试时务必覆盖非法值场景（如数据库里存了 "unknown"），确保 TypeHandler 不抛 NPE 或 IndexOutOfBoundsException。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
