比 MyBatis 效率快 100 倍的条件检索引擎，天生支持联表！

点击上方“芋道源码”，选择“设为星标”

管她前浪，还是后浪？

能浪的浪，才是好浪！

每天 10:33 更新文章，每天掉亿点点头发...

源码精品专栏

 

• 原创 | Java 2021 超神之路，很肝~
  

• 中文详细注释的开源项目
  

• RPC 框架 Dubbo 源码解析

• 网络应用框架 Netty 源码解析
  

• 消息中间件 RocketMQ 源码解析
  

• 数据库中间件 Sharding-JDBC 和 MyCAT 源码解析

• 作业调度中间件 Elastic-Job 源码解析

• 分布式事务中间件 TCC-Transaction 源码解析

• Eureka 和 Hystrix 源码解析

• Java 并发源码

来源：网络

• 1 开源项目简介

• 2 开源协议

• 3 界面展示

• 4 功能概述

• 5 技术选型

• 6 源码地址

---

1 开源项目简介

比 MyBatis 效率快 100 倍的条件检索引擎，天生支持联表，使一行代码实现复杂列表检索成为可能！

基于 Spring Boot + MyBatis Plus + Vue & Element 实现的后台管理系统 + 用户小程序，支持 RBAC 动态权限、多租户、数据权限、工作流、三方登录、支付、短信、商城等功能。

项目地址：https://github.com/YunaiV/ruoyi-vue-pro

2 开源协议

使用Apache-2.0开源协议

基于微服务的思想，构建在 B2C 电商场景下的项目实战。核心技术栈，是 Spring Boot + Dubbo 。未来，会重构成 Spring Cloud Alibaba 。

项目地址：https://github.com/YunaiV/onemall

3 界面展示

你的产品给你画了以上一张图，还附带了一些要求：

• 检索结果分页展示

• 可以按任意字段排序

• 按检索条件统计某些字段值

这时候，后台接口该怎么写？？？使用 Mybatis 或 Hibernate 写 100 行代码是不是还打不住？而使用 Bean Searcher，只需 一行代码 便可实现上述要求！！！

4 功能概述

特性

• 支持 实体多表映射

• 支持 动态字段运算符

• 支持 分组聚合 查询

• 支持 Select | Where | From 子查询

• 支持 实体类嵌入参数

• 支持 字段转换器

• 支持 Sql 拦截器

• 支持 数据库 Dialect 扩展

• 支持 多数据源 与 动态数据源

• 支持 注解缺省 与 自定义

• 支持 字段运算符 扩展

• 等等

快速开发

使用 Bean Searcher 可以极大节省后端的复杂列表检索接口的开发时间

集成简单

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

扩展性强

面向接口设计，用户可自定义扩展 Bean Searcher 中的任何组件

支持 注解缺省

约定优于配置，可省略注解，可复用原有域类，同时支持自定义注解

支持 多数据源

分库分表？在这里特别简单，告别分库分表带来的代码熵值增高问题

支持 Select 指定字段

同一个实体类，可指定只 Select 其中的某些字段，或排除某些字段

支持 参数过滤器

支持添加多个参数过滤器，可自定义参数过滤规则

支持 字段转换器

支持添加多个字段转换器，可自定义数据库字段到实体类字段的转换规则

支持 SQL 拦截器

支持添加多个 SQL 拦截器，可自定义 SQL 生成规则

5 技术选型

• 框架目的：只一行代码实现：多表联查分页搜索任意字段组合过滤任意字段排序多字段统计

• 架构图：

为什么用

这绝不是一个重复的轮子

虽然 增删改 是 hibernate 和 mybatis、data-jdbc 等等 ORM 的强项，但查询，特别是有 多条件、联表、分页、排序 的复杂的列表查询，却一直是它们的弱项。

传统的 ORM 很难用较少的代码实现一个复杂的列表检索，但 Bean Searcher 却在这方面下足了功夫，这些复杂的查询，几乎只用一行代码便可以解决。

• 例如，这样的一个典型的需求：

后端需要写一个检索接口，而如果用传统的 ORM 来写，代码之复杂是可以想象的。

而 Bean Searcher 却可以：

只一行代码实现以上功能

首先，你有一个实体类：

@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...
}

然后你就可以用一行代码实现这个用户检索接口：

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

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

    @GetMapping("/index")
    public SearchResult<User> index(HttpServletRequest request) {
        // 这里只写一行代码
        return beanSearcher.search(User.class, MapUtils.flat(request.getParameterMap()), new String[]{ "age" });
    }

}

这一行代码实现了以下功能：

• 多表联查

• 分页搜索

• 组合过滤

• 任意字段排序

• 字段统计

例如，该接口支持如下请求：

• GET: /user/index

• 无参请求（默认分页）:

• { "dataList": [ { "id": 1, "username": "Jack", "status": 1, "level": 1, "age": 25, "gender": "Male", "joinDate": "2021-10-01" }, ... // 默认返回 15 条数据 ], "totalCount": 100, "summaries": [ 2500 // age 字段统计 ] }

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

• 指定分页参数

• 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 字段

参数构建器

Map<String, Object> params = MapUtils.builder()
        .selectExclude(User::getJoinDate) // 排除 joinDate 字段
        .field(User::getStatus, 1) // 过滤：status = 1
        .field(User::getName, "Jack").ic() // 过滤：name = 'Jack' (case ignored)
        .field(User::getAge, 20, 30).op(Opetator.Between) // 过滤：age between 20 and 30
        .orderBy(User::getAge, "asc") // 排序：年龄，从小到大
        .page(0, 15) // 分页：第 0 页, 每页 15 条
        .build();
        List<User> users = beanSearcher.searchList(User.class, params);

快速开发

使用 Bean Searcher 可以极大地节省后端的复杂列表检索接口的开发时间！

• 普通的复杂列表查询只需一行代码

• 单表检索可复用原有 Domain，无需定义 SearchBean

集成简单

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

Spring Boot 项目，添加依赖即集成完毕：

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

接着便可在 Controller 或 Service 里注入检索器：

/**
 * 注入 Map 检索器，它检索出来的数据以 Map 对象呈现
 */
@Autowired
private MapSearcher mapSearcher;

/**
 * 注入 Bean 检索器，它检索出来的数据以 泛型 对象呈现
 */
@Autowired
private BeanSearcher beanSearcher;

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

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

然后可以使用 SearcherBuilder 构建一个检索器：

DataSource dataSource = ... // 拿到应用的数据源

// DefaultSqlExecutor 也支持多数据源
        SqlExecutor sqlExecutor = new DefaultSqlExecutor(dataSource);

// 构建 Map 检索器
        MapSearcher mapSearcher = SearcherBuilder.mapSearcher()
        .sqlExecutor(sqlExecutor)
        .build();

// 构建 Bean 检索器
        BeanSearcher beanSearcher = SearcherBuilder.beanSearcher()
        .sqlExecutor(sqlExecutor)
        .build();

扩展性强

面向接口设计，用户可自定义扩展 Bean Searcher 中的任何组件！

比如你可以：

• 自定义 FieldOp 来支持更多的字段运算符

• 自定义 FieldConvertor 来支持任意的 特殊字段类型

• 自定义 DbMapping 来实现自定义注解，或让 Bean Searcher 识别其它 ORM 的注解

• 自定义 ParamResolver 来支持其它形式的检索参数

• 自定义 Dialect 来支持更多的数据库

• 等等..

6 源码地址

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

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

---

---

欢迎加入我的知识星球，一起探讨架构，交流源码。加入方式，长按下方二维码噢：

已在知识星球更新源码解析如下：

最近更新《芋道 SpringBoot 2.X 入门》系列，已经 101 余篇，覆盖了 MyBatis、Redis、MongoDB、ES、分库分表、读写分离、SpringMVC、Webflux、权限、WebSocket、Dubbo、RabbitMQ、RocketMQ、Kafka、性能测试等等内容。

提供近 3W 行代码的 SpringBoot 示例，以及超 4W 行代码的电商微服务项目。

获取方式：点“在看”，关注公众号并回复 666 领取，更多内容陆续奉上。

文章有帮助的话，在看，转发吧。
谢谢支持哟 (*^__^*）