Bean Searcher

Bean Searcher 是一个 Java 的声明式检索框架，解决的是后端列表查询接口越写越臃肿的问题。传统做法里，前端每多一个筛选条件，后端就要多一段 if-else 拼 SQL；Bean Searcher 把这件事反过来：实体类声明好可检索的字段和关联关系，前端通过请求参数决定查哪些字段、用什么运算符、怎么排序、怎么分页，后端只留一行 beanSearcher.search(User.class)。

主要功能

单表实体零注解即可检索，联表只需在实体上配置关联关系，框架自动生成多表联查 SQL，不用手写 JOIN。分页、组合过滤、任意字段排序、统计都能由参数组合出来，官方把它比作列表检索领域的 GraphQL，但走普通 HTTP 参数，不引入专用协议。

它不替换现有 ORM，和 MyBatis、JPA 分工：增删改仍归它们，列表查询交给 Bean Searcher。安全方面默认开启防 SQL 注入、防超大分页、防深度偏移三项机制，非法参数会被拦截。

适合谁

适合正在写管理后台、报表列表、多条件筛选接口的 Java 后端。如果项目里已经堆了大量条件拼接代码，或者前端经常要求加字段、改排序，这套参数驱动的做法能省下不少改动。

费用与限制

项目基于 Apache 许可发布，文档站提供中文与英文界面，当前文档版本为 v4.8.12。它面向 Java 服务端，需要接入 Spring 等框架使用，不是开箱即用的独立软件；具体接入方式和版本变化以官方文档为准。