Detailed documentation for Nova. For a quick start, see the root README.md.
| Document | Contents |
|---|---|
| Getting started | Installation, first entity, Nova.create(...), schema initialization |
| Entities | Annotation reference, composite types (@Embeddable), relationships, indexes |
| JPA compatibility | jakarta.persistence feature matrix — supported / reactive-equivalent / fail-fast |
| Queries | CRUD, Query DSL, Updater, Projection, Aggregations, Page/Slice, Cursor, NativeQuery, CompiledQuery |
| Transactions | inTransaction, Propagation / Isolation / readOnly, pessimistic locking, retry |
| Dialects & Schema | Dialect interface, the five bundled dialects, SchemaGenerator, alter helpers |
| Spring | Spring Boot starter (auto-detect, properties), nova-spring-data repositories |
| Observability | SqlExecutionListener, Micrometer adapter, pool reachability probe |
| Metamodel | nova-metamodel annotation processor for compile-time property-name constants |
io.nova.Nova— one-line entry point taking aConnectionFactory(dialect auto-detected from driver metadata)io.nova.core.ReactiveEntityOperations— every persistence APIio.nova.query.Criteria,io.nova.query.QuerySpec— Query DSLio.nova.sql.Dialect,io.nova.sql.SchemaGenerator— dialect extension SPIio.nova.core.SqlExecutionListener— SQL execution observation hook
All modules under the io.github.bssm-oss group are published at the same version (currently 2.8.0).
io.github.bssm-oss:nova # aggregate (core + r2dbc + all dialects)
io.github.bssm-oss:nova-core
io.github.bssm-oss:nova-r2dbc
io.github.bssm-oss:nova-dialect-postgresql
io.github.bssm-oss:nova-dialect-mysql
io.github.bssm-oss:nova-dialect-mariadb
io.github.bssm-oss:nova-dialect-h2
io.github.bssm-oss:nova-dialect-oracle
io.github.bssm-oss:nova-spring-boot-starter
io.github.bssm-oss:nova-spring-data
io.github.bssm-oss:nova-metrics-micrometer
io.github.bssm-oss:nova-metamodel # opt-in annotation processor (compile-time only)
io.github.bssm-oss:nova-cache # opt-in 2nd-level cache