spring-projects/spring-data-neo4j
61.8
Adequate · 9 November 2026
31.3k
lines of production code
Java
primary language
10
measurements over time
What this system is
Features
Add Spring Boot auto-configuration and IDE tooling metadata for Neo4j
The project now includes META-INF configuration files to support Spring Boot auto-configuration and IDE integration. A new spring.factories file registers the Neo4jRepositoryFactory, enabling automatic setup of Neo4j repositories without manual configuration. Additionally, a spring.tooling file provides metadata for the Neo4j XML namespace, improving code completion and validation in IDEs.
src/main/resources/META-INF · high confidence
Added Spring AOT support for Neo4j runtime hints
The application now includes Spring AOT (Ahead-of-Time) support by registering specific runtime hints and bean registration processors for Neo4j. This ensures that Neo4j-related types and beans are correctly handled during the build-time processing phase, improving startup performance and reducing memory footprint for native images.
src/main/resources/META-INF/spring · high confidence
Added Spring Framework AOT support for Neo4j
This change introduces Ahead-of-Time (AOT) compilation support for Spring Data Neo4j, enabling better performance and lower memory usage in native images. The \src/main/java/org/springframework/data/neo4j/aot\ package now contains several new components: \Neo4jRuntimeHints\ registers reflection hints for key classes like repositories, callbacks, and executors; \Neo4jManagedTypesBeanRegistrationAotProcessor\ handles bean registration for managed types; \Neo4jTypeFilters\ and \Neo4jAotPredicates\ provide type filtering logic; and \package-info.java\ sets null-safety annotations. These additions ensure that necessary classes and members are retained and accessible during native image generation.
src/main/java/org/springframework/data/neo4j/aot · high confidence
Added license template and OpenRewrite migration recipe for element IDs
A new license template file has been added to standardize copyright headers across the project. Additionally, an OpenRewrite recipe configuration is now available to automatically migrate code from using the deprecated Neo4j \id()\ function to the new \elementId()\ function, helping users update their data model interactions.
etc · high confidence
Enable CDI integration for Spring Data Neo4j
The application now supports configuration within a CDI (Contexts and Dependency Injection) context by registering the Neo4j CDI extension. This is achieved by adding a new service provider file at src/main/resources/META-INF/services/javax.enterprise.inject.spi.Extension, which points to org.springframework.data.neo4j.config.Neo4jCdiExtension, allowing the framework to automatically discover and initialize CDI-specific beans.
src/main/resources/META-INF/services · high confidence
GraalVM Native Image support for Neo4j driver reflection
Added native-image configuration files to enable GraalVM native compilation for Spring Data Neo4j. The new reflection-config.json registers org.neo4j.driver.QueryRunner for reflection access, and the accompanying native-image.properties file applies this configuration, allowing the DefaultNeo4jClient to function correctly in native images.
src/main/resources/META-INF/native-image · high confidence
Introduces core abstractions for database and user selection in Neo4j operations
This change adds the foundational classes and interfaces for specifying target databases and users within the Neo4j core API. It introduces the \DatabaseSelection\ value object and \DatabaseSelectionProvider\ interface, allowing applications to explicitly configure which database a repository or template should interact with, which is essential for Neo4j 4.0+ clusters. Additionally, it provides \UserSelection\ and \UserSelectionProvider\ abstractions to support user impersonation (available in Neo4j 4.4+), enabling operations to run under specific user contexts. Default implementations are included to maintain backward compatibility by defaulting to the server's selected database and the connected user.
src/main/java/org/springframework/data/neo4j/core · high confidence
Introduction of core mapping infrastructure for Spring Data Neo4j 6.0
The \src/main/java/org/springframework/data/neo4j/core/mapping\ package now contains the foundational mapping classes for the SDN 6.0 core API. This includes \Constants\ for internal Cypher parameter names (such as \\_\elementId\\\ and \\\vectorProperty\\_\), \CypherGenerator\ for building Cypher statements, and entity/property descriptors (\DefaultNeo4jPersistentEntity\, \DefaultNeo4jPersistentProperty\) that handle schema mapping, vector property detection, and relationship properties. It also introduces \IdentitySupport\ to manage the transition from deprecated Neo4j \id()\ to \elementId()\, and \DefaultNeo4jIsNewStrategy\ to determine entity persistence state based on identifier types.
src/main/java/org/springframework/data/neo4j/core/mapping · high confidence
Kotlin extensions for Neo4j templates and clients
Added Kotlin extension functions for Neo4j operations and clients to improve idiomatic usage. These extensions leverage reified type parameters to allow callers to omit explicit class arguments in methods like \findAll\, \findById\, and \count\. They also provide Kotlin-friendly alternatives for Java-specific patterns, such as replacing \Optional\ with nullable types, offering \inDatabase\ aliases to avoid Kotlin's reserved \in\ keyword, and exposing Coroutines-based variants like \Flow\ and \suspend\ functions for reactive operations.
src/main/kotlin/org/springframework/data/neo4j/core · high confidence
New Cypher Parameter Escaping Utilities
Added the Parameters.kt file in the core cypher package, introducing two extension functions (asParam) that allow developers to easily escape parameter names with a leading dollar sign ($) within Cypher queries, particularly useful for preventing interpolation issues in multiline strings.
src/main/kotlin/org/springframework/data/neo4j/core/cypher · high confidence
New Cypher-DSL and SpEL repository execution interfaces
This location introduces the core support classes that enable programmatic query construction using the Cypher-DSL and enhanced SpEL support. It adds the \CypherdslConditionExecutor\ and \CypherdslStatementExecutor\ interfaces for imperative repositories, and their reactive counterparts \ReactiveCypherdslConditionExecutor\ and \ReactiveCypherdslStatementExecutor\, allowing developers to build and execute custom Cypher queries using the DSL instead of declarative annotations. The \Neo4jEvaluationContextExtension\ registers SpEL functions (\orderBy\, \literal\, \anyOf\, \allOf\) for use in repository queries. Additionally, it provides the \Neo4jRepositoryFactory\ and \ReactiveNeo4jRepositoryFactory\ implementations that wire these new executors into the repository proxy, along with the \ReactivePersistenceExceptionTranslationInterceptor\ and \PostProcessor\ to ensure reactive exception translation is applied to repository methods.
src/main/java/org/springframework/data/neo4j/repository/support · high confidence
New JavaConfig and CDI support classes for Spring Data Neo4j 6.0
This location introduces the core configuration infrastructure for Spring Data Neo4j 6.0, providing abstract base classes (\AbstractNeo4jConfig\, \AbstractReactiveNeo4jConfig\) for imperative and reactive Java-based setup, as well as a full CDI integration (\Neo4jCdiExtension\, \Neo4jCdiConfigurationSupport\) for non-Spring environments. It also adds auditing support via \EnableNeo4jAuditing\ and \EnableReactiveNeo4jAuditing\ annotations and their corresponding registrars, along with a \Builtin\ qualifier for CDI bean management.
src/main/java/org/springframework/data/neo4j/config · high confidence
New configuration infrastructure for imperative and reactive Neo4j repositories
This release introduces the \org.springframework.data.neo4j.repository.config\ package, providing the core configuration infrastructure for Spring Data Neo4j 6.0. It adds the \@EnableNeo4jRepositories\ and \@EnableReactiveNeo4jRepositories\ annotations to activate repository scanning for imperative and reactive modes respectively. These annotations wire up dedicated \RepositoryConfigurationExtension\ implementations (\Neo4jRepositoryConfigurationExtension\ and \ReactiveNeo4jRepositoryConfigurationExtension\) that register necessary beans such as \Neo4jTemplate\, \ReactiveNeo4jTemplate\, and \Neo4jEvaluationContextExtension\. A new \StartupLogger\ component provides debug-level logging of the bootstrapping process, including SDN, Spring Data Commons, and Neo4j Driver versions.
src/main/java/org/springframework/data/neo4j/repository/config · high confidence
New core conversion infrastructure and custom converter support
This location introduces the foundational conversion layer for Spring Data Neo4j 6.0, replacing the previous OGM-based approach. It adds the \@ConvertWith\ annotation, allowing users to specify custom \Neo4jPersistentPropertyConverter\ implementations or Spring bean references for entity attributes. The package includes the \Neo4jConversionService\ interface and \Neo4jConversions\ registry, which manage built-in mappings for Cypher types (such as \LocalDate\, \OffsetDateTime\, and spatial points) and support decomposition of properties into maps via \Neo4jPersistentPropertyToMapConverter\.
src/main/java/org/springframework/data/neo4j/core/convert · high confidence
New core schema annotations and mapping infrastructure
This location introduces the foundational schema annotations and supporting classes for the new Spring Data Neo4j core mapping model. Users can now use \@Node\ to define entity classes and their labels, \@Relationship\ to map connections with configurable \cascadeUpdates\ behavior, and \@Property\ to map fields, including a new \readOnly\ flag to prevent writing values to the graph. The package also adds \@Id\ and \@GeneratedValue\ for flexible ID management (supporting internal, UUID, and custom generators), \@RelationshipId\ as a shortcut for relationship property IDs, and \@DynamicLabels\ to handle runtime-managed node labels. Additionally, \@PostLoad\ allows executing logic after an entity is hydrated, \@CompositeProperty\ (with its factory) enables complex map-based property conversion, and \@RelationshipProperties\ with \persistTypeInfo\ supports persisting type information for relationship properties.
src/main/java/org/springframework/data/neo4j/core/schema · high confidence
New support utilities for date formatting, retry logic, and identity generation
The core support package now includes several new utilities to aid domain modeling and resilience. Users can annotate fields with @DateLong or @DateString to explicitly control whether dates are stored as longs or formatted strings in the database. A new RetryExceptionPredicate is provided to help applications determine if a transaction error is safe to retry, while a UUIDStringGenerator offers a standard way to generate UUID-based identifiers. Additionally, a BookmarkManagerReference simplifies the resolution of bookmark managers within the application context, and a UserAgent enum allows for better identification of queries by exposing driver and framework version information.
src/main/java/org/springframework/data/neo4j/core/support · high confidence
Project initialization with documentation, build tools, and configuration files
The repository has been initialized with essential project scaffolding, including the Apache 2.0 license, a Maven wrapper for consistent builds, and standard configuration files like \.gitignore\ and \.git-blame-ignore-revs\. Comprehensive documentation has been added, including a \README\ detailing usage with Spring Boot and plain Spring, contribution guidelines, a security policy, and support instructions. This establishes the foundational structure and developer experience for the Spring Data Neo4j project.
(repo-wide) · high confidence
Spring Framework AOT support and Neo4j Java Driver 5.x upgrade
The Neo4j integration now supports Spring Framework Ahead-of-Time (AOT) compilation, introduced via the new \Neo4jManagedTypes\ class in the \aot\ package to expose managed types for native image processing. Additionally, the library has upgraded to the Neo4j Java Driver 5.x series, which is reflected in the updated \DefaultNeo4jClient\ and \DefaultReactiveNeo4jClient\ implementations that now utilize the driver's native bookmark management and database selection capabilities.
spring-data-neo4j · high confidence
Behavioural changes
Documentation examples restructured for Antora
The documentation examples have been migrated to the Antora documentation system. This change replaces the previous example structure with symbolic links pointing to the relevant source code directories (config, core, documentation, integration, and repository) within the Spring Data Neo4j project, ensuring that the documentation now references the actual implementation and test code directly.
src/main/antora/modules/ROOT/examples · high confidence
Migrate build to Spring Develocity Conventions and update JVM configuration
The Maven build now uses the Spring Develocity Conventions extension (version 0.0.26) to connect to ge.spring.io, enabling centralized build performance improvements and caching. Additionally, the JVM configuration has been updated with specific module exports and opens for the JDK compiler and base libraries to support the new build tooling requirements.
.mvn · high confidence
Migrate documentation to Antora
The documentation source has been migrated to the Antora static site generator, restructuring the content into the \src/main/antora/modules/ROOT/pages/introduction-and-preface\ directory. This change introduces new pages covering the introduction, building blocks, and prefaces for Neo4j, Spring Data, and Spring Data Neo4j, while also updating the 'New & Noteworthy' section to link to the latest release notes for versions 7.0 through 7.2.
src/main/antora/modules/ROOT/pages/introduction-and-preface · high confidence
Refactored transaction and bookmark management infrastructure
The transaction management layer in \org.springframework.data.neo4j.core.transaction\ has been restructured to improve thread safety and configurability. A new \Neo4jBookmarkManager\ sealed interface (with \DefaultBookmarkManager\, \ReactiveDefaultBookmarkManager\, and \NoopBookmarkManager\ implementations) centralizes bookmark handling, allowing users to seed initial bookmarks or disable management entirely. The \Neo4jTransactionManager\ and \ReactiveNeo4jTransactionManager\ now use a builder pattern and explicitly support this bookmark manager, while \Neo4jTransactionUtils\ ensures transaction timeouts and user impersonation are correctly propagated to the Neo4j driver.
src/main/java/org/springframework/data/neo4j/core/transaction · high confidence
Repository query execution engine restructured for Spring Data Neo4j 6.0
The repository query execution layer has been completely rewritten for version 6.0, introducing a new class hierarchy to handle imperative and reactive query execution separately. The new \AbstractReactiveNeo4jQuery\ and \CypherdslBasedQuery\ classes manage the execution flow, while \CypherQueryCreator\ handles the generation of Cypher statements from derived queries. This change adds support for advanced query features including vector search (via \SearchResult\), geospatial queries (via \GeoResult\), and keyset-based scrolling (via \ScrollPosition\). It also introduces new SpEL functions like \anyOf\ and \allOf\ for dynamic label handling and improves projection handling through \FluentQuerySupport\.
src/main/java/org/springframework/data/neo4j/repository/query · high confidence
Test coverage
Added Kotlin extension tests for Neo4j core APIs; Added Kotlin test fixtures for shared integration tests; Added architecture tests using ArchUnit; Added documentation domain model classes for Neo4j mapping examples; Added documentation test fixtures for Neo4j repository configuration and custom type conversion; Added documentation tests for Neo4j domain events and repository queries; Added imperative repository test fixtures; Added integration tests for CDI context support; Added integration tests for Kotlin coroutines interoperability with the reactive Neo4j client; Added integration tests for Kotlin entity persistence and primitive defaults; Added integration tests for Kotlin projection issues; Added integration tests for Neo4j Template examples; Added integration tests for advanced mapping scenarios; Added integration tests for cascading update behavior; Added integration tests for composite values as IDs; Added integration tests for custom repository fragments; Added integration tests for imperative Kotlin Neo4j features; Added integration tests for imperative Neo4j conversion and type handling; Added integration tests for imperative Neo4j repository operations; Added integration tests for lightweight DTO mapping scenarios; Added integration tests for multiple Neo4j contexts; Added integration tests for optimistic locking with versioned self-references; Added integration tests for property handling and relationship properties; Added integration tests for reactive advanced mapping and cyclic projections; Added integration tests for the NoopBookmarkManager; Added reactive integration tests for composite properties, custom types, and type conversion; Added reactive integration tests for custom base repositories, auditing, callbacks, and Cypher-DSL execution; Added shared test model classes for the movies integration tests; Added test fixtures for DATAGRAPH-1446 abstract relationship properties; Added test fixtures for DATAGRAPH-1448 schema mapping; Added test for @PostLoad on Kotlin interfaces; Added test for CI Docker image proxy substitution; Added test model for hierarchical node mapping; Added test resources for named queries, data migrations, and logging configuration; Added tests for ID deprecation warning suppression; Added tests for Neo4j transaction and bookmark management; Added tests for generic type handling in @RelationshipProperties; Added tests for mapping callbacks; Added tests for repository configuration and startup logging; Added unit tests for Neo4j configuration, retry logic, and geographic types; Added unit tests for Neo4j type conversion and spatial/temporal adapters; Added unit tests for Neo4j type filtering; Added unit tests for core Neo4j client and utility components; Added unit tests for core mapping components; Added unit tests for repository factory identifier validation and derived query checks; Added unit tests for repository query utilities and SpEL support; Consolidated integration test suite for reported issues; Expanded integration tests for property conversion and composite types; New test infrastructure and utilities for Spring Data Neo4j; Shared test model classes added for integration testing.
Dependencies
Initial project setup with Spring Data Neo4j 8.2.0-SNAPSHOT and Antora documentation tooling
This change introduces the foundational build configuration for Spring Data Neo4j version 8.2.0-SNAPSHOT. It adds a Maven pom.xml defining the project structure, including dependencies for the Neo4j Java Driver (6.2.1), Neo4j Server (5.26.21), Cypher DSL (2025.2.7), and ArchUnit (1.4.1). Additionally, it includes a package.json file to manage Node.js dependencies for the documentation build, specifically Antora (3.2.0-alpha.6) and related Spring extensions.
(dependencies) · high confidence
Upgrade Maven Wrapper to version 3.9.16
The project's Maven Wrapper has been upgraded to version 3.9.16. This update ensures that builds use the latest stable Maven distribution, providing users with improved build performance, bug fixes, and compatibility with the latest Maven features.
.mvn/wrapper · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 64 → 62 (-2.4)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 83 → 83 (-0.0)
- Architecture 67 → 65 (-1.9)
- Maturity 65 → 65 (-0.1)
- Readiness 60 → 60 (+0.6)
- Security 64 → 57 (-7.1)
- Performance 100 → 100 (+0.0)
Resolved (109)
- ADR not followed: adr-006 (etc/adr/adr-006.adoc)
- ADR not followed: adr-008 (etc/adr/adr-008.adoc)
- Change coupling: IdDescription.java ↔ CypherAdapterUtils.java (src/main/java/org/springframework/data/neo4j/core/mapping/IdDescription.java)
- Consequences are mostly an educated guess ('probably more network traffic') and do not state trade-offs such as loss of implicit saves or the cost of updating every property each save (etc/adr/adr-004.adoc)
- Context is thin (JDK8 deprecated; Neo4j 4.0 build on JDK11) and decision is a placeholder ('Not yet made'), with consequences only partially written ('+ We would target a modern platform') before the clip marker (etc/adr/adr-002.adoc)
- Decision is restated in context rather than being an explicit decision statement; the body does not state what relationship with properties will look like or how it differs from association (etc/adr/adr-005.adoc)
- No assertions: assignedIdNoVersionShouldNotOverwriteUnknownProperties (src/test/java/org/springframework/data/neo4j/integration/properties/PropertyIT.java)
- No assertions: assignedIdNoVersionShouldNotOverwriteUnknownProperties (src/test/java/org/springframework/data/neo4j/integration/properties/ReactivePropertyIT.java)
- No assertions: assignedIdWithVersionShouldNotOverwriteUnknownProperties (src/test/java/org/springframework/data/neo4j/integration/properties/PropertyIT.java)
- No assertions: assignedIdWithVersionShouldNotOverwriteUnknownProperties (src/test/java/org/springframework/data/neo4j/integration/properties/ReactivePropertyIT.java)
- No assertions: compositePropertiesOnNodesShouldBeWritten (src/test/java/org/springframework/data/neo4j/integration/conversion_imperative/ImperativeCompositePropertiesIT.java)
- No assertions: compositePropertiesOnRelationshipsShouldBeWritten (src/test/java/org/springframework/data/neo4j/integration/conversion_imperative/ImperativeCompositePropertiesIT.java)
- No assertions: dontCallIdForDerivedQueriesWithInClause (src/test/java/org/springframework/data/neo4j/integration/issues/pure_element_id/ImperativeElementIdIT.java)
- No assertions: dontCallIdForDerivedQueriesWithInClause (src/test/java/org/springframework/data/neo4j/integration/issues/pure_element_id/ReactiveElementIdIT.java)
- No assertions: dontCallIdForDerivedQueriesWithRelatedInClause (src/test/java/org/springframework/data/neo4j/integration/issues/pure_element_id/ImperativeElementIdIT.java)
- No assertions: dontCallIdForDerivedQueriesWithRelatedInClause (src/test/java/org/springframework/data/neo4j/integration/issues/pure_element_id/ReactiveElementIdIT.java)
- No assertions: entitiesWithAssignedIdsMustBeIdentifiableWithTheirInternalIds (src/test/java/org/springframework/data/neo4j/integration/issues/IssuesIT.java)
- No assertions: entitiesWithAssignedIdsMustBeIdentifiableWithTheirInternalIds (src/test/java/org/springframework/data/neo4j/integration/issues/ReactiveIssuesIT.java)
- No assertions: entitiesWithAssignedIdsSavedInBatchMustBeIdentifiableWithTheirInternalIds (src/test/java/org/springframework/data/neo4j/integration/issues/ReactiveIssuesIT.java)
- No assertions: existingObjectsSave (src/test/java/org/springframework/data/neo4j/integration/versioned_self_references/OptimisticLockingOfSelfReferencesIT.java)
- …and 89 more
New (3)
- High interface indirection
- Neo4jPersistenceExceptionTranslator.translateExceptionIfPossible (cyclomatic 16) (src/main/java/org/springframework/data/neo4j/core/Neo4jPersistenceExceptionTranslator.java)
- Off-boarding risk: anonymized user #1
Changes since last survey
- 7 commits — 7 feature/other, 0 fixes
By area
- src/main — 3 commits
- src/test — 2 commits
- (root) — 1 commit
- .github/workflows — 1 commit
Notable commits
- change: Do not treat transient properties as associations
- change: Fix spelling error in a test class.
- change: GH-3125: Skip projection lookup for non-projecting return types (#3126)
- change: Prepare next development iteration.
- change: Support durations exceeding Integer.MAX_VALUE seconds (#3135)
- change: Translate more than one record in Neo4jClient#one() into IncorrectResultSizeDataAccessException (#3137)
- change: Update portfolio train workflow (v0.0.8).
Architecture
- Unchanged — 0 containers · 1 contexts · 0 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
spring-projects/spring-data-neo4j was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 9 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 69a81919cc9f52d00e8123ac4fb6a516359f6623 — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-b921b700395b.