写点什么

干掉 XML Mapper,新出的 Fluent Mybatis 真香

作者:AI乔治
  • 2021 年 11 月 22 日
  • 本文字数:2678 字

    阅读完需:约 9 分钟

干掉 XML Mapper,新出的 Fluent Mybatis 真香

使用 fluent mybatis 可以不用写具体的 xml 文件,通过 java api 可以构造出比较复杂的业务 sql 语句,做到代码逻辑和 sql 逻辑的合一。

不再需要在 Dao 中组装查询或更新操作,在 xml 或 mapper 中再组装参数。

那对比原生 Mybatis, Mybatis Plus 或者其他框架,FluentMybatis 提供了哪些便利呢?

需求场景设置

我们通过一个比较典型的业务需求来具体实现和对比下,假如有学生成绩表结构如下:


现在有需求:

统计 2000 年三门学科('英语', '数学', '语文')及格分数按学期,学科统计最低分,最高分和平均分, 且样本数需要大于 1 条,统计结果按学期和学科排序

我们可以写 SQL 语句如下


那上面的需求,分别用 fluent mybatis, 原生 mybatis 和 Mybatis plus 来实现一番。

三者实现对比

使用 fluent mybatis 来实现上面的功能

具体代码:

https://gitee.com/fluent-mybatis/fluent-mybatis-docs/tree/master/spring-boot-demo/

我们可以看到 fluent api 的能力,以及 IDE 对代码的渲染效果。

换成 mybatis 原生实现效果

1.定义 Mapper 接口

public interface MyStudentScoreMapper {    List<Map<String, Object>> summaryScore(SummaryQuery paras);}
复制代码

2.定义接口需要用到的参数实体 SummaryQuery


3.定义实现业务逻辑的 mapper xml 文件

<select id="summaryScore" resultType="map" parameterType="cn.org.fluent.mybatis.springboot.demo.mapper.SummaryQuery">    select school_term,    subject,    count(score) as count,    min(score) as min_score,    max(score) as max_score,    avg(score) as max_score    from student_score    where school_term >= #{schoolTerm}    and subject in    <foreach collection="subjects" item="item" open="(" close=")" separator=",">        #{item}    </foreach>    and score >= #{score}    and is_deleted = 0    group by school_term, subject    having count(score) > #{minCount}    order by school_term, subject</select>
复制代码

4.实现业务接口(这里是测试类, 实际应用中应该对应 Dao 类)


总之,直接使用 mybatis,实现步骤还是相当的繁琐,效率太低。换成 mybatis plus 的效果怎样呢?

换成 mybatis plus 实现效果

mybatis plus 的实现比 mybatis 会简单比较多,实现效果如下

如红框圈出的,写 mybatis plus 实现用到了比较多字符串的硬编码(可以用 Entity 的 get lambda 方法部分代替字符串编码)。

字符串的硬编码,会给开发同学造成不小的使用门槛,个人觉得主要有 2 点:

  • 字段名称的记忆和敲码困难

  • Entity 属性跟随数据库字段发生变更后的运行时错误

其他框架,比如 TkMybatis 在封装和易用性上比 mybatis plus 要弱,就不再比较了。


生成代码编码比较


fluent mybatis 生成代码设置


public class AppEntityGenerator {    static final String url = "jdbc:mysql://localhost:3306/fluent_mybatis_demo?useSSL=false&useUnicode=true&characterEncoding=utf-8";
public static void main(String[] args) { FileGenerator.build(Abc.class); }
@Tables( /** 数据库连接信息 **/ url = url, username = "root", password = "password", /** Entity类parent package路径 **/ basePack = "cn.org.fluent.mybatis.springboot.demo", /** Entity代码源目录 **/ srcDir = "spring-boot-demo/src/main/java", /** Dao代码源目录 **/ daoDir = "spring-boot-demo/src/main/java", /** 如果表定义记录创建,记录修改,逻辑删除字段 **/ gmtCreated = "gmt_create", gmtModified = "gmt_modified", logicDeleted = "is_deleted", /** 需要生成文件的表 ( 表名称:对应的Entity名称 ) **/ tables = @Table(value = {"student_score"}) ) static class Abc { }}
复制代码


mybatis plus 代码生成设置

public class CodeGenerator {
static String dbUrl = "jdbc:mysql://localhost:3306/fluent_mybatis_demo?useSSL=false&useUnicode=true&characterEncoding=utf-8";
@Test public void generateCode() { GlobalConfig config = new GlobalConfig(); DataSourceConfig dataSourceConfig = new DataSourceConfig(); dataSourceConfig.setDbType(DbType.MYSQL) .setUrl(dbUrl) .setUsername("root") .setPassword("password") .setDriverName(Driver.class.getName()); StrategyConfig strategyConfig = new StrategyConfig(); strategyConfig .setCapitalMode(true) .setEntityLombokModel(false) .setNaming(NamingStrategy.underline_to_camel) .setColumnNaming(NamingStrategy.underline_to_camel) .setEntityTableFieldAnnotationEnable(true) .setFieldPrefix(new String[]{"test_"}) .setInclude(new String[]{"student_score"}) .setLogicDeleteFieldName("is_deleted") .setTableFillList(Arrays.asList( new TableFill("gmt_create", FieldFill.INSERT), new TableFill("gmt_modified", FieldFill.INSERT_UPDATE)));
config .setActiveRecord(false) .setIdType(IdType.AUTO) .setOutputDir(System.getProperty("user.dir") + "/src/main/java/") .setFileOverride(true);
new AutoGenerator().setGlobalConfig(config) .setDataSource(dataSourceConfig) .setStrategy(strategyConfig) .setPackageInfo( new PackageConfig() .setParent("com.mp.demo") .setController("controller") .setEntity("entity") ).execute(); }}
复制代码


FluentMybatis 特性一览


三者对比总结

看完 3 个框架对同一个功能点的实现, 各位看官肯定会有自己的判断,笔者这里也总结了一份比较。


看完三件事❤️

  • 如果你觉得这篇内容对你还蛮有帮助,我想邀请你帮我三个小忙:

  • 点赞,转发,有你们的 『点赞和评论』,才是我创造的动力。

  • 关注公众号 『 java 烂猪皮 』,不定期分享原创知识。

  • 关注后回复【666】扫码即可获取最新 Java 进阶架构 VIP 资料包

  • 同时可以期待后续文章 ing🚀


来源:https://juejin.cn/post/6886019929519177735

用户头像

AI乔治

关注

分享后端技术干货。公众号【 Java烂猪皮】 2019.06.30 加入

一名默默无闻的扫地僧!

评论

发布
暂无评论
干掉 XML Mapper,新出的 Fluent Mybatis 真香