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

}

Map<String, Object> params = MapUtils.builder()
        .selectExclude(User::getJoinDate)                 // Исключение поля joinDate
        .field(User::getStatus, 1)                        // Фильтр: статус = 1
        .field(User::getName, "Jack").ic()                // Фильтр: имя = 'Jack' (игнорирование регистра)
        .field(User::getAge, 20, 30).op(Opetator.Between) // Фильтр: возраст между 20 и 30
        .orderBy(User::getAge, "asc")                     // Сортировка по возрасту в порядке возрастания
        .page(0, 15)                                      // Пагинация: страница=0 и размер=15
        .build();
List<User> users = beanSearcher.searchList(User.class, params);

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

/**
 * Внедрение MapSearcher, который получает данные в виде объектов Map
 */
@Autowired
private MapSearcher mapSearcher;

/**
 * Внедрение BeanSearcher, который возвращает данные в виде общих объектов
 */
@Autowired
private BeanSearcher beanSearcher;

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

/**
 * Внедрение MapSearcher, который возвращает данные в виде объектов Map
 */
@Inject
private MapSearcher mapSearcher;

/**
 * Внедрение BeanSearcher, который возвращает данные в виде общих объектов
 */
@Inject
private BeanSearcher beanSearcher;

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

DataSource dataSource = ...     // Получение dataSource приложения

// DefaultSqlExecutor поддерживает несколько источников данных
SqlExecutor sqlExecutor = new DefaultSqlExecutor(dataSource);

// Создание MapSearcher
MapSearcher mapSearcher = SearcherBuilder.mapSearcher()
        .sqlExecutor(sqlExecutor)
        .build();

// Создание BeanSearcher
BeanSearcher beanSearcher = SearcherBuilder.beanSearcher()
        .sqlExecutor(sqlExecutor)
        .build();
```### 🔨 Легкое расширение

Вы можете настраивать и расширять любой компонент в Bean Searcher.

Например:
* Настройка [`FieldOp`](/bean-searcher/src/main/java/cn/zhxu/bs/FieldOp.java) для поддержки других операторов полей
* Настройка [`DbMapping`](/bean-searcher/src/main/java/cn/zhxu/bs/DbMapping.java) для поддержки других аннотаций ORM
* Настройка [`ParamResolver`](/bean-searcher/src/main/java/cn/zhxu/bs/ParamResolver.java) для поддержки параметров запроса JSON
* Настройка [`FieldConvertor`](/bean-searcher/src/main/java/cn/zhxu/bs/FieldConvertor.java) для поддержки любого типа поля
* Настройка [`Dialect`](/bean-searcher/src/main/java/cn/zhxu/bs/dialect/Dialect.java) для поддержки большего количества баз данных
* и так далее

### 📚 Подробная документация

Ссылка: https://bs.zhxu.cn

### 🤝 Дружественные ссылки

[**[ Sa-Token ]** Легковесный Java-фреймворк для управления правами доступа, делающий аутентификацию простой и элегантной!](https://github.com/dromara/Sa-Token)

[**[ Fluent MyBatis ]** Фреймворк для улучшения синтаксиса MyBatis, объединяющий лучшие черты и преимущества MyBatisPlus, DynamicSql и Jpa, используя аннотации для генерации кода](https://gitee.com/fluent-mybatis/fluent-mybatis)

[**[ OkHttps ]** Легкий, но мощный HTTP-клиент, который можно использовать как на клиентской, так и на серверной стороне, поддерживает протоколы WebSocket и Stomp](https://gitee.com/troyzhxu/okhttps)

[**[ hrun4j ]** Решение для автоматизированного тестирования API -- выбери правильный инструмент, и ты будешь уходить с работы раньше; используй правильные тесты, и ты будешь спать спокойно ночью](https://github.com/lematechvip/hrun4j)[**[ JsonKit ]** Легковесный инструмент для работы с JSON, прост в использовании, не зависит от конкретной реализации, что позволяет отделить бизнес-код от Jackson, Gson, Fastjson и других](https://gitee.com/troyzhxu/xjsonkit)

[**[ Free UI ]** На основе Vue3 + TypeScript, это очень легкий и крутой набор UI-компонентов](https://gitee.com/phoeon/free-ui)


### ❤️ Как внести свой вклад

1. Сделай форк кода!
2. Создай свой собственный ветвь: `git checkout -b feat/xxxx`
3. Подтверди свои изменения: `git commit -am 'feat(function): add xxxxx'`
4. Отправь свою ветвь: `git push origin feat/xxxx`
5. Отправь запрос на слияние `pull request`