SpringBoot 整合 Neo4j 图数据库实战指南

SpringBoot 整合 Neo4j

前置准备

版本选择

建议使用 Spring Boot 2.7+ 配合 Spring Data Neo4j 6.x，兼容性较好。

导入依赖

在 pom.xml 中添加以下依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-neo4j</artifactId>
</dependency>

添加配置文件

在 application.yml 中配置连接信息：

spring:
  data:
    neo4j:
      uri: bolt://localhost:7687
      username: neo4j
      password: password

代码整合过程

自定义节点与实体类映射

使用注解将 Java 对象映射为图数据库中的节点。注意，主键通常由 ID 字段自动管理。

import org.neo4j.ogm.annotation.NodeEntity;
import org.neo4j.ogm.annotation.Id;
import org.neo4j.ogm.annotation.Property;

@NodeEntity(label = "Person")
public class Person {
    @Id
    private Long id;
    
    @Property(name = "name")
    private String name;
    
    // Getter and Setter
}

自定义 JPA

继承 Neo4jRepository 接口即可获取基础 CRUD 能力，无需编写实现类。

import org.springframework.data.neo4j.repository.Neo4jRepository;

public interface PersonRepository extends Neo4jRepository<Person, Long> {
    // 自定义查询方法
    List<Person> findByName(String name);
}

代码整合测试

保存 Person 以及关系数据

创建一个 Service 层来操作数据。这里演示如何创建两个节点并建立关系。

@Service
public class PersonService {
    @Autowired
    private PersonRepository personRepository;

    public void saveData() {
        Person alice = new Person();
        alice.setName("Alice");
        
        Person bob = new Person();
        bob.setName("Bob");
        
        // 保存节点
        personRepository.save(alice);
        personRepository.save(bob);
        
        // 实际开发中通常通过 Repository 方法直接建立关系
        // 此处仅为逻辑示意
    }
}

查询数据

利用 Spring Data 的方法命名约定进行查询，或者使用 @Query 注解执行原生 Cypher。

// 方法命名查询
List<Person> findByAgeGreaterThan(int age);

// 原生 Cypher 查询
@Query("MATCH (p:Person) WHERE p.name = {name} RETURN p")
Optional<Person> findByName(@Param("name") String name);

JPA 自定义方法规则

除了标准 CRUD，还可以结合 Cypher 进行复杂查询。例如查找朋友的朋友：

MATCH (a:Person)-[:KNOWS]->(b:Person)-[:KNOWS]->(c:Person)
WHERE a.name = 'Alice'
RETURN c.name

写在文末

通过上述步骤，我们完成了从环境搭建到代码集成的全过程。Neo4j 在处理复杂关系数据时优势明显，但在使用时也需注意内存管理和查询优化。希望这篇实战指南能帮助你快速上手图数据库开发。