安装

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

驱动程序需要 Java 17 或更高版本。

安装驱动程序

如果您已经拥有 Maven 项目,您可以将驱动程序作为依赖项添加到您的 pom.xml 文件中

<dependency>
    <groupId>org.neo4j.driver</groupId>
    <artifactId>neo4j-java-driver</artifactId>
    <version>5.26.0</version>
</dependency>
如何为 Neo4j Java 应用程序创建 Maven 项目?

如果您不熟悉 Maven,您可以下载 Neo4j 演示应用程序示例项目 并将其用作基础来试验驱动程序并构建您的应用程序。

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

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

对于其他依赖项管理系统,请参阅 驱动程序的软件包页面.

始终使用最新版本的驱动程序,因为它始终适用于之前的 Neo4j LTS 版本以及当前和下一个主要版本。最新的 5.x 驱动程序支持连接到任何 Neo4j 5 和 4.4 实例,并且也将与 Neo4j 6 兼容。有关不同版本之间更改的详细列表,请参阅 驱动程序的更改日志.

获取 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 桌面 创建本地开发环境(不适用于生产环境)。

词汇表

LTS

长期支持 版本是保证支持多年的一种版本。Neo4j 4.4 是 LTS,Neo4j 5 也将有一个 LTS 版本。

Aura

Aura 是 Neo4j 的完全托管云服务。它提供免费和付费计划。

Cypher

Cypher 是 Neo4j 的图查询语言,它允许您从数据库中检索数据。它类似于 SQL,但适用于图。

APOC

Cypher 上的强大程序 (APOC) 是一个包含(许多)函数的库,这些函数无法轻松地用 Cypher 本身表示。

Bolt

Bolt 是 Neo4j 实例和驱动程序之间交互使用的协议。默认情况下,它监听端口 7687。

ACID

原子性、一致性、隔离性、持久性 (ACID) 是保证数据库事务可靠处理的属性。符合 ACID 的 DBMS 确保数据库中的数据在发生故障时保持准确一致。

最终一致性

如果数据库保证所有集群成员最终都会在某个时间点存储数据的最新版本,则该数据库最终是一致的。

因果一致性

如果数据库保证所有集群成员以相同的顺序看到读和写查询,则该数据库是因果一致的。这比最终一致性更强。

NULL

空标记不是一种类型,而是表示缺少值的占位符。有关详细信息,请参阅 Cypher → 使用 null.

事务

事务是工作单元,要么全部提交,要么在失败时回滚。一个例子是银行转账:它涉及多个步骤,但它们必须全部成功或被恢复,以避免从一个帐户中扣除资金而没有添加到另一个帐户。

背压

背压是反对数据流的力量。它确保客户端不会被比它所能处理的更快的速度的数据所淹没。

事务函数

事务函数是由 executeReadexecuteWrite 调用执行的回调。如果发生服务器故障,驱动程序会自动重新执行回调。

驱动程序

一个 Driver 对象包含与 Neo4j 数据库建立连接所需的详细信息。