Spring Boot 整合 Neo4j的过程详解

 更新时间:2025年10月31日 10:20:30   作者:上官箫羽  
Neo4j是一个高性能的​图数据库​​,适用于存储和查询节点(Node)​​和​​关系(Relationship)​​的数据,本文介绍在springboot项目中整合neo4j,并实现基本的crud操作,感兴趣的朋友跟随小编一起看看吧

        Neo4j 是一个高性能的 ​​图数据库​​,适用于存储和查询 ​​节点(Node)​​ 和 ​​关系(Relationship)​​ 的数据。本教程将带你从零开始,在 ​​Spring Boot​​ 项目中整合 ​​Neo4j​​,并实现基本的 ​​CRUD​​ 操作。

​​1. Neo4j 简介​​

Neo4j 是一个 ​​原生图数据库​​,采用 ​​属性图模型​​,数据由 ​​节点(Node)​​ 和 ​​关系(Relationship)​​ 组成,每个节点和关系都可以有 ​​属性(Property)​​。

​​Neo4j 的核心概念​​

概念说明
​节点(Node)​类似于关系数据库中的 ​​记录​​,可以有标签(Label)和属性(Property)。
​关系(Relationship)​连接两个节点,有方向(单向或双向),可以有类型(Type)和属性(Property)。
​属性(Property)​键值对(Key-Value),可以存储在节点或关系上。
​标签(Label)​类似于关系数据库中的 ​​表​​,用于分类节点。
​类型(Type)​类似于关系数据库中的 ​​外键​​,用于定义关系的类型。

2. 环境准备​​

​​2.1 安装 Neo4j​​

​​方式 1:本地安装(Docker 方式)

docker run \
    --name neo4j \
    -p 7474:7474 -p 7687:7687 \
    -e NEO4J_AUTH=neo4j/123456 \
    neo4j:5.12.0
  • ​7474​​:Neo4j Web 管理界面端口
  • ​7687​​:Neo4j 数据库端口(Bolt 协议)
  • ​NEO4J_AUTH=neo4j/123456​​:默认用户名 neo4j,密码 123456

访问 ​​Neo4j Web 界面​​:http://localhost:7474

​​方式 2:云服务(Neo4j Aura)​​

  • 官网:https://neo4j.com/cloud/aura/
  • 免费试用,无需本地安装。

​​2.2 创建 Spring Boot 项目​​

使用 ​​Spring Initializr​​ 创建项目:

  • ​依赖​​:
    • ​Spring Web​
    • ​Spring Data Neo4j​

https://i.imgur.com/xyz1234.png

3. Spring Boot 整合 Neo4j​​

​​3.1 添加 Neo4j 依赖​​

在 pom.xml 中添加:

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

3.2 配置 Neo4j 连接​​

在 application.yml 或 application.properties 中配置:

spring:
  data:
    neo4j:
      uri: bolt://localhost:7687  # Neo4j Bolt 协议地址
      username: neo4j             # 默认用户名
      password: 123456            # 默认密码

3.3 创建 Neo4j 实体类​​

Neo4j 的实体类使用 @Node 注解标记,类似于 JPA 的 @Entity

​​示例:定义Person节点​

import org.springframework.data.neo4j.core.schema.Id;
import org.springframework.data.neo4j.core.schema.Node;
import org.springframework.data.neo4j.core.schema.Property;
@Node("Person")  // 定义节点标签为 "Person"
public class Person {
    @Id  // 主键
    private Long id;
    @Property("name")  // 属性名
    private String name;
    @Property("age")
    private Integer age;
    // 构造方法、Getter、Setter
    public Person() {}
    public Person(Long id, String name, Integer age) {
        this.id = id;
        this.name = name;
        this.age = age;
    }
    // Getter & Setter
    public Long getId() { return id; }
    public void setId(Long id) { this.id = id; }
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public Integer getAge() { return age; }
    public void setAge(Integer age) { this.age = age; }
}

3.4 创建 Neo4j Repository​​

类似于 JPA 的 JpaRepository,Neo4j 提供 Neo4jRepository 用于 CRUD 操作。

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);
}

3.5 创建 Service 层​

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;
@Service
public class PersonService {
    @Autowired
    private PersonRepository personRepository;
    // 保存 Person
    public Person savePerson(Person person) {
        return personRepository.save(person);
    }
    // 查询所有 Person
    public List<Person> findAllPersons() {
        return personRepository.findAll();
    }
    // 按名字查询 Person
    public List<Person> findByName(String name) {
        return personRepository.findByName(name);
    }
    // 删除 Person
    public void deletePerson(Long id) {
        personRepository.deleteById(id);
    }
}

3.6 创建 Controller 层​

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import java.util.List;
@RestController
@RequestMapping("/api/persons")
public class PersonController {
    @Autowired
    private PersonService personService;
    // 新增 Person
    @PostMapping
    public Person addPerson(@RequestBody Person person) {
        return personService.savePerson(person);
    }
    // 查询所有 Person
    @GetMapping
    public List<Person> getAllPersons() {
        return personService.findAllPersons();
    }
    // 按名字查询 Person
    @GetMapping("/name/{name}")
    public List<Person> getPersonsByName(@PathVariable String name) {
        return personService.findByName(name);
    }
    // 删除 Person
    @DeleteMapping("/{id}")
    public void deletePerson(@PathVariable Long id) {
        personService.deletePerson(id);
    }
}

4. 测试 Neo4j 操作​​

​​4.1 启动 Spring Boot 项目​​

运行 SpringBootApplication 主类,访问:

  • ​Neo4j Web 界面​​:http://localhost:7474
  • ​API 接口​​:
    • POST /api/persons(新增 Person)
    • GET /api/persons(查询所有 Person)
    • GET /api/persons/name/{name}(按名字查询)
    • DELETE /api/persons/{id}(删除 Person)

​​4.2 使用 Postman 测试​​

​​(1) 新增 Person​

POST http://localhost:8080/api/persons
{
    "id": 1,
    "name": "Alice",
    "age": 25
}

(2) 查询所有 Person​

GET http://localhost:8080/api/persons

​​(3) 按名字查询​

GET http://localhost:8080/api/persons/name/Alice

(4) 删除 Person​

DELETE http://localhost:8080/api/persons/1

5. 进阶:定义关系(Relationship)​​

Neo4j 不仅可以存储节点,还可以定义 ​​关系​​。例如,Person 和 Movie 之间可以有 ACTED_IN 关系。

​​5.1 定义Movie节点​

@Node("Movie")
public class Movie {
    @Id
    private Long id;
    @Property("title")
    private String title;
    // Getter & Setter
}

5.2 定义关系​​

使用 @Relationship 注解定义关系:

import org.springframework.data.neo4j.core.schema.Relationship;
@Node("Person")
public class Person {
    @Id
    private Long id;
    @Property("name")
    private String name;
    @Property("age")
    private Integer age;
    @Relationship(type = "ACTED_IN", direction = Relationship.Direction.OUTGOING)
    private List<Movie> movies;
    // Getter & Setter
}

6. 总结​​

步骤说明
​1. 安装 Neo4j​本地 Docker 或云服务
​2. 创建 Spring Boot 项目​添加 spring-boot-starter-data-neo4j
​3. 配置 Neo4j 连接​application.yml 配置
​4. 定义 Neo4j 实体​使用 @Node 注解
​5. 创建 Repository​继承 Neo4jRepository
​6. 实现 CRUD 操作​Service + Controller
​7. 测试 API​Postman 或浏览器

到此这篇关于Spring Boot 整合 Neo4j的文章就介绍到这了,更多相关Spring Boot 整合 Neo4j内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 手把手带你粗略了解Java--类和对象

    手把手带你粗略了解Java--类和对象

    这篇文章主要给大家介绍了关于java中类和对象的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-08-08
  • java SpringBoot自定义注解,及自定义解析器实现对象自动注入操作

    java SpringBoot自定义注解,及自定义解析器实现对象自动注入操作

    这篇文章主要介绍了java SpringBoot自定义注解,及自定义解析器实现对象自动注入操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-08-08
  • 基于Java实现回调监听工具类

    基于Java实现回调监听工具类

    这篇文章主要为大家详细介绍了如何基于Java实现一个回调监听工具类,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
    2025-04-04
  • MybatisPlus实现对象嵌套关联查询一对多List集合查询

    MybatisPlus实现对象嵌套关联查询一对多List集合查询

    这篇文章主要介绍了MybatisPlus实现对象嵌套关联查询一对多List集合查询,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-05-05
  • SpringBoot实现数据预热的方式小结

    SpringBoot实现数据预热的方式小结

    这里用到的数据预热,就是在项目启动时将一些数据量较大的数据加载到缓存中(笔者这里用的Redis),那么在项目启动有哪些方式可以实现数据预热呢,本文就来给大家讲讲几种实现数据预热的方式,需要的朋友可以参考下
    2023-09-09
  • 剑指Offer之Java算法习题精讲数组与字符串

    剑指Offer之Java算法习题精讲数组与字符串

    跟着思路走,之后从简单题入手,反复去看,做过之后可能会忘记,之后再做一次,记不住就反复做,反复寻求思路和规律,慢慢积累就会发现质的变化
    2022-03-03
  • SpringBoot之为何推荐使用构造器注入

    SpringBoot之为何推荐使用构造器注入

    这篇文章主要介绍了SpringBoot之为何推荐使用构造器注入问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-03-03
  • Spring 跨域配置请求详解

    Spring 跨域配置请求详解

    这篇文章主要介绍了Spring 跨域配置请求详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-01-01
  • SpringBoot整合Sa-Token实现RBAC权限模型的过程解析

    SpringBoot整合Sa-Token实现RBAC权限模型的过程解析

    这篇文章主要介绍了SpringBoot整合Sa-Token实现RBAC权限模型的过程解析,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2025-05-05
  • 使用SpringBoot设置虚拟路径映射绝对路径

    使用SpringBoot设置虚拟路径映射绝对路径

    这篇文章主要介绍了使用SpringBoot设置虚拟路径映射绝对路径的操作,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-08-08

最新评论