Fluent Mybatis快速入門詳細(xì)教程

更新時(shí)間：2021年08月04日 16:18:34 作者：qq2762730786

由于FluentMybatis是基于mybatis上做封裝和擴(kuò)展的，所以這里主要聊聊mybatis處理的方式，以及給出FluentMybatis的解放方案。對(duì)Fluent Mybatis入門相關(guān)知識(shí)感興趣的朋友一起看看吧

使用fluent mybatis可以不用寫具體的xml文件，通過(guò)java api可以構(gòu)造出比較復(fù)雜的業(yè)務(wù)sql語(yǔ)句，做到代碼邏輯和sql邏輯的合一。不再需要在Dao中組裝查詢或更新操作，在xml或mapper中再組裝參數(shù)。喜歡的朋友可以閱讀這篇文章 http://www.fzitv.net/article/218884.htm

對(duì)底層數(shù)據(jù)表關(guān)聯(lián)關(guān)系的處理，我們總是繞不開什么一對(duì)一，一對(duì)多，多對(duì)多這里比較煩人的關(guān)系。業(yè)界優(yōu)秀的ORM框架也都給出了自己的答案，簡(jiǎn)單來(lái)說(shuō)就以下幾種方式：

hibernate和JPA對(duì)開發(fā)基本屏蔽了底層數(shù)據(jù)的處理，只需要在model層設(shè)置數(shù)據(jù)級(jí)聯(lián)關(guān)系即可。但這種設(shè)置也往往是噩夢(mèng)的開始。
mybatis 提供了簡(jiǎn)單的@One @Many注解，然后編寫xml映射關(guān)系來(lái)提供級(jí)聯(lián)處理。
還有一種就是干脆不依賴框架，直接應(yīng)用自己掌控。
因?yàn)镕luentMybatis是基于mybatis上做封裝和擴(kuò)展的，所以這里主要聊聊mybatis處理的方式，以及給出FluentMybatis的解放方案。

那么就可以建以下3張表：

數(shù)據(jù)字典

CREATE TABLE t_member
(
id bigint(21) unsigned auto_increment primary key COMMENT ‘主鍵id',
user_name varchar(45) DEFAULT NULL COMMENT ‘名字',
is_girl tinyint(1) DEFAULT 0 COMMENT ‘0:男孩; 1:女孩',
age int DEFAULT NULL COMMENT ‘年齡',
school varchar(20) DEFAULT NULL COMMENT ‘學(xué)校',
gmt_created datetime DEFAULT NULL COMMENT ‘創(chuàng)建時(shí)間',
gmt_modified datetime DEFAULT NULL COMMENT ‘更新時(shí)間',
is_deleted tinyint(1) DEFAULT 0 COMMENT ‘是否邏輯刪除'
) ENGINE = InnoDB
CHARACTER SET = utf8 COMMENT = ‘成員表:女孩或男孩信息';

CREATE TABLE t_member_love
(
id bigint(21) unsigned auto_increment primary key COMMENT ‘主鍵id',
girl_id bigint(21) NOT NULL COMMENT ‘member表外鍵',
boy_id bigint(21) NOT NULL COMMENT ‘member表外鍵',
status varchar(45) DEFAULT NULL COMMENT ‘狀態(tài)',
gmt_created datetime DEFAULT NULL COMMENT ‘創(chuàng)建時(shí)間',
gmt_modified datetime DEFAULT NULL COMMENT ‘更新時(shí)間',
is_deleted tinyint(2) DEFAULT 0 COMMENT ‘是否邏輯刪除'
) ENGINE = InnoDB
CHARACTER SET = utf8 COMMENT = ‘成員戀愛關(guān)系';

CREATE TABLE t_member_favorite
(
id bigint(21) unsigned auto_increment primary key COMMENT ‘主鍵id',
member_id bigint(21) NOT NULL COMMENT ‘member表外鍵',
favorite varchar(45) DEFAULT NULL COMMENT ‘愛好: 電影, 爬山, 徒步…',
gmt_created datetime DEFAULT NULL COMMENT ‘創(chuàng)建時(shí)間',
gmt_modified datetime DEFAULT NULL COMMENT ‘更新時(shí)間',
is_deleted tinyint(2) DEFAULT 0 COMMENT ‘是否邏輯刪除'
) ENGINE = InnoDB
CHARACTER SET = utf8 COMMENT = ‘成員愛好';

添加項(xiàng)目Maven依賴
具體pom.xml文件

代碼生成

public class AppEntityGenerator {


static final String url = “jdbc:mysql://localhost:3306/fluent_mybatis_demo?useSSL=false&useUnicode=true&characterEncoding=utf-8”;
/**
* 生成代碼的package路徑
*/
static final String basePackage = “cn.org.fluent.mybatis.many2many.demo”;

public static void main(String[] args) {
    FileGenerator.build(Noting.class);
}

@Tables(
    /** 數(shù)據(jù)庫(kù)連接信息 **/
    url = url, username = "root", password = "password",
    /** Entity類parent package路徑 **/
    basePack = basePackage,
    /** Entity代碼源目錄 **/
    srcDir = "example/many2many_demo/src/main/java",
    /** 如果表定義記錄創(chuàng)建，記錄修改，邏輯刪除字段 **/
    gmtCreated = "gmt_create", gmtModified = "gmt_modified", logicDeleted = "is_deleted",
    /** 需要生成文件的表 ( 表名稱:對(duì)應(yīng)的Entity名稱 ) **/
    tables = @Table(value = {"t_member", "t_member_love", "t_member_favorite"}, tablePrefix = "t_")
)
static class Noting {
}}

這樣就生成了3個(gè)Entity類: MemberEntity, MemberFavoriteEntity, MemberLoveEntity。

關(guān)系分析

現(xiàn)在我們來(lái)理一理這里面的關(guān)系

一對(duì)多: 一個(gè)成員可以有多個(gè)愛好
多對(duì)多: 一個(gè)成員可以有多個(gè)男女朋友(前任+現(xiàn)任)
一對(duì)一: 一個(gè)成員只能有一個(gè)現(xiàn)任男女朋友
mybatis處理手法
mybatis提供了@One 和 @Many的注解來(lái)處理簡(jiǎn)單(只有主鍵和外鍵依賴)的一對(duì)一，和一對(duì)多的關(guān)系具體到上面的關(guān)系，mybatis只能關(guān)聯(lián)查詢成員的愛好，對(duì)帶條件的(不是只通過(guò)外鍵)現(xiàn)任男女朋友的一對(duì)一也沒(méi)有辦法處理。

我這里就不具體展開mybatis的配置語(yǔ)法了，感興趣讀者可以看下下面文章:

Mybatis一對(duì)多、多對(duì)一處理

Mybatis傳遞多個(gè)參數(shù)進(jìn)行SQL查詢的用法

MyBatis注解 & 多對(duì)一、一對(duì)多

MyBatis系列4：一對(duì)一,一對(duì)多,多對(duì)多查詢及延遲加載(N+1問(wèn)題)分析

鑒于mybatis只能處理簡(jiǎn)單的關(guān)聯(lián)關(guān)系，fluent mybatis就沒(méi)有直接封裝mybatis的處理方式，那fluent mybatis是如何處理上述的關(guān)聯(lián)關(guān)系的。我們先從mybatis也可以處理的一對(duì)多的愛好列表入手

一對(duì)多的愛好列表處理
fluent mybatis要根據(jù)MemberEntity自動(dòng)返回對(duì)應(yīng)的愛好列表，需要下面幾個(gè)設(shè)置:

MemberEntity繼承RichEntity基類
在MemberEntity類里面增加方法 findMyFavorite()
給findMyFavorite方法加上注解 @RefMethod
在注解中增加關(guān)聯(lián)關(guān)系: “memberId=id”，意思是 MemberFavoriteEntity.memberId等于MemberEntity.id
具體代碼片段如下, 所有這些操作都可以通過(guò)代碼生成，這里手工添加僅僅是為了講解

public class MemberEntity extends RichEntity implements IEntity {
// …
/**
* 我的愛好列表
*
* @return
*/
@RefMethod(“memberId=id”)
public List findMyFavorite() {
return super.loadCache(“findMyFavorite”, MemberEntity.class);
}
}

好了，我們已經(jīng)建立好通過(guò)Member實(shí)例查詢愛好列表的功能了，重新編譯項(xiàng)目在generated-sources目錄下面，會(huì)多出一個(gè)文件: Refs

/**
*

Refs:o - 查詢器，更新器工廠類單例引用o - 應(yīng)用所有Mapper Bean引用o - Entity關(guān)聯(lián)對(duì)象延遲加載查詢實(shí)現(xiàn)@author powered by FluentMybatis
*/
public abstract class Refs extends EntityRefQuery {
public List findMyFavoriteOfMemberEntity(MemberEntity entity) {
return memberFavoriteMapper.listEntity(new MemberFavoriteQuery()
.where.memberId().eq(entity.getId())
.end());
}
}

在這個(gè)類里面自動(dòng)生成了一個(gè)方法: findMyFavoriteOfMemberEntity, 入?yún)⑹荕emberEntity, 出參是List，實(shí)現(xiàn)里面根據(jù)member的id查詢了成員的所有愛好。

增加Spring Bean
我們新建一個(gè)類: AllRelationQuery (名稱根據(jù)你的喜好和業(yè)務(wù)隨便取), 繼承Refs, 并把AllRelationQuery加入Spring管理即可。

@Service
public class AllRelationQuery extends Refs {
}

老套路，寫個(gè)測(cè)試驗(yàn)證下

@RunWith(SpringRunner.class)
@SpringBootTest(classes = Application.class)
public class FindMemberFavoriteTest {
@Autowired
private MemberMapper memberMapper;

@Before
public void setup() {
    // 省略數(shù)據(jù)準(zhǔn)備部分
}

@Test
public void findMyFavorite() {
    MemberEntity member = memberMapper.findById(1L);
    List<MemberFavoriteEntity> favorites = member.findMyFavorite();
    System.out.println("愛好項(xiàng): " + favorites.size());
}


}

查看控制臺(tái)log輸出

DEBUG - ==> Preparing: SELECT id, …, user_name FROM t_member WHERE id = ?
DEBUG - > Parameters: 1(Long)
DEBUG - < Total: 1
DEBUG - ==> Preparing: SELECT id, …, member_id FROM t_member_favorite WHERE member_id = ?
DEBUG - > Parameters: 1(Long)
DEBUG - < Total: 2
愛好項(xiàng): 2

如日志所示，F(xiàn)luent Mybatis按照預(yù)期返回了愛好列表。

給一對(duì)多關(guān)系添點(diǎn)油加點(diǎn)醋
做過(guò)業(yè)務(wù)系統(tǒng)的同學(xué)都知道，數(shù)據(jù)庫(kù)中業(yè)務(wù)數(shù)據(jù)一般會(huì)有一個(gè)邏輯刪除標(biāo)識(shí)，按照上述邏輯查詢出來(lái)的數(shù)據(jù)，我們會(huì)把已經(jīng)廢棄(邏輯刪除掉)的愛好也一并查詢出來(lái)了，那我們?nèi)绾沃徊樵兂鑫催壿媱h除(is_deleted=0)的愛好列表呢。

如果采用mybatis的方案，那我們只能聳聳肩，攤開雙手說(shuō): “愛莫能助，你自己寫SQL實(shí)現(xiàn)吧”，但fluent mybatis對(duì)這類場(chǎng)景的支持的很好，我們只要給@RefMethod注解值加點(diǎn)條件就可以了, MemberFavoriteEntity.memberId=MemberEntity.id并且Favorite的邏輯刪除標(biāo)識(shí)和Member表一樣，具體定義如下:

public class MemberEntity extends RichEntity implements IEntity {
@RefMethod(“memberId=id && isDeleted=isDeleted”)
public List findMyFavorite() {
return super.loadCache(“findMyFavorite”, MemberEntity.class);
}
}

重新編譯項(xiàng)目，觀察Refs代碼

public abstract class Refs extends EntityRefQuery {
public List findMyFavoriteOfMemberEntity(MemberEntity entity) {
return memberFavoriteMapper.listEntity(new MemberFavoriteQuery()
.where.isDeleted().eq(entity.getIsDeleted())
.and.memberId().eq(entity.getId())
.end());
}
}

查詢條件上帶上了邏輯刪除條件

跑測(cè)試，看log

DEBUG - ==> Preparing: SELECT id, …, user_name FROM t_member WHERE id = ?
DEBUG - > Parameters: 1(Long)
DEBUG - < Total: 1
DEBUG - ==> Preparing: SELECT id, …, member_id FROM t_member_favorite
WHERE is_deleted = ?
AND member_id = ?
DEBUG - > Parameters: false(Boolean), 1(Long)
DEBUG - < Total: 2
愛好項(xiàng): 2

FluentMybatis輕松處理了多條件關(guān)聯(lián)的一對(duì)多關(guān)系, 這個(gè)在業(yè)務(wù)中不僅僅限定于邏輯刪除，還可以推廣到部署環(huán)境標(biāo)識(shí)(deploy_env), 租戶關(guān)系等條件上，還有只有你業(yè)務(wù)中才用到的狀態(tài)相關(guān)的關(guān)系上。

Fluent Mybatis對(duì)多對(duì)多關(guān)系處理
fluent mybatis可以輕松處理一對(duì)一，一對(duì)多的簡(jiǎn)單和多條件的關(guān)聯(lián)關(guān)系，但對(duì)多對(duì)多也沒(méi)有提供自動(dòng)化代碼生成的處理手段。因?yàn)槎鄬?duì)多，本質(zhì)上涉及到3張表， A表， B表，AB關(guān)聯(lián)表。但fluent mybatis還是提供了半自動(dòng)手段，對(duì)這類場(chǎng)景進(jìn)行了支持，比如我們需要MemberEntity中返回所有前任戀人列表。

在MemberEntity中定義方法: exFriends()

public class MemberEntity extends RichEntity implements IEntity {
/**
* 前任男(女)朋友列表
*
* @return
*/
@RefMethod
public List findExFriends() {
return super.loadCache(“findExFriends”, MemberEntity.class);
}
}

和上面的自動(dòng)化的一對(duì)多關(guān)系有個(gè)區(qū)別，@RefMethod上沒(méi)有設(shè)置查詢條件，我們重新編譯項(xiàng)目。我們觀察Refs類，除了剛才的findMyFavoriteOfMemberEntity方法實(shí)現(xiàn)外，還多出一個(gè)抽象方法: findExFriendsOfMemberEntity

public abstract class Refs extends EntityRefQuery {
/**
* 返回前任男(女)朋友列表
*/
public abstract List findExFriendsOfMemberEntity(MemberEntity entity);
}

在動(dòng)手實(shí)現(xiàn)代碼前，我們先分析一下混亂的男女朋友關(guān)系
在member表上，我們使用了一個(gè)性別字段 is_girl來(lái)區(qū)別是男的還是女的，在戀愛關(guān)系表上，分別有2個(gè)外鍵girl_id, boy_id來(lái)標(biāo)識(shí)一對(duì)戀人關(guān)系。這樣，如果member是女的，要查詢所有前任男朋友，那么sql語(yǔ)句就如下：

select * from t_member
where is_deleted=0
and id in (select boy_id from t_memeber_love
where status = ‘前任'
and girl_id = ? – 女孩id
and is_deleted = 0
)

如果member是男的，要查詢所有前任女朋友，那么sql語(yǔ)句條件就要倒過(guò)來(lái)：

select * from t_member
where is_deleted=0
and id in (select girl_id from t_memeber_love
where status = ‘前任'
and boy_id= ? – 男孩id
and is_deleted = 0
)

實(shí)現(xiàn)查詢前男（女）朋友列表功能
一般來(lái)說(shuō)，為了實(shí)現(xiàn)上面的分支查詢，在mybatis的xml文件中需要配置這樣的標(biāo)簽代碼分支，或者在java代碼中實(shí)現(xiàn) if(…){}else{}的代碼邏輯分支。那我們來(lái)看看fluent mybatis時(shí)如何實(shí)現(xiàn)上述查詢的呢？我們就可以在剛才定義的Refs子類上實(shí)現(xiàn)findExFriendsOfMemberEntity自己的邏輯。

@Service
public class AllRelationQuery extends Refs {
@Override
public List findExFriendsOfMemberEntity(MemberEntity entity) {
MemberQuery query = new MemberQuery()
.where.isDeleted().isFalse()
.and.id().in(MemberLoveQuery.class, q -> q
.select(entity.getIsGirl() ? boyId.column : girlId.column)
.where.status().eq(“前任”)
.and.isDeleted().isFalse()
.and.girlId().eq(entity.getId(), o -> entity.getIsGirl())
.and.boyId().eq(entity.getId(), o -> !entity.getIsGirl())
.end())
.end();
return memberMapper.listEntity(query);
}
}

寫測(cè)試看log

@RunWith(SpringRunner.class)
@SpringBootTest(classes = Application.class)
public class FindExFriendsTest {
@Autowired
private MemberMapper memberMapper;

@Test
public void findExBoyFriends() {
    MemberEntity member = memberMapper.findById(1L);
    System.out.println("是否女孩:" + member.getIsGirl());
    List<MemberEntity> boyFriends = member.findExFriends();
    System.out.println(boyFriends);
}


}

控制臺(tái)日志

DEBUG - ==> Preparing: SELECT id, …, user_name FROM t_member WHERE id = ?
DEBUG - > Parameters: 1(Long)
DEBUG - < Total: 1
是否女孩:true
DEBUG - ==> Preparing: SELECT id, …, user_name FROM t_member
WHERE is_deleted = ?
AND id IN (SELECT boy_id
FROM t_member_love
WHERE status = ?
AND is_deleted = ?
AND girl_id = ?)
DEBUG - > Parameters: false(Boolean), 前任(String), false(Boolean), 1(Long)
DEBUG - < Total: 1
[MemberEntity(id=2, gmtModified=Sun Nov 08 12:31:57 CST 2020, isDeleted=false, age=null, gmtCreated=null, isGirl=false, school=null, userName=mike)]

如日志所示，在查詢前男友列表是，條件會(huì)根據(jù)Member的是否是女孩進(jìn)行分支切換，這也是fluent mybatis動(dòng)態(tài)條件強(qiáng)大的地方。

到此這篇關(guān)于FluentMybatis快速入門詳細(xì)教程的文章就介紹到這了,更多相關(guān)Fluent Mybatis入門內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: