SpringBoot 整合 Neo4j 图数据库项目实战详解

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

<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 自定义节点与实体类映射

使用 @Node 注解将 Java 类映射为图数据库中的节点。注意，Neo4j 5.x 后推荐使用 @Node 替代旧的 @NodeEntity。

import org.neo4j.driver.types.Node;
import org.springframework.data.neo4j.core.schema.GeneratedValue;
import org.springframework.data.neo4j.core.schema.Id;
import org.springframework.data.neo4j.core.schema.Node;

@Node("Person")
public class Person {
    @Id
    @GeneratedValue
    private Long id;
    private String name;
    private int age;

    // Getter and Setter omitted for brevity
}

4.2.2 自定义 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 进行数据写入。若需建立关系，可使用 @Relationship 注解或在代码中显式构建。

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

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

4.3.2 查询数据

利用 Spring Data 的方法命名规则或自定义 Cypher 语句查询。

// 方法命名规则查询
List<Person> friends = personRepository.findByName("Alice");

// 或者自定义 Cypher
@Query("MATCH (p:Person {name: $name}) RETURN p")
List<Person> findByCustomQuery(@Param("name") String name);

4.3.3 JPA 自定义方法规则

Spring Data Neo4j 支持部分 Cypher 语法嵌入方法名，例如 findByNameAndAgeGreaterThan，但复杂逻辑建议直接使用 @Query 注解编写 Cypher 语句，以获得最佳性能和可读性。

五、写在文末

通过上述步骤，我们完成了 SpringBoot 与 Neo4j 的基础整合。在实际项目中，图数据库特别适合处理推荐系统、欺诈检测等涉及复杂关系的场景。希望这篇指南能帮助你快速上手，如有问题欢迎交流探讨。