1

開(kāi)源項(xiàng)目簡(jiǎn)介

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

?

2

開(kāi)源協(xié)議

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

?

3

界面展示

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

• 檢索結(jié)果分頁(yè)展示

• 可以按任意字段排序

• 按檢索條件統(tǒng)計(jì)某些字段值

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

4

功能概述

特性

• 支持?實(shí)體多表映射

• 支持?動(dòng)態(tài)字段運(yùn)算符

• 支持?分組聚合 查詢(xún)

• 支持?Select | Where | From 子查詢(xún)

• 支持?實(shí)體類(lèi)嵌入?yún)?shù)

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

• 支持?Sql 攔截器

• 支持?數(shù)據(jù)庫(kù) Dialect 擴(kuò)展

• 支持?多數(shù)據(jù)源 與 動(dòng)態(tài)數(shù)據(jù)源

• 支持?注解缺省 與 自定義

• 支持?字段運(yùn)算符 擴(kuò)展

• 等等

快速開(kāi)發(fā)

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

集成簡(jiǎn)單

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

擴(kuò)展性強(qiáng)

面向接口設(shè)計(jì)，用戶(hù)可自定義擴(kuò)展 Bean Searcher 中的任何組件

支持 注解缺省

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

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

分庫(kù)分表？在這里特別簡(jiǎn)單，告別分庫(kù)分表帶來(lái)的代碼熵值增高問(wèn)題

支持 Select 指定字段

同一個(gè)實(shí)體類(lèi)，可指定只 Select 其中的某些字段，或排除某些字段

支持 參數(shù)過(guò)濾器

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

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

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

支持 SQL 攔截器

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

5

技術(shù)選型

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

• 架構(gòu)圖：

為什么用

這絕不是一個(gè)重復(fù)的輪子

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

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

• 例如，這樣的一個(gè)典型的需求：

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

而 Bean Searcher 卻可以：

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

首先，你有一個(gè)實(shí)體類(lèi)：

@SearchBean(tables="user u, role r", joinCond="u.role_id = r.id", autoMapTo="u")

public?class?User?{
??private?long?id;
??private?String username;
??private?int?status;
??private?int?age;
??private?String gender;
??private?Date joinDate;
??private?int?roleId;
??@DbField("r.name")
??private?String roleName;
??// Getters and setters...
}

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

@RestController
@RequestMapping("/user")
public?class?UserController?{

????@Autowired
????private?BeanSearcher beanSearcher;?// 注入 BeanSearcher 的檢索器

????@GetMapping("/index")
????public?SearchResult?index(HttpServletRequest request)?{
????????// 這里只寫(xiě)一行代碼
????????return?beanSearcher.search(User.class, MapUtils.flat(request.getParameterMap()),?new?String[]{?"age"?});
????}
??
}

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

• 多表聯(lián)查

• 分頁(yè)搜索

• 組合過(guò)濾

• 任意字段排序

• 字段統(tǒng)計(jì)

例如，該接口支持如下請(qǐng)求：

• GET: /user/index

• 無(wú)參請(qǐng)求（默認(rèn)分頁(yè)）:

• { "dataList":?[ { "id":?1, "username":?"Jack", "status":?1, "level":?1, "age":?25, "gender":?"Male", "joinDate":?"2021-10-01"?},?...?//?默認(rèn)返回?15?條數(shù)據(jù)?], "totalCount":?100, "summaries":?[?2500?//?age?字段統(tǒng)計(jì)?] }

• GET: /user/index? page=1 & size=10

• 指定分頁(yè)參數(shù)

• GET: /user/index? status=1

• 返回?status = 1?的用戶(hù)

• GET: /user/index? name=Jac & name-op=sw

• 返回?name?已?Jac?開(kāi)頭的用戶(hù)

• GET: /user/index? name=Jack & name-ic=true

• 返回?name = Jack（忽略大小寫(xiě)）的用戶(hù)

• GET: /user/index? sort=age & order=desc

• 按字段?age?降序查詢(xún)

• GET: /user/index? onlySelect=username,age

• 只檢索?username?與?age?兩個(gè)字段:

• { "dataList":?[ { "username":?"Jack", "age":?25?},?...?], "totalCount":?100, "summaries":?[?2500?] }

• GET: /user/index? selectExclude=joinDate

• 檢索時(shí)排除?joinDate?字段

參數(shù)構(gòu)建器

Map params = MapUtils.builder()
????????.selectExclude(User::getJoinDate)?// 排除 joinDate 字段
????????.field(User::getStatus,?1)?// 過(guò)濾：status = 1
????????.field(User::getName,?"Jack").ic()?// 過(guò)濾：name = 'Jack' (case ignored)
????????.field(User::getAge,?20,?30).op(Opetator.Between)?// 過(guò)濾：age between 20 and 30
????????.orderBy(User::getAge,?"asc")?// 排序：年齡，從小到大
????????.page(0,?15)?// 分頁(yè)：第 0 頁(yè), 每頁(yè) 15 條
????????.build();
List users = beanSearcher.searchList(User.class, params);

快速開(kāi)發(fā)

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

• 普通的復(fù)雜列表查詢(xún)只需一行代碼

• 單表檢索可復(fù)用原有?Domain，無(wú)需定義?SearchBean

集成簡(jiǎn)單

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

Spring Boot 項(xiàng)目，添加依賴(lài)即集成完畢：

implementation?'com.ejlchina:bean-searcher-boot-stater:3.6.0'

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

/**
?* 注入 Map 檢索器，它檢索出來(lái)的數(shù)據(jù)以 Map 對(duì)象呈現(xiàn)
?*/
@Autowired
private?MapSearcher mapSearcher;

/**
?* 注入 Bean 檢索器，它檢索出來(lái)的數(shù)據(jù)以 泛型 對(duì)象呈現(xiàn)
?*/
@Autowired
private?BeanSearcher beanSearcher;

其它框架，使用如下依賴(lài)：

implementation?'com.ejlchina:bean-searcher:3.6.0'

然后可以使用 SearcherBuilder 構(gòu)建一個(gè)檢索器：

DataSource dataSource = ...?// 拿到應(yīng)用的數(shù)據(jù)源

// DefaultSqlExecutor 也支持多數(shù)據(jù)源
SqlExecutor sqlExecutor =?new?DefaultSqlExecutor(dataSource);

// 構(gòu)建 Map 檢索器
MapSearcher mapSearcher = SearcherBuilder.mapSearcher()
????????.sqlExecutor(sqlExecutor)
????????.build();

// 構(gòu)建 Bean 檢索器
BeanSearcher beanSearcher = SearcherBuilder.beanSearcher()
????????.sqlExecutor(sqlExecutor)
????????.build();

擴(kuò)展性強(qiáng)

面向接口設(shè)計(jì)，用戶(hù)可自定義擴(kuò)展 Bean Searcher 中的任何組件！

比如你可以：

• 自定義?FieldOp?來(lái)支持更多的字段運(yùn)算符

• 自定義?FieldConvertor?來(lái)支持任意的 特殊字段類(lèi)型

• 自定義?DbMapping?來(lái)實(shí)現(xiàn)自定義注解，或讓 Bean Searcher 識(shí)別其它 ORM 的注解

• 自定義?ParamResolver?來(lái)支持其它形式的檢索參數(shù)

• 自定義?Dialect?來(lái)支持更多的數(shù)據(jù)庫(kù)

• 等等..

6

源碼地址

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

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