Download bean searcher - download do código-fonte bean searcher

bean searcher

Código fonte JAVA

v4.3.5

Baixar

logotipo

Inglês | 中文

Documentação: https://bs.zhxu.cn
阿里云最低 1 折：https://www.aliyun.com/minisite/goods?userCode=zugtbi5w
Blogs JueJin:
- Escrever código como este é 100 vezes mais eficiente do que usar MyBatis diretamente!
- Qual é a diferença entre Bean Searcher e MyBatis Plus?
Apenas uma linha de código para alcançar:
- Recuperação de múltiplas tabelas
- Paginação por qualquer campo
- Filtro combinado por qualquer campo
- Classificando por qualquer campo
- Resumos com vários campos
- Retornar VO diretamente
Design thinking: o pensamento do Bean Searcher
Arquitetura:

Registro de alterações: CHANGELOG
Desempenho: veja o relatório
Gitee 企业版: https://gitee.com/enterprises?invite_code=Z2l0ZWUtMTM5MzQxMg%3D%3D

Características

Suporta mapeamento de uma entidade para várias tabelas
Suporte ao operador de campo dinâmico
Grupo de suporte e consulta de agregação
Suporte Selecione | Onde | Da subconsulta
Suporta parâmetros incorporados na entidade
Suporta conversores de campo
Suporte a interceptadores SQL
Suporte à extensão de dialeto sql
Suporta múltiplas fontes de dados e fontes de dados dinâmicas
Anotação de suporte omitindo e personalizando
Extensão do operador de campo de suporte
e assim por diante

⁉️ POR QUE

Esta não é uma roda repetitiva

Embora CREATE/UPDATE/DELETE sejam os pontos fortes do Hibernate, MyBatis, DataJDBC e outros ORM, consultas, especialmente consultas de lista complexas com múltiplas condições , múltiplas tabelas , paginação , classificação , sempre foram seus pontos fracos.

ORM tradicional é difícil de realizar uma recuperação de lista complexa com menos código, mas o Bean Searcher tem feito grandes esforços nesse sentido. Essas consultas complexas podem ser resolvidas em quase uma linha de código.

Por exemplo, um requisito típico:

O back-end precisa escrever uma API de recuperação e, se for escrito com ORM tradicional, a complexidade do código será muito alta

Mas o Bean Searcher pode:

? Alcançado com uma linha de código

Primeiro, você tem uma classe 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...
}

Então você pode completar a API com uma linha de código:

 @ 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" });
    }

}

Esta linha de código pode alcançar:

Recuperação de múltiplas tabelas
Paginação por qualquer campo
Filtro combinado por qualquer campo
Classificando por qualquer campo
Resumo com campo age

Por exemplo, esta API pode ser solicitada da seguinte forma:

GET: /user/index

Recuperando por paginação padrão:

{
  "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
Recuperação por paginação especificada
GET: /user/index? status=1
Recuperação com status = 1 por paginação padrão
GET: /user/index? name=Jac & name-op=sw
Recuperação com name começando com Jac por paginação padrão
GET: /user/index? name=Jack & name-ic=true
Recuperação com name = Jack (caso ignorado) por paginação padrão
GET: /user/index? sort=age & order=desc
Classificação de recuperação por age decrescente e por paginação padrão

GET: /user/index? onlySelect=username,age

username,age apenas por paginação padrão:

{
  "dataList" : [
    {
      "username" : " Jack " ,
      "age" : 25 ,
    },
    ...     // 15 records default
  ],
  "totalCount" : 100 ,
  "summaries" : [
    2500    // age statistics
  ]
}

GET: /user/index? selectExclude=joinDate
Recuperando a paginação padrão excluída joinDate

Construtor de parâmetros

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

Demonstrações :

v4.x - demonstrações
v3.x - demonstrações

Desenvolvimento rápido

Usar o Bean Searcher pode economizar muito o tempo de desenvolvimento das complexas APIs de recuperação de lista!

Uma consulta de lista complexa comum requer apenas uma linha de código
A recuperação de uma única tabela pode reutilizar o domain original, sem definir uma nova Entity

? Fácil integração

Bean Searcher pode funcionar com qualquer framework JavaWeb, como: SpringBoot, SpringMVC, Grails, Jfinal e assim por diante.

SpringBoot / Grails

Tudo que você precisa é adicionar uma dependência:

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

e então você pode injetar Searcher em um Controller ou 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;

Projeto Sólon

Tudo que você precisa é adicionar uma dependência:

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

e então você pode injetar Searcher em um Controller ou 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;

Outras estruturas

Adicionando esta dependência:

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

então você pode construir um Searcher com SearcherBuilder :

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

? Fácil estendido

Você pode personalizar e estender qualquer componente no Bean Searcher.

Por exemplo:

Personalizando FieldOp para oferecer suporte a outro operador de campo
Personalizando DbMapping para suportar anotações de outros ORM
Personalizando ParamResolver para oferecer suporte a parâmetros de consulta JSON
Personalizando FieldConvertor para suportar qualquer tipo de campo
Personalizando Dialect para suportar mais banco de dados
e assim e