mybatisplus 数字枚举映射

MybatisPlus是Mybatis的增强工具，在Mybatis的基础上进行了封装，提供了很多实用的功能，其中包括结果集映射。MybatisPlus的结果集映射可以通过注解的方式来实现，常用的注解包括： 1. @TableId：指定表主键字段的注解。 2. @TableField：指定表字段的注解。 3. @TableName：指定表名的注解。 4. @Version：乐观锁注解。 5. @EnumValue：枚举值注解。 6. @Results：可以与@Result一起使用，封装多个结果集。 7. @One：实现一对一结果集封装。 8. @Many：实现一对多结果集封装。 9. @CacheNamespace(blocking = true)：开启二级缓存。 通过使用这些注解，可以方便地实现结果集映射，提高开发效率。

### MyBatisPlus 中枚举类型处理器的使用方法 在实体类中可以使用枚举类型的字段，MyBatis-Plus 将自动利用注册过的处理器完成相应的转换工作[^1]。 对于自定义类型处理器的需求，则可以通过继承 `BaseTypeHandler` 类并重写其中的方法来实现特定逻辑。这使得开发者能够针对不同的数据库和 Java 对象之间的复杂映射关系提供个性化的解决方案[^2]。 当涉及到数组或其他特殊的数据结构时，默认情况下可能会遇到兼容性问题；因此创建一个专门用于处理这些特殊情况的 TypeHandler 是必要的，比如为 PostgreSQL 数据库设计的 PGArrayTypeHandler 可以很好地解决这一挑战[^3]。 为了使框架识别到新创建的枚举处理器，在配置文件里指定要扫描的相关包路径也是不可或缺的一部分： ```yaml mybatisPlus: typeEnumsPackage: com.example.enums typeHandlersPackage: com.example.handler ``` 上述设置确保了应用程序启动期间会加载来自指定位置的所有枚举和处理器类[^4]。 #### 示例代码展示如何构建一个简单的枚举处理器 假设有一个名为 Gender 的枚举用来表示性别信息： ```java public enum Gender { MALE, FEMALE; } ``` 接着编写对应的处理器类 EnumGenderTypeHandler 继承 BaseTypeHandler 并覆盖相应的方法： ```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 EnumGenderTypeHandler extends BaseTypeHandler<Gender> { @Override public void setNonNullParameter(PreparedStatement ps, int i, Gender parameter, JdbcType jdbcType) throws SQLException { ps.setString(i, parameter.name()); } @Override public Gender getNullableResult(ResultSet rs, String columnName) throws SQLException { return Gender.valueOf(rs.getString(columnName)); } @Override public Gender getNullableResult(ResultSet rs, int columnIndex) throws SQLException { return Gender.valueOf(rs.getString(columnIndex)); } @Override public Gender getNullableResult(CallableStatement cs, int columnIndex) throws SQLException { return Gender.valueOf(cs.getString(columnIndex)); } } ``` 最后一步是在实体类中的属性声明处标注此处理器的应用范围： ```java @TableField(typeHandler = EnumGenderTypeHandler.class) private Gender gender; ``` 通过这种方式就可以让 MyBatis Plus 正确地解析并存储枚举值至数据库表单内。