spring-data-neo4j

SKILL.md

Spring Data Neo4j integration for graph databases with repositories, Cypher queries, and reactive operations.

Three abstraction levels: Neo4j Client (low-level), Neo4j Template (medium-level), and Neo4j Repositories (high-level query derivation)

Supports both imperative Neo4jRepository and reactive ReactiveNeo4jRepository patterns; do not mix both in the same application

Entity mapping with @Node and @Relationship annotations, supporting business keys or generated IDs with immutable field design

Custom Cypher queries via @Query annotation with parameterized syntax; includes query derivation from method names for simple cases

Built-in testing support via Neo4j Harness with embedded databases and test fixtures; requires explicit Cypher-DSL dialect configuration

Spring Data Neo4j Integration Patterns

Overview

Provides Spring Data Neo4j integration patterns for Spring Boot applications. Covers node entity mapping with @Node and @Relationship, repository configuration (imperative and reactive), custom Cypher queries with @Query, and integration testing with embedded Neo4j databases.

When to Use

Use this skill when working with:

Graph databases and Neo4j integration in Spring Boot

Node entities, relationships, and Cypher queries

Spring Data Neo4j repositories (imperative or reactive)

Neo4j testing with embedded databases

Instructions

1. Set Up Spring Data Neo4j

Add the dependency: