troyzhxu/bean-searcher

Health v2 · maintenance only

Adoption not part of the score

1384 stars · 148 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Bean Searcher is a read-only ORM framework for Java focused on declarative complex list queries, where entities define search boundaries and request parameters drive filtering, sorting, pagination, and joins. It generates SQL automatically, integrates non-invasively with Spring Boot alongside MyBatis or JPA, and includes built-in protections like SQL injection prevention and deep-offset throttling.

Use cases

• build multi-condition list query endpoints without if-else SQL stitching
• query across multiple tables with annotation-declared joins
• let frontend dynamically combine filters, sorting, and pagination without backend changes
• add searchable list APIs to existing Spring Boot apps alongside MyBatis or JPA
• implement paginated admin data tables with filtering and stats
• prevent SQL injection and deep pagination performance issues by default

When to choose

• you need complex list/retrieval queries in Java with minimal boilerplate
• your frontend needs flexible, parameter-driven filtering and sorting
• you want a read-only query layer that coexists with your existing ORM

When to avoid

• you need full CRUD with writes and transactional entity management
• you prefer hand-tuned SQL or heavy control over generated queries
• your project is not on the JVM/Java ecosystem

Facets

framework · maturity active

orm database search-engine web-framework api-framework web-development backend databases developer-tools jvm cross-platform declarative-search readonly-orm dynamic-sql list-queries spring-boot-starter pagination multi-table-joins search spring-boot

Member repositories

For agents

markdown · JSON · MCP: product_card(name="troyzhxu/bean-searcher")