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