bean searcher下载 - bean searcher源代码下载

bean searcher

JAVA源码

v4.3.5

下载

英语 | 中文

文档：https://bs.zhxu.cn
阿里云最低1折：https://www.aliyun.com/minisite/goods?userCode=zugtbi5w
爵金博客：
- 这样写代码比直接使用MyBatis效率提高100倍！
- Bean Searcher 和 MyBatis Plus 有什么区别？
只需一行代码即可实现：
- 从多表中检索
- 按任何字段分页
- 按任意字段组合过滤
- 按任意字段排序
- 多字段摘要
- 直接返回VO
设计思维：Bean Searcher 的思维
建筑学：

变更日志：CHANGELOG
业绩：见报告
Gitee企业版：https://gitee.com/enterprises?invite_code=Z2l0ZWUtMTM5MzQxMg%3D%3D

特征

支持一个实体映射到多个表
支持动态字段操作符
支持分组、聚合查询
支持选择|哪里 |来自子查询
支持实体中嵌入参数
支持现场转换器
支持sql拦截器
支持sql方言扩展
支持多数据源和动态数据源
支持注释省略和自定义
支持现场操作员扩展
等等

⁉️为什么

这不是重复轮

虽然CREATE/UPDATE/DELETE是Hibernate、MyBatis、DataJDBC等ORM的强项，但查询，尤其是多条件、多表、分页、排序的复杂列表查询，一直是它们的弱项。

传统的ORM很难用较少的代码实现复杂的列表检索，但Bean Searcher在这方面做出了很大的努力。这些复杂的查询几乎可以用一行代码来解决。

比如这样一个典型的需求：

后端需要编写检索API，如果用传统的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...
}

然后你可以用一行代码完成API：

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

    @ Autowired
    private BeanSearcher beanSearcher ;              // Inject BeanSearcher

    @ GetMapping ( "/index" )
    public SearchResult < User > index ( HttpServletRequest request ) {
        // Only one line of code written here
        return beanSearcher . search ( User . class , MapUtils . flat ( request . getParameterMap ()), new String []{ "age" });
    }

}

这行代码可以实现：

从多表中检索
按任何字段分页
按任意字段组合过滤
按任何字段排序
age字段摘要

例如，可以如下请求该API：

GET: /user/index

默认分页检索：

{
  "dataList" : [
    {
      "id" : 1 ,
      "username" : " Jack " ,
      "status" : 1 ,
      "age" : 25 ,
      "gender" : " Male " ,
      "joinDate" : " 2021-10-01 " ,
      "roleId" : 1 ,
      "roleName" : " User "
    },
    ...     // 15 records default
  ],
  "totalCount" : 100 ,
  "summaries" : [
    2500    // age statistics
  ]
}

GET: /user/index? page=1 & size=10
按指定分页检索
GET: /user/index? status=1
默认分页status = 1检索
GET: /user/index? name=Jac & name-op=sw
默认分页检索以Jac开头的name
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 ,
    },
    ...     // 15 records default
  ],
  "totalCount" : 100 ,
  "summaries" : [
    2500    // age statistics
  ]
}

GET: /user/index? selectExclude=joinDate
检索joinDate排除的默认分页

参数生成器

 Map < String , Object > params = MapUtils . builder ()
        . selectExclude ( User :: getJoinDate )                 // Exclude joinDate field
        . field ( User :: getStatus , 1 )                        // Filter：status = 1
        . field ( User :: getName , "Jack" ). ic ()                // Filter：name = 'Jack' (case ignored)
        . field ( User :: getAge , 20 , 30 ). op ( Opetator . Between ) // Filter：age between 20 and 30
        . orderBy ( User :: getAge , "asc" )                     // Sorting by age ascending 
        . page ( 0 , 15 )                                      // Pagination: page=0 and size=15
        . build ();
List < User > users = beanSearcher . searchList ( User . class , params );

演示：

v4.x - 演示
v3.x - 演示

快速发展

使用Bean Searcher可以大大节省复杂列表检索api的开发时间！

普通的复杂列表查询只需要一行代码
单表检索可以重用原来的domain ，无需定义新的Entity

？轻松集成

Bean Searcher 可以与任何 JavaWeb 框架配合使用，例如：SpringBoot、SpringMVC、Grails、Jfinal 等。

SpringBoot / Grails

您所需要的只是添加一个依赖项：

implementation ' cn.zhxu:bean-searcher-boot-stater:4.3.4 '

然后你可以将 Searcher 注入到Controller或Service中：

 /**
 * Inject a MapSearcher, which retrieved data is Map objects
 */
@Autowired
private MapSearcher mapSearcher;

/**
 * Inject a BeanSearcher, which retrieved data is generic objects
 */
@Autowired
private BeanSearcher beanSearcher;

索伦计划

您所需要的只是添加一个依赖项：

implementation ' cn.zhxu:bean-searcher-solon-plugin:4.3.4 '

然后你可以将 Searcher 注入到Controller或Service中：

 /**
 * Inject a MapSearcher, which retrieved data is Map objects
 */
@Inject
private MapSearcher mapSearcher;

/**
 * Inject a BeanSearcher, which retrieved data is generic objects
 */
@Inject
private BeanSearcher beanSearcher;

其他框架

添加此依赖项：

implementation ' cn.zhxu:bean-searcher:4.3.4 '

然后你可以使用SearcherBuilder构建一个Searcher ：

 DataSource dataSource = ...     // Get the dataSource of the application

// DefaultSqlExecutor suports multi datasources
SqlExecutor sqlExecutor = new DefaultSqlExecutor ( dataSource );

// build a MapSearcher
MapSearcher mapSearcher = SearcherBuilder . mapSearcher ()
        . sqlExecutor ( sqlExecutor )
        . build ();

// build a BeanSearcher
BeanSearcher beanSearcher = SearcherBuilder . beanSearcher ()
        . sqlExecutor ( sqlExecutor )
        . build ();