最近发现之前使用的MyBatis插件很久都没更新了,就想换个其他插件来用用。偶然发现MyBatis-Plus团队也开发了一款插件MyBatisX,体验了一把确实非常好用,提示很全,而且还能通过GUI生成代码,推荐给大家!

MybatisX简介

MybatisX是一款基于IDEA的快速开发插件,由MyBatis-Plus团队开发维护,为效率而生。

它的主要功能如下:

  • 支持mapper.xml和Mapper接口之间方法的互相导航跳转;
  • 内置代码生成器,通过使用GUI的形式,能根据数据库来生成Domain、mapper.xml、Mapper、Service和Service实现类代码;
  • 可以自定义代码生成器模板;
  • 可以通过类似JPA的方式,直接根据方法名称在mapper.xml中生成查询实现,同时支持提示。
使用

接下来介绍下MybatisX的使用,这里以我的脚手架项目mall-tiny为例。

安装

在使用前我们需要在插件市场中搜索并安装MyBatisX插件。

mybatisplus自定义sql查询(试试MyBatis-Plus同款IDEA插件吧)(1)

安装完成后我们会发现所有的Mapper接口和mapper.xml文件都变成了MyBatis的小鸟图标。

mybatisplus自定义sql查询(试试MyBatis-Plus同款IDEA插件吧)(2)

XML与接口互跳

我们点击Mapper接口方法左侧的图标可以直接跳转到mapper.xml对应的SQL实现,在mapper.xml点击左侧图标也可以直接跳转到Mapper接口中对应的方法。

mybatisplus自定义sql查询(试试MyBatis-Plus同款IDEA插件吧)(3)

自动生成代码

还记得之前在mall-tiny项目中我们手写的代码生成器么,MyBatisX直接整了个带图形化界面的,下面我们来体验下。

  • 选中表以后右键可以直接生成对应表的CRUD代码,当然你也可以多选,支持一次性生成多表;

mybatisplus自定义sql查询(试试MyBatis-Plus同款IDEA插件吧)(4)

  • 生成的时候可以通过GUI来修改选项,比如修改基础包路径、实体类包路径等;

mybatisplus自定义sql查询(试试MyBatis-Plus同款IDEA插件吧)(5)

  • 生成时选择注解和模板类型为Mybatis-Plus 3,有需要的话可以勾选Lombok选项以及修改mapper.xml的文件路径;

mybatisplus自定义sql查询(试试MyBatis-Plus同款IDEA插件吧)(6)

  • 点击确认后将生成如下文件,还记得之前在mall-tiny项目中用代码写的代码生成器么,有了GUI就用不着手写了!

mybatisplus自定义sql查询(试试MyBatis-Plus同款IDEA插件吧)(7)

自定义生成模板

如果你觉得默认的代码生成器模板不符合你的要求,还可以试试自定义模板。

  • 我们一般会在实体类中加入Swagger的注解,方便API文档的生成,MyBatisX默认生成的实体类是不带Swagger注解的;

mybatisplus自定义sql查询(试试MyBatis-Plus同款IDEA插件吧)(8)

  • MyBatisX也提供了生成带Swagger注解的实体类模板,但是有点复杂不太符合我的要求,我们可以修改下生成模板,生成模板都在extensions->MyBaitsX目录下;

mybatisplus自定义sql查询(试试MyBatis-Plus同款IDEA插件吧)(9)

  • 这里我们修改下domain.ftl文件即可,最终文件内容如下;

package ${domain.packageName}; import java.io.Serializable; <#list tableClass.importList as fieldType>${"\n"}import ${fieldType};</#list> import io.swagger.annotations.ApiModelProperty; import io.swagger.annotations.ApiModel; import lombok.Data; import lombok.EqualsAndHashCode; import com.baomidou.mybatisplus.annotation.TableName; /** * ${tableClass.remark!} */ @Data @EqualsAndHashCode(callSuper = false) @TableName("${tableClass.tableName}") @ApiModel(value="${tableClass.shortClassName}对象", description="${tableClass.remark!}") public class ${tableClass.shortClassName} implements Serializable { private static final long serialVersionUID=1L; <#list tableClass.allFields as field> @ApiModelProperty("${field.remark!}") private ${field.shortTypeName} ${field.fieldName}; </#list> }

  • 然后再运行代码生成器,选择只生成带Swagger注解的实体类;

mybatisplus自定义sql查询(试试MyBatis-Plus同款IDEA插件吧)(10)

  • 生成完成后实体类就会带上Swagger注解了,是不是很方便!

mybatisplus自定义sql查询(试试MyBatis-Plus同款IDEA插件吧)(11)

JPA提示

MyBatisX还有个强大的功能,可以根据JPA风格的方法名直接生成SQL实现,无需手写SQL。

  • 例如我们想写个批量插入数据方法,就可以这样来操作;

mybatisplus自定义sql查询(试试MyBatis-Plus同款IDEA插件吧)(12)

  • 例如我们想写个根据名称查询品牌的方法,MyBatisX会像JPA一样自动提示字段,并且能自动生成SQL实现;

mybatisplus自定义sql查询(试试MyBatis-Plus同款IDEA插件吧)(13)

  • 例如我们想写个根据ID修改品牌名称的方法;

mybatisplus自定义sql查询(试试MyBatis-Plus同款IDEA插件吧)(14)

  • 例如我们想写个根据名称删除品牌的方法,MyBatisX的JPA提示还是非常全面的!

mybatisplus自定义sql查询(试试MyBatis-Plus同款IDEA插件吧)(15)

图标设置

如果你不想Mapper接口和mapper.xml文件都变成小鸟图标的话,可以做在MyBatisX的设置中进行修改。

mybatisplus自定义sql查询(试试MyBatis-Plus同款IDEA插件吧)(16)

总结

MyBatisX确实是一款非常好用的IDEA插件,不仅提示全面,而且自带了图形化的代码生成器,能极大地提高我们的开发效率。MyBatisX中的JPA提示功能也非常不错,只要你的方法命名符合JPA规范,就能自动生成SQL实现,确实是个好功能。

参考资料

官方文档:https://baomidou.com/pages/ba5b24/

来源:https://mp.weixin.qq.com/s/IkSwjT01H1mLtHK0xb14wA

,