设计兵团
全球展览设计搭建交易服务平台，提供设计模型、展会照片与视频教程。
核心定位
Bean Searcher 是一个面向 Java 后端的声明式检索框架，专注于解决列表查询场景中常见的拼接复杂度问题。它将查询条件、分页、排序、数据转换等环节抽象为可复用的检索模型，使开发者不必再为每个列表接口重复编写大量样板代码。
解决什么问题
在典型的企业级应用中，列表查询往往涉及多条件组合、动态排序、分页以及结果映射。传统做法通常需要手工拼接 SQL 或借助 ORM 的 Criteria API，代码量大且维护成本高。Bean Searcher 的思路是：
- 将查询参数声明为检索对象，框架自动解析并生成查询
- 内置分页、排序、字段过滤等通用能力
- 支持注解驱动的字段映射与校验
- 查询逻辑与业务代码解耦，减少重复劳动
主要特性
| 特性 | 说明 |
|---|---|
| 声明式查询 | 通过注解或配置定义检索字段，无需手写 SQL 拼接 |
| 动态条件 | 根据传入参数自动组合查询条件，空值自动忽略 |
| 分页与排序 | 内置支持，减少样板代码 |
| 结果映射 | 自动将查询结果映射为指定类型的 Bean |
| 轻量集成 | 可作为独立组件引入，不强制绑定特定 ORM 或框架 |
适用场景
Bean Searcher 适合以下情况：
- 列表接口数量多、查询条件组合变化频繁的项目
- 希望减少 MyBatis 或 JPA 中重复 SQL 拼接的团队
- 需要快速搭建后台管理类应用的开发场景
- 对查询性能有一定要求，但不想引入过重查询引擎的中小型系统
使用要点
- 在项目中引入依赖，版本以官方仓库为准
- 定义检索 Bean，使用注解标注可查询字段
- 调用检索器执行查询，传入参数对象即可获得分页结果
- 根据实际需求配置数据源适配与字段转换规则
框架的详细文档与示例代码可在 bs.zhxu.cn 查阅。建议在引入前评估现有查询层代码的复用程度，若列表查询逻辑已经高度封装，则需权衡迁移成本与实际收益。
