MyBatis-Plus 使用枚举自动关联注入

目录
  • 什么是枚举自动注入?
  • 实际效果
  • 实现步骤
  • 踩坑
  • 解决方法
  • 参数解析
  • 总结

什么是枚举自动注入?

官方文档是这么解释的

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

按我的理解是维护在内存中且不易修改的轻量级字典。目前觉得这个功能的使用场景相对有限,但是如果有用到的话开箱即用也是很棒的。废话不多说,接下来让我们看一下它的实际效果吧。

实际效果

通常情况下,我们会这样声明一个用户实体

public class User {
    private String id;
    private String name;
    private Integer age;
    private String phone;
    //省略getter&setter&constructor
    ...
}

那么最终获取到的JSON数据应该类似于这样

{
        id: "1",
        name: "张三",
        age: 18,
        phone: "10000"
}

如若使用MyBatis-Plus的枚举自动关联注入,可以更优雅的实现如下效果

{
        id: "1",
        name: "张三",
        age: "十八岁",
        phone: "中国电信"
}

实现步骤

实现过程仅有三步且非常简单,代码量也非常的少,下面介绍一下实现步骤。

1.创建两个枚举对象,分别为AgeEnum与PhoneEnum,这里使用枚举建立一个映射关系。

public enum AgeEnum implements IEnum {
    ONE(1, "一岁"),
    TWO(2, "二岁");

    private int age;
    private String desc;

    AgeEnum(final int age, final String desc) {
        this.age = age;
        this.desc = desc;
    }

    @Override
    public Serializable getValue() {
        return this.age;
    }

    @JsonValue
    public String getDesc(){
        return this.desc;
    }
}
public enum PhoneEnum implements IEnum {
    CMCC("10086", "中国移动"),
    CUCC("10010", "中国联通"),
    CT("10000", "中国电信");

    private String phone;
    private String desc;

    PhoneEnum(final String phone, final String desc) {
        this.phone = phone;
        this.desc = desc;
    }

    @Override
    public Serializable getValue() {
        return this.phone;
    }

    @JsonValue
    public String getDesc(){
        return this.desc;
    }
}

注意:

  • @JsonValue是使用JackSon解析时有效,若使用fastjson,请看官方文档提供的解决方案
  • 不要把@JsonValue打成@JsonView了,否则自动关联注入的是枚举名(name属性),如下所示
  • 别忘记实现IEnum接口,否则自动关联注入的是枚举名(name属性),如下所示
{
        id: "1",
        name: "张三",
        age: "十八岁",
        phone: "CT"
}

2.将User实体中的属性替换为枚举,例如

public class User {
    private String id;
    private String name;
    private AgeEnum age;
    private PhoneEnum phone;
    //省略getter&setter&constructor
    ...
}

3.配置扫描枚举,添加如下配置

mybatis-plus.typeEnumsPackage=com.xxx.xxx.enums//枚举所在路径

至此,使用MyBatis-Plus的枚举自动关联注入就完成了。

踩坑

在使用枚举自动关联注入时,还踩了一个坑。在代码正确的情况下出现了如下问题。

{
        id: null,
        name: null,
        age: null,
        phone: null
}

查出的所有值都为null,通过DEBUG跟踪代码发现问题。数据库中将实体中的某个枚举属性设置为了tinyint类型,在数据库中存储的值是1,枚举中也是使用1来映射关系,然而MyBaits-Plus在获取值是却读成了true,因此枚举并没有映射成功,返回null值。

当获取IsEnableEnum的枚举时,会执行这行代码获取枚举中的关系映射

EnumUtils.valueOf(this.type, rs.getObject(columnName));

但是MyBatis读取到的值变成了true

无法正确匹配到映射的值,返回null值,IsEnableEnum中声明的映射关系如下。

ENABLE(1, "可用"), LIMIT(-1, "禁用");

解决方法

1.将表中IsEnableEnum枚举对应的字段is_enable类型由tinyint改为int即可,这种解决方法的优点就是不用修改代码就解决问题。

2.MySQL中tinyint(1)对应Java中的boolean类型,非0为true,0为false。因此修改IsEnableEnum中的映射关系,如下。

ENABLE(true, "可用"), LIMIT(false, "禁用");

参数解析

当使用枚举注入的方式时,作为参数解析如果不注意会出现解析异常的情况。这里以修改User的is_enable值(数据库表中字段属性设置为int)为例看下具体解析异常情况的问题。例如,我们需要通过下面这个接口接收JSON请求参数来修改用户的信息。

@PostMapping
public User saveUser(@RequestBody User user) {
    return userService.insertOrUpdate(user) ? userService.selectById(user.getId()) : null;
}

使用Postman模拟请求,JSON参数

{
 "id":"922000984245391362",
 "isEnable":-1
}

响应结果

{
    "timestamp": "2018-05-12T04:20:15.920+0000",
    "status": 400,
    "error": "Bad Request",
    "exception": "org.springframework.http.converter.HttpMessageNotReadableException",
    "message": "JSON parse error: Can not deserialize value of type com.github.common.domain.enums.IsEnableEnum from number -1: index value outside legal index range [0..1]; nested exception is com.fasterxml.jackson.databind.exc.InvalidFormatException: Can not deserialize value of type com.github.common.domain.enums.IsEnableEnum from number -1: index value outside legal index range [0..1]\n at [Source: java.io.PushbackInputStream@25386a8e; line: 3, column: 13] (through reference chain: com.github.common.domain.User[\"isEnable\"])",
    "path": "/"
}

从错误信息我们可知,无法将-1映射成IsEnableEnum枚举,可用范围是0..1,那么应该怎么解决呢?

自己摸索出的解决方式有两种,分别为

使用value属性映射,经过测试0对应的是ENABLE(1, "可用"),1对应的是LIMIT(-1, "禁用")。很奇葩吧,因此不推荐此方式。
使用desc属性映射,将JSON请求参数改成如下就可以解析成功不报错。

{
 "id":"922000984245391362",
 "isEnable":"禁用"
}

总结

MyBatis-Plus这个特性目前用的还是不多,本质上其实还是把映射关系写死在代码中且个人觉得设计有些许不合理的地方,并不能替代字典,因此还是推荐使用字典方式,可以动态的修改映射关系。当项目遇到希望使用比字典更轻更快更容易上手的场景时,可以尝试使用枚举注入的方式。

针对于解决方法的选择个人想法是,当存储的值仅有两个且关系相对时,可以使用方法二,而在任何场景下方法一都适用,因此个人比较推荐方法一,因为可以存储更多的值和映射关系,例如上文的电话号码枚举。

最后,贴上MyBatis-Plus的官方文档,强烈推荐小伙伴们去尝试使用,非常棒的一个开源项目。

到此这篇关于MyBatis-Plus 使用枚举自动关联注入的文章就介绍到这了,更多相关MyBatis-Plus 枚举自动关联注入内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们!

(0)

相关推荐

  • MyBatis-Plus通用枚举自动关联注入的实现

    目录 一.通用枚举 二.声明通用枚举属性 三.配置扫描通用枚举 四.注意.注意.注意 一.通用枚举 解决了繁琐的配置,让 mybatis 优雅的使用枚举属性! 按我的理解是维护在内存中且不易修改的轻量级字典.目前觉得这个功能的使用场景相对有限,但是如果有用到的话开箱即用也是很棒的.废话不多说,接下来让我们看一下它的实际效果吧. 一般搜索用户信息列表,列如用户有禁用和启用两个状态 @Data public class User implements Serializable { private s

  • MyBatis-Plus 使用枚举自动关联注入

    目录 什么是枚举自动注入? 实际效果 实现步骤 踩坑 解决方法 参数解析 总结 什么是枚举自动注入? 官方文档是这么解释的 解决了繁琐的配置,让 mybatis 优雅的使用枚举属性! 按我的理解是维护在内存中且不易修改的轻量级字典.目前觉得这个功能的使用场景相对有限,但是如果有用到的话开箱即用也是很棒的.废话不多说,接下来让我们看一下它的实际效果吧. 实际效果 通常情况下,我们会这样声明一个用户实体 public class User { private String id; private S

  • MyBatis-Plus如何使用枚举自动关联注入详解

    目录 什么是枚举自动注入? 实际效果 实现步骤 踩坑 解决方法 参数解析 总结 什么是枚举自动注入? 官方文档是这么解释的 解决了繁琐的配置,让 mybatis 优雅的使用枚举属性! 按我的理解是维护在内存中且不易修改的轻量级字典.目前觉得这个功能的使用场景相对有限,但是如果有用到的话开箱即用也是很棒的.废话不多说,接下来让我们看一下它的实际效果吧. 实际效果 通常情况下,我们会这样声明一个用户实体 public class User {     private String id; priva

  • mybatis中实现枚举自动转换方法详解

    前言 最近在工作中遇到一个问题,在设计数据库的时候,我们有时候会把表里的某个字段的值设置为数字或者为英文来表示他的一些特殊含义.就拿设置成数字来说,假如1对应是学生,2对应是教师,在Java里面定义成这样的枚举,但是一般使用mybatis查出来的话,我们想要让它自动装换成我们想要的枚举,不需要再手动根据数值去判断设置成我们想要的枚举.要是实现这样的效果,那么我们就要用到mybatis的BaseTypeHandler了. BaseTypeHandler介绍 让我们来看看要继承BaseTypeHan

  • MyBatis学习教程(五)-实现关联表查询方法详解

    一.一对一关联  1.1.提出需求 根据班级id查询班级信息(带老师的信息) 1.2.创建表和数据 创建一张教师表和班级表,这里我们假设一个老师只负责教一个班,那么老师和班级之间的关系就是一种一对一的关系. CREATE TABLE teacher( t_id INT PRIMARY KEY AUTO_INCREMENT, t_name VARCHAR() ); CREATE TABLE class( c_id INT PRIMARY KEY AUTO_INCREMENT, c_name VAR

  • springboot+mybatis通过实体类自动生成数据库表的方法

    前言 本章介绍使用mybatis结合mysql数据库自动根据实体类生成相关的数据库表. 首先引入相关的pom包我这里使用的是springboot2.1.8.RELEASE的版本 <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>2.1.0</ve

  • ASP.NET Core实现自动依赖注入

    在开发.NET Core web服务的时候,我们习惯使用自带的依赖注入容器来进行注入. 于是就会经常进行一个很频繁的的重复动作:定义一个接口->写实现类->注入 有时候会忘了写Add这一步,看到屏幕上的报错一脸懵逼,然后瞬间反应过来忘了注入了.赶紧补上serviceCollection.AddXXX这句话 虽然说有很多开源框架已经实现了类似的工作,比如AutoFac,Unity等依赖注入框架.但是这些库都太庞大了,我个人还是喜欢轻量级的实现. 定义一个枚举 [AttributeUsage(At

  • SpringBoot Mybatis Plus公共字段自动填充功能

    一.应用场景 平时在建对象表的时候都会有最后修改时间,最后修改人这两个字段,对于这些大部分表都有的字段,每次在新增和修改的时候都要考虑到这几个字段有没有传进去,很麻烦.mybatisPlus有一个很好的解决方案.也就是公共字段自动填充的功能.一般满足下面条件的字段就可以使用此功能: 这个字段是大部分表都会有的. 这个字段的值是固定的,或则字段值是可以在后台动态获取的. 常用的就是last_update_time,last_update_name这两个字段. 二.配置MybatisPlus 导包:

  • Laravel实现构造函数自动依赖注入的方法

    本文实例讲述了Laravel实现构造函数自动依赖注入的方法.分享给大家供大家参考,具体如下: 在Laravel的构造函数中可以实现自动依赖注入,而不需要实例化之前先实例化需要的类,如代码所示: <?php namespace Lio\Http\Controllers\Forum; use Lio\Forum\Replies\ReplyRepository; use Lio\Forum\Threads\ThreadCreator; use Lio\Forum\Threads\ThreadCreat

  • PHP基于反射机制实现自动依赖注入的方法详解

    本文实例讲述了PHP基于反射机制实现自动依赖注入的方法.分享给大家供大家参考,具体如下: 依赖注入又叫控制反转,使用过框架的人应该都不陌生.很多人一看名字就觉得是非常高大上的东西,就对它望而却步,今天抽空研究了下,解开他它的神秘面纱.废话不多说,直接上代码: /** * * 工具类,使用该类来实现自动依赖注入. * */ class Ioc { // 获得类的对象实例 public static function getInstance($className) { $paramArr = sel

随机推荐