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 の違いは何ですか?
たった 1 行のコードで次のことを実現できます。
- 複数のテーブルからの取得
- 任意のフィールドによるページネーション
- 任意のフィールドによる結合フィルター
- 任意のフィールドによる並べ替え
- 複数フィールドの要約
- VOを直接返す
デザイン思考: Bean Searcher の思考
建築：

変更履歴：CHANGELOG
実績：レポート参照
Gitee 計画业版：https://gitee.com/enterprises?invite_code=Z2l0ZWUtMTM5MzQxMg%3D%3D

特徴

複数のテーブルへの 1 つのエンティティマッピングをサポート
動的フィールド演算子のサポート
サポートグループと集計クエリ
サポートセレクト |どこ |サブクエリから
エンティティ内の埋め込みパラメータのサポート
フィールドコンバーターをサポート
SQLインターセプターのサポート
SQL 方言拡張のサポート
マルチデータソースと動的データソースをサポート
アノテーションの省略とカスタマイズをサポート
フィールド演算子の拡張機能をサポート
等々

⁉️なぜ

これはリピーターホイールではありません

CREATE/UPDATE/DELETE は Hibernate、MyBatis、DataJDBC、その他の ORM の長所ですが、クエリ、特に複数条件、複数テーブル、ページング、ソートを伴う複雑なリストクエリは常に弱点でした。

従来のORMでは複雑なリスト検索を少ないコードで実現するのは困難でしたが、 Bean Searcherではこの点に大きな努力が払われました。これらの複雑なクエリは、ほぼ 1 行のコードで解決できます。

たとえば、次のような典型的な要件があります。

バックエンドは取得 API を記述する必要があり、従来の ORM で記述された場合、コードの複雑さは非常に高くなります。

しかし、Bean Searcher では次のことができます。

? 1行のコードで実現

まず、Entity クラスがあります。

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

その後、1 行のコードで 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 の開発時間を大幅に節約できます。

通常の複雑なリストクエリに必要なコードは 1 行だけです
単一のテーブルからの取得は、新しいEntityを定義せずに、元のdomainを再利用できます。

?簡単な統合

Bean Searcher は、SpringBoot、SpringMVC、Grails、Jfinal などの任意の JavaWeb フレームワークと連携できます。

スプリングブート / グレイル

必要なのは依存関係を追加することだけです。

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