安装

要开始创建 Neo4j Java 应用程序，首先需要安装 Java 驱动并获取一个可连接的 Neo4j 数据库实例。

该驱动要求 Java 17 或更高版本。

安装驱动程序

如果您已经有一个 Maven 项目，可以在 pom.xml 文件中将驱动添加为依赖。

<dependency>
    <groupId>org.neo4j.driver</groupId>
    <artifactId>neo4j-java-driver</artifactId>
    <version>6.0.4</version>
</dependency>

如何为 Neo4j Java 应用程序创建 Maven 项目？

如果您对 Maven 还不熟悉，可以下载 Neo4j 示例应用项目，并以此为基础试验驱动和构建您的应用程序。

文件 App.java 提供了一个骨架应用程序。您可以使用以下命令编译并运行该项目：

mvn package
java -jar target/neo4j-demo-app-1.0-SNAPSHOT-jar-with-dependencies.jar

对于其他依赖管理系统，请参考驱动的包页面。

驱动的最新版本保证兼容所有 LTS 版 Neo4j 服务器，以及当前和下一个主要版本。最新的 6.x 驱动支持连接至版本为 4.4、5.x 和 2025.x 的 Neo4j 实例。有关各版本更改的详细列表，请参阅驱动的更新日志。

获取 Neo4j 实例

您需要一个正在运行的 Neo4j 数据库才能与驱动程序一起使用。启动本地实例最简单的方法是通过 Docker 容器（需要 docker.io）。以下命令在 Docker 中运行最新的 Neo4j 版本，并将管理员用户名设置为 neo4j，密码设置为 secretgraph。

docker run \
   -p7474:7474 \                       # forward port 7474 (HTTP)
   -p7687:7687 \                       # forward port 7687 (Bolt)
   -d \                                # run in background
   -e NEO4J_AUTH=neo4j/secretgraph \   # set login credentials
   neo4j:latest

或者，您也可以通过 Aura 获取免费的云实例。

您还可以在您的系统上安装 Neo4j，或使用 Neo4j Desktop 创建本地开发环境（不适用于生产环境）。

术语表

LTS (长期支持版): 长期支持 (Long Term Support) 版本是保证在若干年内得到支持的版本。Neo4j 4.4 和 5.26 是 LTS 版本。
Aura: Aura 是 Neo4j 的全托管云服务。它提供免费和付费计划。
Cypher: Cypher 是 Neo4j 的图查询语言，允许您从数据库中检索数据。它就像 SQL，但专用于图数据库。
APOC: Awesome Procedures On Cypher (APOC) 是一个包含（许多）函数的库，这些函数在 Cypher 本身中难以轻松实现。
Bolt: Bolt 是用于 Neo4j 实例和驱动程序之间交互的协议。默认监听 7687 端口。
ACID: 原子性 (Atomicity)、一致性 (Consistency)、隔离性 (Isolation)、持久性 (Durability) (ACID) 是保证数据库事务可靠处理的属性。符合 ACID 的 DBMS 确保即使发生故障，数据库中的数据也能保持准确和一致。
最终一致性: 如果一个数据库能保证所有集群成员在某个时间点都存储了数据的最新版本，则该数据库具有最终一致性。
因果一致性: 如果读写查询被集群中的每个成员以相同的顺序看到，则数据库具有因果一致性。这比最终一致性更强。
NULL: 空标记不是一种类型，而是缺失值的占位符。更多信息，请参阅 Cypher → 使用 null。
事务: 事务是一个工作单元，要么被提交，要么在失败时被回滚。例如银行转账：它涉及多个步骤，但它们必须全部成功或全部撤销，以避免钱从一个账户扣除却未存入另一个账户的情况。
背压: 背压是对数据流的抵抗力。它确保客户端不会被过快发送的数据压垮，从而超出其处理能力。
书签: 书签是代表数据库某种状态的标记。通过将一个或多个书签与查询一起传递，服务器将确保在所表示的状态建立之前，该查询不会被执行。
事务函数: 事务函数是由 executeRead 或 executeWrite 调用执行的回调。如果发生服务器故障，驱动程序会自动重新执行该回调。
驱动程序 (Driver): Driver 对象保存了与 Neo4j 数据库建立连接所需的详细信息。