Mapper is a MyBatis plugin that provides generic single-table CRUD operations for Java applications.
The tool addresses the repetitive work of writing boilerplate SQL for basic database operations on individual tables. It allows developers to select and use generic methods as needed, and to create custom generic methods tailored to their specific requirements. The plugin integrates with MyBatis to handle common insert, update, delete, and query operations without requiring manual SQL writing for these standard patterns.
Developers adopting this tool should understand that it is designed exclusively for single-table operations and does not provide generic support for multi-table joins. The project maintains multiple branches to support different Spring Boot versions: the master branch targets Spring Boot 4.x with JDK 17 and later, an earlier branch supports Spring Boot 3.x, and another supports Spring Boot 2.x with JDK 8. The README recommends that new projects consider the separate mybatis-mapper project instead, which functions as a pure MyBatis extension without modifying core MyBatis libraries or requiring additional configuration. This tool is most suitable for applications that need to streamline single-table data access patterns and can tolerate the constraint of not having unified generic query support across related tables.
The project maintains active compatibility updates aligned with the latest Spring Boot releases. Development focuses on dependency updates to ensure stability with current framework versions. The tool is sustained through community support and sponsorship rather than commercial backing.
