ebean-orm/ebean
Ebean
Ebean is a Java object-relational mapping framework designed to simplify database persistence through automated query generation, schema migration, and transaction management. It uses metadata-driven mapping and bytecode enhancement to bridge the gap between application objects and relational database tables, providing a persistent layer that handles complex data interactions while maintaining consistency across unit-of-work boundaries.
The framework distinguishes itself through its focus on developer productivity and performance optimization. It provides type-safe query builders that generate code at compile time, enabling IDE auto-completion and static validation of database operations. Additionally, it includes integrated support for container-based testing, allowing developers to manage ephemeral database instances and automate schema initialization directly within their test suites.
Beyond core mapping, the project offers a comprehensive suite of tools for data management and observability. This includes automated schema evolution, read-replica routing for connection management, and multi-level caching to reduce database load. It also provides diagnostic capabilities such as query execution plan capture and distributed tracing to assist in performance tuning.
The library supports modern deployment workflows, including ahead-of-time compilation for native images to eliminate runtime reflection overhead. It is distributed as a standard Java library, with documentation and tooling available to support integration into existing build processes.
Features
- Object-Relational Mapping - Translates objects into database tables and automates SQL generation while allowing manual SQL overrides.
- Object-Relational Mapping Frameworks - Provides a persistence layer that maps objects to relational databases while automating query generation and schema migration.
- Database Connection Configurations - Defines primary database access by specifying connection credentials, driver settings, and pool limits.
- Database Schema Migrations - Automates the application of versioned updates to database schemas to maintain structural compatibility with application code.
- Database Transaction Management - Maintains a unit of work that tracks object state changes and synchronizes them within defined transaction boundaries.
- Dynamic SQL Generators - Constructs optimized database queries at runtime by inspecting object graphs and applying necessary filters.
- Type-Safe Query Construction - Provides programmatic construction of SQL statements with compile-time type safety and IDE autocompletion.
- Entity Property Queries - Executes type-safe queries to fetch database records as objects without writing manual SQL.
- Transaction Management - Synchronizes database operations with transaction boundaries to ensure consistent data handling.
- Annotation-Driven Mappings - Uses Java annotations to define structural mappings between application objects and relational database tables.
- Type-Safe Query Builders - Generates type-safe query builder classes at compile time to enable static validation and IDE auto-completion.
- Association Lazy Loading - Intercepts property access on entity objects to fetch associated data from the database only when requested.
- Data Projections - Transforms database query results directly into custom data objects to simplify data access.
- Connection Pool Managers - Manages database connection lifecycles, including read-write splitting and connection health validation.
- Database Migration Management - Executes pending schema updates upon application startup to ensure structural synchronization.
- Database Migration Tools - Provides utilities that manage and automate schema versioning and database structure updates.
- Database Integration Testing - Enables switching the target database platform for test suites via configuration properties or build parameters.
- Database Record Auditing - Tracks record changes over time by maintaining audit tables and supporting point-in-time queries against historical data.
- Query Optimization - Improves the speed and efficiency of database queries through automated field selection and minimized communication.
- Multi-level Caching - Coordinates between local caches and external stores to optimize data retrieval and reduce database load.
- Test Data Generators - Generates entity instances with random values that respect database constraints and complex object relationships for testing.
- Raw SQL Execution - Integrates raw SQL fragments into query clauses or runs arbitrary statements with automatic result mapping.
- Raw SQL Result Mapping - Executes custom SQL queries and automatically populates the results into plain objects.
- Read Replicas - Configures secondary read-only data sources to automatically offload read operations from the primary database.
- Database Administration CLI - Provides a command-line interface to generate and execute schema scripts for database structure alignment.
- Native AOT Compilation - Transforms database entity classes into ahead-of-time compiled code to eliminate runtime reflection.
- Test Database Provisioning - Automates the lifecycle of ephemeral database containers specifically for development and testing environments.
- Automated Testing Containers - Automates the lifecycle of ephemeral database containers to provide isolated environments for integration testing.
- Load-Time Class Transformations - Modifies compiled class files at build or load time to inject persistence logic and lazy loading capabilities.
- Containerized Integration Tests - Spins up isolated database instances using container technology for consistent integration testing.
- Isolated Database Tests - Utilizes dedicated, ephemeral database instances for isolated integration testing.
