• 需求場景設置
• 三者實現對比
  • 使用fluent mybatis 來實現上面的功能
  • 換成mybatis原生實現效果
  • 換成mybatis plus實現效果
• 生成代碼編碼比較
  • fluent mybatis生成代碼設置
  • mybatis plus代碼生成設置
• FluentMybatis特性一覽
• 三者對比總結

使用fluent mybatis可以不用寫具體的xml文件，通過java api可以構造出比較復雜的業務sql語句，做到代碼邏輯和sql邏輯的合一。不再需要在Dao中組裝查詢或更新操作，在xml或mapper中再組裝參數。那對比原生Mybatis, Mybatis Plus或者其他框架，FluentMybatis提供了哪些便利呢？

需求場景設置

我們通過一個比較典型的業務需求來具體實現和對比下，假如有學生成績表結構如下:

createtable`student_score`
(
idbigintauto_incrementcomment'主鍵ID'primarykey,
student_idbigintnotnullcomment'學號',
gender_mantinyintdefault0notnullcomment'性別,0:女;1:男',
school_termintnullcomment'學期',
subjectvarchar(30)nullcomment'學科',
scoreintnullcomment'成績',
gmt_createdatetimenotnullcomment'記錄創建時間',
gmt_modifieddatetimenotnullcomment'記錄最后修改時間',
is_deletedtinyintdefault0notnullcomment'邏輯刪除標識'
)engine=InnoDBdefaultcharset=utf8;

現在有需求:

統計2000年三門學科('英語', '數學', '語文')及格分數按學期,學科統計最低分，最高分和平均分, 且樣本數需要大于1條,統計結果按學期和學科排序

我們可以寫SQL語句如下

selectschool_term,
subject,
count(score)ascount,
min(score)asmin_score,
max(score)asmax_score,
avg(score)asmax_score
fromstudent_score
whereschool_term>=2000
andsubjectin('英語','數學','語文')
andscore>=60
andis_deleted=0
groupbyschool_term,subject
havingcount(score)>1
orderbyschool_term,subject;

那上面的需求，分別用fluent mybatis, 原生mybatis 和 Mybatis plus來實現一番。

基于 Spring Boot + MyBatis Plus + Vue & Element 實現的后臺管理系統 + 用戶小程序，支持 RBAC 動態權限、多租戶、數據權限、工作流、三方登錄、支付、短信、商城等功能

• 項目地址：https://gitee.com/zhijiantianya/ruoyi-vue-pro
• 視頻教程：https://doc.iocoder.cn/video/

三者實現對比

使用fluent mybatis 來實現上面的功能

具體代碼

我們可以看到fluent api的能力，以及IDE對代碼的渲染效果。

換成mybatis原生實現效果

1. 定義Mapper接口

publicinterfaceMyStudentScoreMapper{
List>summaryScore(SummaryQueryparas);
}

1. 定義接口需要用到的參數實體 SummaryQuery

@Data
@Accessors(chain=true)
publicclassSummaryQuery{
privateIntegerschoolTerm;

privateListsubjects;

privateIntegerscore;

privateIntegerminCount;
}

1. 定義實現業務邏輯的mapper xml文件

<selectid="summaryScore"resultType="map"parameterType="cn.org.fluent.mybatis.springboot.demo.mapper.SummaryQuery">
selectschool_term,
subject,
count(score)ascount,
min(score)asmin_score,
max(score)asmax_score,
avg(score)asmax_score
fromstudent_score
whereschool_term>=#{schoolTerm}
andsubjectin
<foreachcollection="subjects"item="item"open="("close=")"separator=",">
#{item}
foreach>
andscore>=#{score}
andis_deleted=0
groupbyschool_term,subject
havingcount(score)>#{minCount}
orderbyschool_term,subject
select>

1. 實現業務接口(這里是測試類, 實際應用中應該對應Dao類)

@RunWith(SpringRunner.class)
@SpringBootTest(classes=QuickStartApplication.class)
publicclassMybatisDemo{
@Autowired
privateMyStudentScoreMappermapper;

@Test
publicvoidmybatis_demo(){
//構造查詢參數
SummaryQueryparas=newSummaryQuery()
.setSchoolTerm(2000)
.setSubjects(Arrays.asList("英語","數學","語文"))
.setScore(60)
.setMinCount(1);

List>summary=mapper.summaryScore(paras);
System.out.println(summary);
}
}

總之，直接使用mybatis，實現步驟還是相當的繁瑣，效率太低。那換成mybatis plus的效果怎樣呢？

換成mybatis plus實現效果

mybatis plus的實現比mybatis會簡單比較多，實現效果如下

如紅框圈出的，寫mybatis plus實現用到了比較多字符串的硬編碼（可以用Entity的get lambda方法部分代替字符串編碼）。字符串的硬編碼，會給開發同學造成不小的使用門檻，個人覺的主要有2點：

1. 字段名稱的記憶和敲碼困難
2. Entity屬性跟隨數據庫字段發生變更后的運行時錯誤

其他框架，比如TkMybatis在封裝和易用性上比mybatis plus要弱，就不再比較了。

基于 Spring Cloud Alibaba + Gateway + Nacos + RocketMQ + Vue & Element 實現的后臺管理系統 + 用戶小程序，支持 RBAC 動態權限、多租戶、數據權限、工作流、三方登錄、支付、短信、商城等功能

• 項目地址：https://gitee.com/zhijiantianya/yudao-cloud
• 視頻教程：https://doc.iocoder.cn/video/

生成代碼編碼比較

fluent mybatis生成代碼設置

publicclassAppEntityGenerator{
staticfinalStringurl="jdbc//localhost:3306/fluent_mybatis_demo?useSSL=false&useUnicode=true&characterEncoding=utf-8";

publicstaticvoidmain(String[]args){
FileGenerator.build(Abc.class);
}

@Tables(
/**數據庫連接信息**/
url=url,username="root",password="password",
/**Entity類parentpackage路徑**/
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"})
)
staticclassAbc{
}
}

mybatis plus代碼生成設置

publicclassCodeGenerator{

staticStringdbUrl="jdbc//localhost:3306/fluent_mybatis_demo?useSSL=false&useUnicode=true&characterEncoding=utf-8";

@Test
publicvoidgenerateCode(){
GlobalConfigconfig=newGlobalConfig();
DataSourceConfigdataSourceConfig=newDataSourceConfig();
dataSourceConfig.setDbType(DbType.MYSQL)
.setUrl(dbUrl)
.setUsername("root")
.setPassword("password")
.setDriverName(Driver.class.getName());
StrategyConfigstrategyConfig=newStrategyConfig();
strategyConfig
.setCapitalMode(true)
.setEntityLombokModel(false)
.setNaming(NamingStrategy.underline_to_camel)
.setColumnNaming(NamingStrategy.underline_to_camel)
.setEntityTableFieldAnnotationEnable(true)
.setFieldPrefix(newString[]{"test_"})
.setInclude(newString[]{"student_score"})
.setLogicDeleteFieldName("is_deleted")
.setTableFillList(Arrays.asList(
newTableFill("gmt_create",FieldFill.INSERT),
newTableFill("gmt_modified",FieldFill.INSERT_UPDATE)));

config
.setActiveRecord(false)
.setIdType(IdType.AUTO)
.setOutputDir(System.getProperty("user.dir")+"/src/main/java/")
.setFileOverride(true);

newAutoGenerator().setGlobalConfig(config)
.setDataSource(dataSourceConfig)
.setStrategy(strategyConfig)
.setPackageInfo(
newPackageConfig()
.setParent("com.mp.demo")
.setController("controller")
.setEntity("entity")
).execute();
}
}

FluentMybatis特性一覽

三者對比總結

看完3個框架對同一個功能點的實現, 各位看官肯定會有自己的判斷，筆者這里也總結了一份比較。

審核編輯：湯梓紅