通用枚举

解决了繁琐的配置，让 mybatis 优雅的使用枚举属性！

自3.1.0开始,可配置默认枚举处理类来省略扫描通用枚举配置 默认枚举配置

• 升级说明:

  3.1.0 以下版本改变了原生默认行为,升级时请将默认枚举设置为EnumOrdinalTypeHandler

• 影响用户:

  实体中使用原生枚举

• 其他说明:

  配置枚举包扫描的时候能提前注册使用注解枚举的缓存

• 推荐配置:

  • 使用实现IEnum接口
    • 推荐配置defaultEnumTypeHandler
  • 使用注解枚举处理
    • 推荐配置typeEnumsPackage
  • 注解枚举处理与IEnum接口
    • 推荐配置typeEnumsPackage
  • 与原生枚举混用
    • 需配置defaultEnumTypeHandler与 typeEnumsPackage

1、申明通用枚举属性

方式一： 使用 @EnumValue 注解枚举属性 完整示例

public enum GradeEnum {
    PRIMARY(1, "小学"),  SECONDORY(2, "中学"),  HIGH(3, "高中");
    GradeEnum(int code, String descp) {
        this.code = code;
        this.descp = descp;
    }
    @EnumValue//标记数据库存的值是code
    private final int code;
    //。。。
}

方式二： 枚举属性，实现 IEnum 接口如下：

public enum AgeEnum implements IEnum<Integer> {
    ONE(1, "一岁"),
    TWO(2, "二岁"),
    THREE(3, "三岁");
    private int value;
    private String desc;
    @Override
    public Integer getValue() {
        return this.value;
    }
}

实体属性使用枚举类型

public class User{
    /**
     * 名字
     * 数据库字段: name varchar(20)
     */
    private String name;
    /**
     * 年龄，IEnum接口的枚举处理
     * 数据库字段：age INT(3)
     */
    private AgeEnum age;
    /**
     * 年级，原生枚举（带{@link com.baomidou.mybatisplus.annotation.EnumValue}):
     * 数据库字段：grade INT(2)
     */
    private GradeEnum grade;
}

2、配置扫描通用枚举

• 注意!! spring mvc 配置参考，安装集成 MybatisSqlSessionFactoryBean 枚举包扫描，spring boot 例子配置如下：示例工程：

👉 mybatisplus-spring-boot

配置文件 resources/application.yml

mybatis-plus:
    # 支持统配符 * 或者 ; 分割
    typeEnumsPackage: com.baomidou.springboot.entity.enums
  ....

3、JSON序列化处理

一、Jackson

1.在需要响应描述字段的get方法上添加@JsonValue注解即可

二、Fastjson

1.全局处理方式

        FastJsonConfig config = new FastJsonConfig();
        //设置WriteEnumUsingToString
        config.setSerializerFeatures(SerializerFeature.WriteEnumUsingToString);
        converter.setFastJsonConfig(config);

2.局部处理方式

        @JSONField(serialzeFeatures= SerializerFeature.WriteEnumUsingToString)
        private UserStatus status;

以上两种方式任选其一,然后在枚举中复写toString方法即可.

3.JavaBean方式序列化枚举 ,无需重写toString方法

        @JSONType(serializeEnumAsJavaBean = true)
        public enum GradeEnum {