比MyBatis效率快100倍的條件檢索引擎

1 開源項目簡介

比 MyBatis 效率快 100 倍的條件檢索引擎，天生支持聯(lián)表，使一行代碼實現(xiàn)復雜列表檢索成為可能！

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

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

2 開源協(xié)議

使用Apache-2.0開源協(xié)議

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

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

3 界面展示

你的產(chǎn)品給你畫了以上一張圖，還附帶了一些要求：

• 檢索結(jié)果分頁展示
• 可以按任意字段排序
• 按檢索條件統(tǒng)計某些字段值

這時候，后臺接口該怎么寫？？？使用 Mybatis 或 Hibernate 寫 100 行代碼是不是還打不??？而使用 Bean Searcher，只需 一行代碼 便可實現(xiàn)上述要求?。?！

4 功能概述

特性

• 支持 實體多表映射
• 支持 動態(tài)字段運算符
• 支持 分組聚合 查詢
• 支持 Select | Where | From 子查詢
• 支持 實體類嵌入?yún)?shù)
• 支持 字段轉(zhuǎn)換器
• 支持 Sql 攔截器
• 支持 數(shù)據(jù)庫 Dialect 擴展
• 支持 多數(shù)據(jù)源 與 動態(tài)數(shù)據(jù)源
• 支持 注解缺省 與 自定義
• 支持 字段運算符 擴展
• 等等

快速開發(fā)

使用 Bean Searcher 可以極大節(jié)省后端的復雜列表檢索接口的開發(fā)時間

集成簡單

可以和任意 Java Web 框架集成，如：SpringBoot、Grails、Jfinal 等

擴展性強

面向接口設計，用戶可自定義擴展 Bean Searcher 中的任何組件

支持 注解缺省

約定優(yōu)于配置，可省略注解，可復用原有域類，同時支持自定義注解

支持 多數(shù)據(jù)源

分庫分表？在這里特別簡單，告別分庫分表帶來的代碼熵值增高問題

支持 Select 指定字段

同一個實體類，可指定只 Select 其中的某些字段，或排除某些字段

支持 參數(shù)過濾器

支持添加多個參數(shù)過濾器，可自定義參數(shù)過濾規(guī)則

支持 字段轉(zhuǎn)換器

支持添加多個字段轉(zhuǎn)換器，可自定義數(shù)據(jù)庫字段到實體類字段的轉(zhuǎn)換規(guī)則

支持 SQL 攔截器

支持添加多個 SQL 攔截器，可自定義 SQL 生成規(guī)則

5 技術選型

• 框架目的：只一行代碼實現(xiàn)：多表聯(lián)查分頁搜索任意字段組合過濾任意字段排序多字段統(tǒng)計
• 架構圖：

為什么用

這絕不是一個重復的輪子

雖然 增刪改 是 hibernate 和 mybatis、data-jdbc 等等 ORM 的強項，但查詢，特別是有 多條件、聯(lián)表、分頁、排序 的復雜的列表查詢，卻一直是它們的弱項。

傳統(tǒng)的 ORM 很難用較少的代碼實現(xiàn)一個復雜的列表檢索，但 Bean Searcher 卻在這方面下足了功夫，這些復雜的查詢，幾乎只用一行代碼便可以解決。

• 例如，這樣的一個典型的需求：

后端需要寫一個檢索接口，而如果用傳統(tǒng)的 ORM 來寫，代碼之復雜是可以想象的。

而 Bean Searcher 卻可以：

只一行代碼實現(xiàn)以上功能

首先，你有一個實體類：

复制@SearchBean(tables="useru,roler",joinCond="u.role_id=r.id",autoMapTo="u")

publicclassUser{
privatelongid;
privateStringusername;
privateintstatus;
privateintage;
privateStringgender;
privateDatejoinDate;
privateintroleId;
@DbField("r.name")
privateStringroleName;
//Gettersandsetters...
}

然后你就可以用一行代碼實現(xiàn)這個用戶檢索接口：

复制@RestController
@RequestMapping("/user")
publicclassUserController{

@Autowired
privateBeanSearcherbeanSearcher;//注入BeanSearcher的檢索器

@GetMapping("/index")
publicSearchResultindex(HttpServletRequestrequest){
//這里只寫一行代碼
returnbeanSearcher.search(User.class,MapUtils.flat(request.getParameterMap()),newString[]{"age"});
}

}

這一行代碼實現(xiàn)了以下功能：

• 多表聯(lián)查
• 分頁搜索
• 組合過濾
• 任意字段排序
• 字段統(tǒng)計

例如，該接口支持如下請求：

• GET: /user/index
• 無參請求（默認分頁）:
• { "dataList": [ { "id": 1, "username": "Jack", "status": 1, "level": 1, "age": 25, "gender": "Male", "joinDate": "2021-10-01" }, ... // 默認返回 15 條數(shù)據(jù) ], "totalCount": 100, "summaries": [ 2500 // age 字段統(tǒng)計 ] }
• GET: /user/index? page=1 & size=10
• 指定分頁參數(shù)
• GET: /user/index? status=1
• 返回 status = 1 的用戶
• GET: /user/index? name=Jac & name-op=sw
• 返回 name 已 Jac 開頭的用戶
• GET: /user/index? name=Jack & name-ic=true
• 返回 name = Jack（忽略大小寫）的用戶
• GET: /user/index? sort=age & order=desc
• 按字段 age 降序查詢
• GET: /user/index? onlySelect=username,age
• 只檢索 username 與 age 兩個字段:
• { "dataList": [ { "username": "Jack", "age": 25 }, ... ], "totalCount": 100, "summaries": [ 2500 ] }
• GET: /user/index? selectExclude=joinDate
• 檢索時排除 joinDate 字段

參數(shù)構建器

复制Mapparams=MapUtils.builder()
.selectExclude(User::getJoinDate)//排除joinDate字段
.field(User::getStatus,1)//過濾：status=1
.field(User::getName,"Jack").ic()//過濾：name='Jack'(caseignored)
.field(User::getAge,20,30).op(Opetator.Between)//過濾：agebetween20and30
.orderBy(User::getAge,"asc")//排序：年齡，從小到大
.page(0,15)//分頁：第0頁,每頁15條
.build();
Listusers=beanSearcher.searchList(User.class,params);

快速開發(fā)

使用 Bean Searcher 可以極大地節(jié)省后端的復雜列表檢索接口的開發(fā)時間！

• 普通的復雜列表查詢只需一行代碼
• 單表檢索可復用原有 Domain，無需定義 SearchBean

集成簡單

可以和任意 Java Web 框架集成，如：SpringBoot、Spring MVC、Grails、Jfinal 等等。

Spring Boot 項目，添加依賴即集成完畢：

复制implementation'com.ejlchina3.6.0'

接著便可在 Controller 或 Service 里注入檢索器：

复制/**
*注入Map檢索器，它檢索出來的數(shù)據(jù)以Map對象呈現(xiàn)
*/
@Autowired
privateMapSearchermapSearcher;

/**
*注入Bean檢索器，它檢索出來的數(shù)據(jù)以泛型對象呈現(xiàn)
*/
@Autowired
privateBeanSearcherbeanSearcher;

其它框架，使用如下依賴：

复制implementation'com.ejlchina3.6.0'

然后可以使用 SearcherBuilder 構建一個檢索器：

复制DataSourcedataSource=...//拿到應用的數(shù)據(jù)源

//DefaultSqlExecutor也支持多數(shù)據(jù)源
SqlExecutorsqlExecutor=newDefaultSqlExecutor(dataSource);

//構建Map檢索器
MapSearchermapSearcher=SearcherBuilder.mapSearcher()
.sqlExecutor(sqlExecutor)
.build();

//構建Bean檢索器
BeanSearcherbeanSearcher=SearcherBuilder.beanSearcher()
.sqlExecutor(sqlExecutor)
.build();

擴展性強

面向接口設計，用戶可自定義擴展 Bean Searcher 中的任何組件！

比如你可以：

• 自定義 FieldOp 來支持更多的字段運算符
• 自定義 FieldConvertor 來支持任意的 特殊字段類型
• 自定義 DbMapping 來實現(xiàn)自定義注解，或讓 Bean Searcher 識別其它 ORM 的注解
• 自定義 ParamResolver 來支持其它形式的檢索參數(shù)
• 自定義 Dialect 來支持更多的數(shù)據(jù)庫
• 等等..

6 源碼地址

• Gitee：https://gitee.com/ejlchina-zhxu/bean-searcher
• GitHub：https://github.com/ejlchina/bean-searcher

審核編輯 ：李倩