最新的稳定版本请使用 Spring Data Neo4j 7.3.1！Spring中文文档

最新的稳定版本请使用 Spring Data Neo4j 7.3.1！Spring中文文档

要求

关于 JDK 版本

选择 JDK 17 是一个受各种方面影响的决定Spring中文文档

  • SDN 是一个 Spring Data 项目。 Spring Data commons 基线是 JDK 17，Spring Framework 的基线也是如此。 因此，保持 JDK 17 基线是很自然的。Spring中文文档

运行生成

以下部分是替代方法，大致按增加的工作量排序。Spring中文文档

所有生成都需要项目的本地副本：Spring中文文档

克隆 SDN
$ git clone [email protected]:spring-projects/spring-data-neo4j.git

在继续操作之前，请验证本地安装的 JDK 版本。 输出应类似：Spring中文文档

验证 JDK
$ java -version
java version "18.0.1" 2022-04-19
Java(TM) SE Runtime Environment (build 18.0.1+10-24)
Java HotSpot(TM) 64-Bit Server VM (build 18.0.1+10-24, mixed mode, sharing)

安装 Docker 后

使用默认映像

如果您尚未安装 Docker，请前往 Docker Desktop。 简而言之，Docker 是一种工具，可帮助您在所谓的容器中使用操作系统级虚拟化来运行轻量级软件映像。Spring中文文档

我们的构建使用 Testcontainers Neo4j 来启动数据库实例。Spring中文文档

在 Linux / macOS 上使用默认设置构建
$ ./mvnw clean verify

在 Windows 计算机上，使用Spring中文文档

在 Windows 上使用默认设置进行构建
$ mvnw.cmd clean verify

输出应类似。Spring中文文档

使用其他图像

可以通过环境变量配置要使用的映像版本，如下所示：Spring中文文档

使用不同的 Neo4j Docker 镜像构建
$ SDN_NEO4J_VERSION=5.3.0-enterprise SDN_NEO4J_ACCEPT_COMMERCIAL_EDITION=yes ./mvnw clean verify

这里我们使用的是 5.3.0 企业版，也接受许可协议。Spring中文文档

如果以内联方式指定环境变量不适合您，请查阅您的操作系统或 shell 手册，了解如何定义环境变量。Spring中文文档

针对本地运行的数据库

对本地运行的数据库运行将擦除其完整内容。

针对本地运行的数据库进行构建速度更快，因为它不会每次都重新启动容器。 我们在开发过程中经常这样做。Spring中文文档

您可以在我们的下载中心免费获得 Neo4j 的副本。Spring中文文档

请下载适用于您的操作系统的版本，然后按照说明启动它。 必需的步骤是在启动数据库后打开浏览器并转到 localhost：7474，并将默认密码从您喜欢的密码更改为您喜欢的密码。neo4jSpring中文文档

之后，您可以通过指定本地 URL 来运行完整的构建：boltSpring中文文档

使用本地运行的数据库进行生成
$ SDN_NEO4J_URL=bolt://localhost:7687 SDN_NEO4J_PASSWORD=verysecret ./mvnw clean verify
对本地运行的数据库运行将擦除其完整内容。

控制生成的环境变量摘要

名字 默认值 意义

SDN_NEO4J_VERSIONSpring中文文档

5.3.0Spring中文文档

要使用的 Neo4j docker 镜像版本，参见 Neo4j Docker 官方镜像Spring中文文档

SDN_NEO4J_ACCEPT_COMMERCIAL_EDITIONSpring中文文档

不Spring中文文档

某些测试可能需要 Neo4j 的企业版。 我们在内部针对企业版进行构建和测试，但我们不会强迫您 如果您不想接受许可证，请接受许可证。Spring中文文档

SDN_NEO4J_URLSpring中文文档

未设置Spring中文文档

设置此环境允许连接到本地运行的 Neo4j 实例。 我们在开发过程中经常使用它。Spring中文文档

SDN_NEO4J_PASSWORDSpring中文文档

未设置Spring中文文档

配置了 的实例用户的密码。neo4jSDN_NEO4J_URLSpring中文文档
您需要同时设置并使用本地实例。SDN_NEO4J_URLSDN_NEO4J_PASSWORD
名字 默认值 意义

SDN_NEO4J_VERSIONSpring中文文档

5.3.0Spring中文文档

要使用的 Neo4j docker 镜像版本，参见 Neo4j Docker 官方镜像Spring中文文档

SDN_NEO4J_ACCEPT_COMMERCIAL_EDITIONSpring中文文档

不Spring中文文档

某些测试可能需要 Neo4j 的企业版。 我们在内部针对企业版进行构建和测试，但我们不会强迫您 如果您不想接受许可证，请接受许可证。Spring中文文档

SDN_NEO4J_URLSpring中文文档

未设置Spring中文文档

设置此环境允许连接到本地运行的 Neo4j 实例。 我们在开发过程中经常使用它。Spring中文文档

SDN_NEO4J_PASSWORDSpring中文文档

未设置Spring中文文档

配置了 的实例用户的密码。neo4jSDN_NEO4J_URLSpring中文文档
您需要同时设置并使用本地实例。SDN_NEO4J_URLSDN_NEO4J_PASSWORD

Checkstyle和朋友们

目前没有质量门槛来确保代码/测试比率保持不变，但请考虑将测试添加到您的贡献中。Spring中文文档

我们有一些相当温和的检查样式规则，或多或少地强制执行默认的 Java 格式规则。 您的构建将因格式错误或未使用的导入等原因而中断。Spring中文文档