比 MyBatis 快 100 倍，天生支持联表！-阿里云开发者社区

比 MyBatis 快 100 倍，天生支持联表！

2023-04-28 101

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： 比 MyBatis 快 100 倍，天生支持联表！

1 开源项目简介

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

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

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

视频教程：https://doc.iocoder.cn/video/

2 开源协议

使用Apache-2.0开源协议

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

项目地址：https://github.com/YunaiV/yudao-cloud

视频教程：https://doc.iocoder.cn/video/

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();