[[404450]]

只需瞅一眼Google Trends上全球Java界最熱門的兩款SQL映射框架近一年的對比數(shù)字，就不難了解其實力分布：在此領(lǐng)域，MyBatis早已占領(lǐng)東亞地區(qū)開發(fā)者市場，并以絕對優(yōu)勢穩(wěn)居中國最搶手Java數(shù)據(jù)庫訪問框架之首。

MyBatis霸榜的底氣來源于其廣袤的生態(tài)以及國內(nèi)眾多大廠的支持。而在琳瑯滿目的MyBatis擴展中，還埋藏著許多“寶藏項目”，來自阿里技術(shù)團隊的Fluent MyBatis便是其中一顆獨特的新星。

一 普拉斯們不香了

從iBatis到MyBatis，再到國內(nèi)團隊以MyBatis Plus為典型代表的諸多周邊工具，"Batis"系列套餐的發(fā)展歷程，幾乎又是一部XML的興衰史。最初的iBatis誕生于2002年，彼時XML在Java乃至整個軟件技術(shù)界都還相當(dāng)盛行，和同時期的許多項目一樣，iBatis硬生生的將一堆堆XML塞進(jìn)千家萬戶的項目里。

許多年后，曾今與iBatis并肩過的社區(qū)戰(zhàn)友們紛紛淡出了歷史舞臺，少數(shù)像Spring這樣延續(xù)至今的佼佼者，也逐漸摒棄XML，向代碼化配置的方式發(fā)展。在這方面，iBatis一直是個保守派，即使在MyBatis接過iBatis的衣缽之后，也只是”重磅“推出了支持代碼執(zhí)行SQL的@Select/@Insert/@Update/@Delete注解（以及相應(yīng)的4種Provider注解），用來抵擋開發(fā)者們對XML泛濫的吐槽，這是在2010年中旬，然后就再無動作。直到2016年底，MyBatis的主要貢獻(xiàn)者之一Jeff Butler正式創(chuàng)建MyBatis Dynamic SQL項目，MyBatis終于開始全面擁抱無XML的代碼化SQL構(gòu)建。

在從MyBatis到MyBatis Dynamic SQL之間長達(dá)6年多的空窗期里，開源社區(qū)催生出了許多民間基于MyBatis的無XML代碼方案，其中流行得比較廣泛的是Tk Mybatis、MyBatis Plus這類內(nèi)置Mapper和自動生成CRUD的擴展庫，一經(jīng)推出就收獲諸多好評。包括MyBatis Plus里實際上并不太完備的"條件構(gòu)造器"功能，也由于當(dāng)時同類解決方案的匱乏而頗受追捧。與此同時，在MyBatis社區(qū)之外，一直在默默發(fā)展的JOOQ是一款歷史與MyBatis幾乎同樣悠久的純Java動態(tài)SQL執(zhí)行庫，它的用戶群體不大，卻口碑甚好。如今在任意搜索引擎上輸入"MyBatis vs JOOQ"，依然能得到幾乎是一邊倒選擇JOOQ的結(jié)果，大家給出的理由也非常一致：簡潔、靈活、無需XML，很"Java"。而在MyBatis陣營里，若是拿出MyBatis Plus的"條件構(gòu)造器"與之正面對陣，只消三個回合，就會被屁滾尿流的打出擂臺。只可惜JOOQ的家底沒有MyBatis那樣殷實，早早走上了商業(yè)數(shù)據(jù)庫支持賣License收費的道路，才讓MyBatis免于在輿論上迎來自己的中年危機。

Fluent MyBatis誕生于2019年底，即使與MyBatis Dynamic SQL相比都是晚輩，然而尚處成長期的它就已透出了青出于藍(lán)而勝于藍(lán)的味道。

在實現(xiàn)方式上，MyBatis Plus覆寫并替換了部分MyBatis內(nèi)部類型的方法，整體機制較重，卻也因此能將一些功能細(xì)節(jié)隱藏到用戶無需關(guān)注的內(nèi)部邏輯里；與之相反，MyBatis Dynamic SQL的實現(xiàn)機制非常輕量，不僅完全基于MyBatis原生的Provider系列注解開發(fā)，而且沒有什么隱藏邏輯，對用戶的每張表自動生成相應(yīng)的Entity、DynamicSqlSupport和Mapper三個類，全部放入用戶的源碼目錄里，因此暴露的細(xì)節(jié)比較多，代碼侵入性略高。Fluent MyBatis取二者之所長，整體機制與MyBatis Dynamic SQL更接近，同樣基于原生的Provider注解，對用戶的每個表生成Entity類和默認(rèn)空白的Dao類，不同之處在于它還會通過JVM編譯期代碼增強功能自動生成許多開發(fā)者不可更改的標(biāo)準(zhǔn)輔助類，這些代碼無需放入用戶的源碼目錄但能夠在編碼時直接使用，即提供豐富的功能，又保證了用戶代碼的整潔。

在使用方式上，F(xiàn)luent MyBatis同樣借鑒了前輩們的最優(yōu)實踐，沒有花里胡哨的注解和配置，直接復(fù)用MyBatis連接，所有功能開箱即用。同時由于Fluent MyBatis將所有表字段、條件、操作都以方法調(diào)用形式提供，因此獲得了比其他同類項目都更好的IDE語法輔助。舉一個不太復(fù)雜的例子：

// 使用Fluent MyBatis構(gòu)造查詢語句mapper.listMaps(new StudentScoreQuery()    .select    .schoolTerm()    .subject()    .count.score("count")    .min.score("min_score")    .max.score("max_score")    .avg.score("avg_score")    .end()    .where.schoolTerm().ge(2000)    .and.subject.in(new String[]{"英語", "數(shù)學(xué)", "語文"})    .and.score().ge(60)    .and.isDeleted().isFalse()    .end()    .groupBy.schoolTerm().subject().end()    .having.count.score.gt(1).end()    .orderBy.schoolTerm().asc().subject().asc().end()); 

MyBatis Dynamic SQL的語法也比較美觀，但字段名和min/max/avg等方法都需要靜態(tài)引用，比Fluent MyBatis稍顯遜色。

// 使用MyBatis Dynamic SQL構(gòu)造查詢語句mapper.selectMany(    select(        schoolTerm,        subject,        count(score).as("count"),        min(score).as("min_score"),        max(score).as("max_score"),        avg(score).as("avg_score")    ).from(studentScore)    .where(schoolTerm, isGreaterThanOrEqualTo(2000))    .and(subject, isIn("英語", "數(shù)學(xué)", "語文"))    .and(score, isGreaterThanOrEqualTo(60))    .and(isDeleted, isEqualTo(false))    .groupBy(schoolTerm, subject)    .having(count(score), isGreaterThan(1)) //當(dāng)前其實還不支持having方法    .orderBy(schoolTerm, subject)    .build(isDeleted, isEqualTo(false))    .render(RenderingStrategies.MYBATIS3)); 

JOOQ的歷史比較悠久，寫出來的代碼鋪天蓋地都是常量字段，功能強大但美觀度欠佳。

// 使用JOOQ構(gòu)造查詢語句dslContext.select(    STUDENT_SCORE.GENDER_MAN,    STUDENT_SCORE.SCHOOL_TERM,    STUDENT_SCORE.SUBJECT,    count(STUDENT_SCORE.SCORE).as("count"),    min(STUDENT_SCORE.SCORE).as("min_score"),    max(STUDENT_SCORE.SCORE).as("max_score"),    avg(STUDENT_SCORE.SCORE).as("avg_score")).from(STUDENT_SCORE).where(    STUDENT_SCORE.SCHOOL_TERM.ge(2000),    STUDENT_SCORE.SUBJECT.in("英語", "數(shù)學(xué)", "語文"),    STUDENT_SCORE.SCORE.ge(60),    STUDENT_SCORE.IS_DELETED.eq(false)).groupBy(    STUDENT_SCORE.GENDER_MAN,    STUDENT_SCORE.SCHOOL_TERM,    STUDENT_SCORE.SUBJECT).having(count().ge(1)).orderBy(    STUDENT_SCORE.SCHOOL_TERM.asc(),    STUDENT_SCORE.SUBJECT.asc()).fetch(); 

MyBatis Plus的條件構(gòu)造器僅僅封裝了基本的SQL操作，對于字段、條件、別名等都要使用字符串拼接，極易出現(xiàn)由于拼寫失誤引起的SQL異常。

// 使用MyBatis Plus構(gòu)造查詢語句mapper.selectMaps(new QueryWrapper<StudentScore>()    .select(        "school_term",        "subject",        "count(score) as count",        "min(score) as min_score",        "max(score) as max_score",        "avg(score) as avg_score"    )    .ge("school_term", 2000)    .in("subject", "英語", "數(shù)學(xué)", "語文")    .ge("score", 60)    .eq("is_deleted", false)    .groupBy("school_term", "subject")    .having("count(score)>1")    .orderByAsc("school_term", "subject")); 

在Java動態(tài)SQL構(gòu)建的功能完整度方面，當(dāng)前的排序是MyBatis Plus < MyBatis Dynamic SQL < Fluent MyBatis < JOOQ。

MyBatis Plus條件構(gòu)造器在功能性上完敗，不僅無法表達(dá)JOIN、UNION語句，嵌套查詢之類稍復(fù)雜SQL也完全沒招。MyBatis Dynamic SQL支持JOIN和UNION語句，尚未支持嵌套查詢，且缺少HAVING等少量標(biāo)準(zhǔn)SQL語法。Fluent MyBatis支持多表JOIN、UNION、嵌套查詢和幾乎所有標(biāo)準(zhǔn)SQL語法，對于絕大多數(shù)場景都妥妥夠用。JOOQ是真正的王者，不僅支持標(biāo)準(zhǔn)SQL語法，連各廠商特有的專有關(guān)鍵字和內(nèi)置方法都沒放過，如MySQL的ON DUPLICATE KEY UPDATE、PostgreSQL的WINDOW、Oracle的CONNECT BY等等。補齊各種SQL語法是一件瑣碎而費力的工作，考慮到SQL語法的總量已經(jīng)基本不再變化，相信假以時日，各方的差距會逐漸縮小。

除了SQL基本功，特別值得一提的是Fluent MyBatis的獨門絕技：支持動態(tài)換表名（FreeQuery/FreeUpdate特性）。在云效項目的開發(fā)過程中，由于需要在各種嵌套查詢之上再根據(jù)視圖條件動態(tài)選擇聚合計算的維度表，多虧了Fluent MyBatis的動態(tài)表名功能，才得以在最大程度保留語法構(gòu)造便利性的情況下，讓代碼復(fù)用成為可能。

相比密密麻麻的XML文件，Java代碼在易讀性和可維護(hù)性方面有著明顯的優(yōu)勢。在官方和社區(qū)的共同推動下，一個全新的、代碼化的MyBatis生態(tài)正在冉冉升起。驀然回首，曾經(jīng)驕傲的"Plus擴展"們?nèi)疾幌懔恕?/p>

二 優(yōu)雅的數(shù)據(jù)流

初識Fluent MyBatis，最明顯能感受到的特點是它及其便利的IDE語法提示。

基于數(shù)據(jù)表自動生成的Entity、Mapper、Query、Update等對象，讓所有的數(shù)據(jù)庫字段和SQL操作都變成了方法，串成平整的流式語句。即使是層層嵌套的查詢，也能表現(xiàn)得錯落有致：

new StudentQuery()    .where.isDeleted().isFalse()    .and.grade().eq(4)    .and.homeCountyId().in(CountyDivisionQuery.class, q -> q        .selectId()        .where.isDeleted().isFalse()        .and.province().eq("浙江省")        .and.city().eq("杭州市")        .end()    ).end(); 

很容易就能看出，上述語句對應(yīng)的SQL為：

SELECT * FROM studentWHERE is_deleted = falseAND grade = 4AND home_county_id IN (    SELECT id FROM county_division     WHERE is_deleted = false    AND province = '浙江省'    AND city = '杭州市') 

不僅如此，F(xiàn)luent MyBatis實現(xiàn)的JOIN語法經(jīng)過幾次調(diào)整后，現(xiàn)在的版本也已經(jīng)十分美觀：

JoinBuilder.from(    new StudentQuery("t1", parameter)        .selectAll()        .where.age().eq(34)        .end()).join(    new HomeAddressQuery("t2", parameter)        .where.address().like("address")        .end()).on(    l -> l.where.homeAddressId(),    r -> r.where.id()).endJoin().build(); 

其中利用Lambada語句表達(dá)JOIN條件的設(shè)計即充分符合了Java開發(fā)者的習(xí)慣，又很好的匹配了IDE語法提示的需要，細(xì)思極妙。

Fluent MyBatis中的流可以設(shè)置條件過濾，例如“僅更新值為非空的字段”：

new StudentUpdate()    .update.name().is(student.getName(), If::notBlank)    .set.phone().is(student.getPhone(), If::notBlank)    .set.email().is(student.getEmail(), If::notBlank)    .set.gender().is(student.getGender(), If::notNull)    .end()    .where.id().eq(student.getId()).end(); 

上面這段代碼等效于MyBatis中的如下XML內(nèi)容：

顯然Java的流式代碼可讀性遠(yuǎn)高于XML文件的尖括號套尖括號的層疊結(jié)構(gòu)。

流是可續(xù)接的，對于更復(fù)雜的分支條件，F(xiàn)luent MyBatis中能利用譬如下述語句，充分發(fā)揮出Java代碼的靈活性：

StudentQuery studentQuery = Refs.Query.student.aliasQuery()    .select.age().end()    .where.age().isNull().end()    .groupBy.age().apply("id").end();if (config.shouldFilterAge()) {    studentQuery.having.max.age().gt(1L).end();} else if (config.shouldOrder()) {    studentQuery.orderBy.id().desc().end();} 

這種基于外部變量狀態(tài)的判斷，已然超出了MyBatis的XML文件的能力范圍。

三 三分鐘源碼淺析

Fluent MyBatis的代碼由Fluent Generator和Fluent MyBatis兩個子項目組成。這對組合與MyBatis Generator搭檔MyBatis Dynamic SQL有異曲同工之妙：Fluent Generator通過讀取數(shù)據(jù)庫里的表，自動生成Fluent MyBatis所需的Entity和Dao對象；Fluent MyBatis提供編寫SQL語句的函數(shù)式DSL。

Fluent Generator子項目的代碼顯得樸實而平鋪直述，程序入口在包結(jié)構(gòu)樹最外層的FileGenerator類型里，由開發(fā)者直接調(diào)用該類的build()方法，使用鏈?zhǔn)綐?gòu)造器方式傳入需讀取的表名和存放生成文件的目錄等配置。Fluent Generator根據(jù)這些信息從數(shù)據(jù)庫里讀取出表結(jié)構(gòu)，然后為每張表生成Entity和Dao類型的Java文件，放置到約定位置，整個邏輯一氣呵成。值得一提的是，F(xiàn)luent Generator的配置方法是完全代碼化的，相比MyBatis Generator雖支持純代碼化配置，卻在官方示例繼續(xù)沿用XML文件配置輸入的作風(fēng)更勝一籌。

Fluent Generator生成的Dao類型默認(rèn)是空的類，它只是一種推薦的數(shù)據(jù)查詢層結(jié)構(gòu)，通過繼承各自的BaseDao類型，獲得便捷操作Mapper的能力。

Fluent MyBatis子項目的代碼要稍顯豐盈一些，分為三個模塊：

fluent-mybatis 包含各種公共基礎(chǔ)類
fluent-mybatis-test 測試用例
fluent-mybatis-processor 編譯期代碼生成器
fluent-mybatis模塊定義了與代碼生成相關(guān)的注解、數(shù)據(jù)模型和其他輔助類型，它們大多都是幕后英雄：開發(fā)者通常不會直接用到這個包中的類。

fluent-mybatis-test模塊包含豐富的測試用例，在一定程度上彌補了Fluent MyBatis當(dāng)前階段尚不完備的文檔。平時遇到的許多Fluent MyBatis使用問題，若在文檔上無法找到，那么翻一翻代碼庫的測試用例，一定會有意外的收獲。

fluent-mybatis-processor模塊的原理與Lombook工具庫類似，但它并不修改原有的類型，而是掃描Entity類型上的注解，然后動態(tài)產(chǎn)生新的輔助類。Fluent Generator產(chǎn)出的Entity類就像是潘多拉盒子，蘊含著Fluent MyBatis魔法的秘密。FluentMybatisProcessor類是整場表演的魔術(shù)師，它將每個形如XyzEntity的實體類變幻出一系列輔助類，其中比較關(guān)鍵的包括：

XyzBaseDao：繼承BaseDao類型，實現(xiàn)IBaseDao接口，包含獲得Entity相關(guān)Mapper、Query、Update類型的方法，是Fluent Generator為用戶生成的空白Dao類的父類。
XyzMapper：實現(xiàn)IEntityMapper，IRichMapper、IWrapperMapper接口，用于構(gòu)造Query和Update對象，以及執(zhí)行IQuery或IUpdate類型的SQL指令。
XyzQuery：繼承BaseWrapper、BaseQuery類型，實現(xiàn)IWrapper、IQuery接口，用于組裝查詢語句的基本容器。
XyzUpdate：繼承BaseWrapper、BaseUpdate類型，實現(xiàn)IWrapper、IBaseUpdate接口，用于組裝更新語句的基本容器。
XyzSqlProvider：繼承BaseSqlProvider類型，用于最終組裝SQL語句。
還有XyzMapping、XyzDefaults、XyzFormSetter、XyzEntityHelper：、XyzWrapperHelper等。由fluent-mybatis-processor模塊生成的許多類型都會在編寫業(yè)務(wù)代碼的時候用到。
一個典型的Fluent MyBatis工作流程是先通過生成的Query或Update類型組裝出執(zhí)行對象，然后交給Mapper對象下發(fā)執(zhí)行。譬如：

// 構(gòu)造并執(zhí)行查詢語句List<StudentEntity> users = mapper.listEntity(    new StudentQuery()        .select.name().score().end()        .where.userName().like("user").end()        .orderBy.id().asc().end()        .limit(20, 10));// 構(gòu)造并執(zhí)行更新語句int effectedRecordCount = mapper.updateBy(    new StudentUpdate()        .set.userName().is("u2")        .set.isDeleted().is(true)        .set.homeAddressId().isNull().end()        .where.isDeleted().eq(false).end()); 

Query和Update類型不僅實現(xiàn)IQuery/IUpdate接口，還實現(xiàn)了IWrapper接口，前者用于組裝對象，后者用于讀取對象內(nèi)容，這是一處很有心的設(shè)計。Mapper類型中的許多方法都能接收IQuery或IUpdate接口類型的對象，再通過方法上的@InsertProvider、@SelectProvider、@UpdateProvider或@DeleteProvider注解把實際請求轉(zhuǎn)給生成的Provider類型。Provider們從約定的Map參數(shù)中取出傳入的IWrapper執(zhí)行對象，使用MapperSql工具類組裝SQL語句，最后交給MyBatis執(zhí)行。

在Mapper里也有一些直接接受Map對象的方法，可以省去用IQuery/IUpdate描述SQL的過程，進(jìn)行簡單的插入和查詢。傳入的原始Map對象同樣會在Provider里被讀取出來，用MapperSql組裝SQL語句，再交給MyBatis執(zhí)行。

Fluent MyBatis的這種基于Provider機制的實現(xiàn)方式不僅能為用戶提供流暢的SQL構(gòu)造體驗，也能充分復(fù)用MyBatis原生的諸多優(yōu)點，譬如豐富的DB連接器、健全的防SQL注入機制等等，從而確保核心邏輯的穩(wěn)定可靠。