Mybatis-plus通用枚举

通用枚举优化:提升前后端协作效率
本文介绍了如何通过通用枚举配置优化代码,实现前端通过枚举属性或序数值高效传递数据,后端以枚举接收并持久化,以及如何定制JsonDeserializer处理不同传参方式。

通用枚举的配置可以优化代码,增强代码的可读性

效果:插入数据时:与前端商定传递枚举属性序数值(0,1,2 )或者 枚举字面量 或者枚举属性name值 (下架,发布中,暂存)其中一种方式(不同方式可能需要重写JsonDeserializer<>的deserialize方法,后面会讲),后端用枚举类型接收,数据库保存0,1,2,查询时:返回json数据 下架,发布中,暂存。

官网地址:通用枚举 | MyBatis-Plus

①声明通用枚举属性,使用@EnumValue标记数据库存的值,使用@JsonValue标记响应前端json的值

import com.baomidou.mybatisplus.annotation.EnumValue;
import com.fasterxml.jackson.annotation.JsonValue;
import lombok.Getter;
import lombok.extern.slf4j.Slf4j;

@Getter
@Slf4j
public enum ReleaseStatusEnum {
    /**
     * 下架
     */
    DOWN(0, "下架"),
    /**
     * 发布中
     */
    PUBLISHING(1, "发布中"),
    /**
     * 暂存
     */
    TEMP_SAVE(2, "暂存");

    ReleaseStatusEnum(Integer code, String message) {
        this.code = code;
        this.message = message;
    }

    @EnumValue
    private final Integer code;
    @JsonValue
    private final String message;
}

 ②配置扫描通用枚举,两种方式任选其一即可,注意,第二种不通的版本对应的EnumTypeHandler类名和路径可能不同

mybatis-plus.type-enums-package=com.xxx.localdemo.web.*.*
mybatis-plus.configuration.default-enum-type-handler=com.baomidou.mybatisplus.extension.handlers.MybatisEnumTypeHandler

③前端参数传递:如果你以枚举的属性进行传参,但枚举的序数不是从0开始,或者以枚举字面量进行传参,那么你需要声明反序列化类继承JsonDeserializer<>,重写deserialize方法,使用@JsonDeserialize(using = ReleaseStatusEnum .Deserializer.class)标记反序列化规则。如果你以枚举的属性进行传参,且枚举的序数是从0开始那么不重写也可以;

 public static class Deserializer extends JsonDeserializer<ReleaseStatusEnum> {

        @Override
        public ReleaseStatusEnum deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JsonProcessingException {
            String text = jsonParser.getText();

            try {
                for (ReleaseStatusEnum releaseStatusEnum : ReleaseStatusEnum.values()) {
                    if (releaseStatusEnum.getCode().equals(Integer.valueOf(text))) {
                        return releaseStatusEnum;
                    }
                }
                return null;
            } catch (Exception e) {
                log.warn("反序列化枚举类出错", e);
                return null;
            }
        }
    }

接收前端对象的对应属性添加  @JsonDeserialize指定反序列化方式

  /**
     * 发布状态 0下架 1发布 2暂存
     */
    @JsonDeserialize(using = ReleaseStatusEnum.Deserializer.class)
    private ReleaseStatusEnum releaseStatus;

效果如图:

前端参数转换

 存入数据库的值

 查询展示到前端的数据

<think>我们正在讨论Mybatis-Plus通用枚举在不同数据库(如MySQL和达梦)中的配置差异。根据引用[1]和[2],我们可以知道: 1. Mybatis-Plus从3.4.2版本开始支持通用枚举,不同版本配置方式不同。 2. 在3.5.2版本之后,只需要使用`@EnumValue`注解枚举属性即可,简化了配置。 3. 对于达梦数据库,由于数据库驱动或类型支持的差异,可能需要额外的处理(如类型处理器)。 下面我们将从以下几个方面分析配置差异: 一、枚举定义方式 二、Mybatis-Plus配置(包括全局配置和局部配置) 三、数据库表字段类型 一、枚举定义方式 无论是MySQL还是达梦,枚举定义方式相同,都是使用Java枚举类,并用`@EnumValue`标记数据库中存储的字段。 例如: ```java public enum GenderEnum { MALE(1, "男"), FEMALE(2, "女"); GenderEnum(int code, String desc) { this.code = code; this.desc = desc; } @EnumValue private final int code; private String desc; } ``` 二、Mybatis-Plus配置 1. MySQL:通常不需要额外配置,Mybatis-Plus会自动处理枚举类型。在3.5.2+版本中,只需确保在配置文件中开启枚举扫描(可选): ```yaml mybatis-plus: configuration: default-enum-type-handler: com.baomidou.mybatisplus.core.handlers.MybatisEnumTypeHandler # 或者使用包扫描(旧版本可能需要) type-enums-package: com.example.enums ``` 注意:在3.5.2+版本,只要使用了`@EnumValue`,即使不配置上述项,也能自动处理。 2. 达梦数据库:由于达梦数据库的JDBC驱动对枚举类型的支持可能不如MySQL完善,可能需要明确指定类型处理器(TypeHandler)。 在实体类中,我们可以为枚举字段指定自定义的类型处理器(例如,将枚举存储为整数): ```java public class User { // 其他字段... @TableField(typeHandler = EnumOrdinalTypeHandler.class) // 使用枚举的序号(即ordinal(),不推荐)或自定义处理器 // 或者使用基于code的自定义处理器 // @TableField(typeHandler = GenderEnumTypeHandler.class) private GenderEnum gender; } ``` 或者,我们可以创建一个自定义的类型处理器,将枚举转换为数据库中的整数(或字符串): ```java public class GenderEnumTypeHandler extends BaseTypeHandler<GenderEnum> { @Override public void setNonNullParameter(PreparedStatement ps, int i, GenderEnum parameter, JdbcType jdbcType) throws SQLException { ps.setInt(i, parameter.getCode()); // 使用code存储 } @Override public GenderEnum getNullableResult(ResultSet rs, String columnName) throws SQLException { int code = rs.getInt(columnName); return GenderEnum.getByCode(code); } // ...其他方法类似 } ``` 然后在实体类中指定: ```java @TableField(typeHandler = GenderEnumTypeHandler.class) private GenderEnum gender; ``` 三、数据库表字段类型 1. MySQL:可以直接使用枚举类型(ENUM)或整数类型(INT)等。如果使用整数类型,则存储枚举的code值;如果使用ENUM类型,则存储枚举的字符串名称(不推荐,因为与具体数据库绑定)。 2. 达梦数据库:不支持ENUM类型,因此只能使用整数类型(INTEGER)或字符串类型(VARCHAR)来存储枚举的code或desc。 总结配置差异: | 配置项 | MySQL | 达梦数据库 | |----------------|-----------------------------------|-----------------------------------| | 枚举定义 | 使用`@EnumValue`标记枚举属性 | 同MySQL | | Mybatis-Plus配置 | 通常无需额外配置,自动处理 | 可能需要指定自定义类型处理器 | | 数据库字段类型 | 支持INT或ENUM(不推荐) | 只能使用INT或VARCHAR | 注意事项: 1. 在达梦数据库中,由于驱动问题,直接使用Mybatis-Plus默认的枚举处理器可能会遇到“不支持的接口或功能”错误(如用户之前遇到的问题),因此建议使用自定义的类型处理器,并确保通过基础类型(如getInt)来获取值。 2. 在Mybatis-Plus 3.5.2+版本中,对于达梦数据库,如果不想每个字段都写`@TableField`注解,可以尝试全局配置默认的枚举处理器,但需要确保该处理器能正确处理达梦数据库的驱动。然而,由于达梦驱动的问题,全局配置可能仍然无效,此时自定义处理器是更可靠的方案。 示例:全局配置枚举处理器(在达梦数据库中可能无效,但可以尝试) ```yaml mybatis-plus: configuration: default-enum-type-handler: com.baomidou.mybatisplus.core.handlers.MybatisEnumTypeHandler ``` 如果上述全局配置无效,则必须使用自定义处理器并显式在字段上指定。 因此,在达梦数据库中使用Mybatis-Plus通用枚举时,推荐使用自定义类型处理器,并确保数据库字段类型为整数或字符串。 参考引用: [^1]: Mybatis-Plus通用枚举介绍和使用。 [^2]: Mybatis-Plus通用枚举 + 达梦数据库。 生成相关问题: 1. 如何为Mybatis-Plus通用枚举编写自定义类型处理器? 2. 在达梦数据库中,除了枚举类型,还有哪些数据类型需要特殊处理? 3. Mybatis-Plus在配置通用枚举时,如何同时兼容MySQL和达梦数据库? 4. 达梦数据库的JDBC驱动有哪些常见问题及解决方案?</think>### Mybatis-Plus通用枚举在MySQL与达梦数据库中的配置差异 #### 一、枚举定义差异 | 数据库 | 枚举定义方式 | 示例代码 | |--------|--------------|----------| | **MySQL** | 仅需`@EnumValue`注解 | ```java @Getter public enum GenderEnum { MALE(1, "男"), FEMALE(2, "女"); @EnumValue // 核心注解 private final int code; private final String desc; }``` | | **达梦** | 需实现`IEnum`接口 + `@EnumValue` | ```java public enum GenderEnum implements IEnum<Integer> { // 实现接口 MALE(1, "男"), FEMALE(2, "女"); @EnumValue private final int code; @Override public Integer getValue() { // 必须实现 return this.code; } }```[^2] | #### 二、配置文件差异 | 配置项 | MySQL | 达梦 | |--------|-------|------| | **扫描路径** | 非必需 | 必需 | | **配置示例** | ```yaml # application.yml mybatis-plus: type-enums-package: com.example.enums # 可选``` | ```yaml # application.yml mybatis-plus: type-enums-package: com.example.enums # 必须配置```[^2] | | **驱动要求** | 标准MySQL驱动 | `Dm8JdbcDriver18`(≥8.1.3.62) | #### 三、数据库字段类型映射 | 枚举类型 | MySQL存储 | 达梦存储 | |----------|-----------|----------| | 数字枚举 | `TINYINT` | `INTEGER` | | 字符串枚举 | `ENUM('M','F')` | `VARCHAR(10)` | | **最佳实践** | 推荐使用数字类型 | 必须使用基础类型字段[^3] | #### 四、类型处理器对比 ```mermaid graph TD A[查询请求] --> B{数据库类型} B -->|MySQL| C[MybatisEnumTypeHandler] B -->|达梦| D[CustomEnumTypeHandler] C --> E[自动转换枚举] D --> F[显式类型转换] F --> G[getInt()/getString()] G --> H[枚举转换] ``` #### 五、达梦特殊配置项 ```java // 必须显式指定类型处理器 @TableField(typeHandler = EnumTypeHandler.class) private GenderEnum gender; ``` ```xml <!-- mapper.xml需声明jdbcType --> <result column="gender" property="gender" jdbcType="INTEGER" <!-- 达梦必须指定 --> typeHandler="com.baomidou.mybatisplus.core.handlers.MybatisEnumTypeHandler"/> ``` #### 六、版本兼容性 | Mybatis-Plus版本 | MySQL支持 | 达梦支持 | |------------------|-----------|----------| | ≥3.5.2 | ✅ 全自动 | ✅ 需实现IEnum | | 3.4.x | ✅ 全自动 | ⚠️ 需自定义处理器 | | ≤3.3.x | ⚠️ 需配置包路径 | ❌ 不推荐使用 | > **关键结论**:达梦数据库需**显式类型声明**+**基础类型字段**+**IEnum接口实现**三重保障才能避免`不支持的接口或功能`错误[^1][^2] ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值