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

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

4.1.3 添加配置文件

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

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

4.2 代码整合过程

4.2.1 自定义节点与实体类映射

使用注解将 Java 对象映射为图数据库中的节点。注意区分 @NodeEntity (旧版) 和 @Node (新版)。

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

@Node("Person")
public class Person {
    @Id
    private Long id;
    
    @Property("name")
    private String name;
    
    // Getters and Setters
}

4.2.2 自定义 JPA Repository

继承 Neo4jRepository 即可获取基础 CRUD 方法，也可自定义 Cypher 查询。

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

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

4.3 代码整合测试

4.3.1 保存 Person 以及关系数据

通过 Service 层操作 Repository，自动处理节点创建和关系建立。

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

    public void savePerson(Person person) {
        personRepository.save(person);
    }
}

4.3.2 查询数据

利用内置方法或自定义 Cypher 语句进行检索。

// 简单查询
List<Person> people = personRepository.findAll();

// 复杂关系查询
String cypher = "MATCH (a:Person)-[r:FRIEND]->(b:Person) RETURN b";
Result result = session.query(cypher, Collections.emptyMap());

4.3.3 JPA 自定义方法规则

Spring Data Neo4j 支持根据方法名自动生成查询，例如 findByAgeGreaterThan(int age)。对于复杂图遍历，建议直接使用 @Query 注解编写 Cypher。

五、写在文末

通过上述步骤，我们完成了 SpringBoot 与 Neo4j 的无缝集成。在实际微服务架构中，图数据库能有效解决传统 SQL 难以处理的深层关联查询问题。开发者只需关注业务逻辑建模，底层的数据交互由框架自动处理。希望这篇指南能帮助你快速上手图数据库开发。