Neo4j 5.x 中 Java API 的变更
本页面列出了 Neo4j 4.4 到 Neo4j 5.x 之间 Java API 的变更。
类、接口和枚举的变更
| 类 | 变更 | 操作 |
|---|---|---|
|
已移除 |
格式在 Log4j 2 配置文件中进行配置。 |
|
已移除 |
直接使用 |
|
已移除 |
使用独立工具。 |
|
已移除 |
用于在线备份。 |
|
已移除 |
使用 |
|
已移除 |
使用 |
|
已移除 |
意外添加到公共 API 中。 |
|
已移除 |
用于已移除设置的枚举。 |
|
已移除 |
用于已移除设置的枚举。 |
|
已移除 |
用于已移除设置的枚举。 |
|
已移除 |
用于已移除设置的枚举。 |
| 类 | 变更 | 操作 |
|---|---|---|
|
新增 |
用于为 |
|
5.0 引入 5.26 废弃 |
种子提供程序的入口点。详见 SeedProvider。 |
|
5.26 引入 |
|
|
新增 |
|
|
新增 |
设置中使用的枚举。 |
|
新增 |
设置中使用的枚举。 |
方法的变更
org.neo4j.logging.Log
以下方法已被移除
| 方法 | 变更 | 操作 |
|---|---|---|
|
已移除 |
直接使用 |
|
已移除 |
直接使用 |
|
已移除 |
直接使用 |
|
已移除 |
直接使用 |
org.neo4j.graphdb.Entity
以下方法已添加。它们在继承自 Node 和 Relationship 的类中可见
| 方法 | 变更 | 操作 |
|---|---|---|
|
新增 |
返回唯一元素 ID。仅保证在事务内唯一。 |
|
新增 |
从 |
org.neo4j.graphdb.spatial.Coordinate
以下方法已被移除
| 方法 | 变更 | 操作 |
|---|---|---|
|
已移除 |
由以下两个方法取代 |
org.neo4j.graphdb.Transaction
已添加以下方法
| 方法 | 变更 | 操作 |
|---|---|---|
|
新增 |
通过元素 ID 查找节点。 |
|
新增 |
通过元素 ID 查找关系。 |
org.neo4j.harness.junit.extension.Neo4jExtensionBuilder
以下方法已被移除
| 方法 | 变更 | 操作 |
|---|---|---|
|
已移除 |
使用 |
|
已移除 |
使用 |
|
已移除 |
已移除。 |
|
已移除 |
使用 |
org.neo4j.harness.junit.rule.Neo4jRule
以下方法已被移除
| 方法 | 变更 | 操作 |
|---|---|---|
|
已移除 |
使用 |
|
已移除 |
使用 |
|
已移除 |
已移除。 |
|
已移除 |
使用 |
org.neo4j.harness.Neo4jBuilders
以下方法已被移除
| 方法 | 变更 | 操作 |
|---|---|---|
|
已移除 |
使用 |
org.neo4j.harness.Neo4jConfigurator<T>
以下方法已被移除
| 方法 | 变更 | 操作 |
|---|---|---|
|
已移除 |
使用 |
|
已移除 |
已移除。 |
|
已移除 |
使用 |
|
已移除 |
使用 |
com.neo4j.harness.junit.rule.EnterpriseNeo4jRule
接受 File 参数的已废弃构造函数已被移除
| 方法 | 变更 | 操作 |
|---|---|---|
|
已移除 |
使用 |
org.neo4j.kernel.api.exceptions.Status
有关 Neo4j 5.x 中的状态码变更日志,请参阅 状态码 → 各 Neo4j 版本中的状态码变更。
错误和通知状态码 详细介绍了 Neo4j 的错误和通知框架。
重命名的类、接口和枚举
| 原名称 | 新名称 |
|---|---|
|
|
|
|
|
|
org.neo4j.graphdb.event.DatabaseEventListener
以下两个方法不再具有默认实现,监听器必须实现它们
-
void databaseCreate(DatabaseEventContext) -
void databaseDrop(DatabaseEventContext)
org.neo4j.graphdb.Node
以下方法已更改为返回 ResourceIterable 而非 Iterable
| 方法 | 变更 |
|---|---|
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
org.neo4j.dbms.api.DatabaseManagementServiceBuilder
此类现已实现 Neo4jDatabaseManagementServiceBuilder,这是推荐使用的新接口。作为此次变更的一部分,以下字段和方法已被移除,因为它们暴露了内部实现
-
Config.Builder config -
List<DatabaseEventListener> databaseEventListeners -
DependencyResolver dependencies -
List<ExtensionFactory<?>> extensions -
Path homeDirectory -
Monitors monitors -
Map<String,URLAccessRule> urlAccessRules -
LogProvider userLogProvider -
DatabaseManagementServiceBuilder(File) -
DatabaseManagementServiceBuilder(Path, Predicate<Class<? extends ExtensionFactory>>) -
DatabaseManagementServiceBuilder loadPropertiesFromFile(String) -
DatabaseManagementServiceBuilder setConfigRaw(Map<String,String>) -
DatabaseManagementServiceBuilder setExternalDependencies(DependencyResolver) -
DatabaseManagementServiceBuilder setMonitors(Monitors) -
DatabaseManagementServiceBuilder addURLAccessRule(String, URLAccessRule) -
DatabaseManagementService newDatabaseManagementService(Config, ExternalDependencies) -
DbmsInfo getDbmsInfo(Config) -
String getEdition() -
Function<GlobalModule,AbstractEditionModule> getEditionFactory(Config) -
Config augmentConfig(Config) -
ExternalDependencies databaseDependencies()
Neo4j 设置变更
com.neo4j.configuration.OnlineBackupSettings
| 设置 | 变更 |
|---|---|
|
已移除 |
|
新增 |
com.neo4j.configuration.MetricsSettings
所有用于启用或禁用指标类型的设置均被 metrics_filter 取代,该设置接受用于匹配要启用指标的正则表达式
| 设置 | 变更 |
|---|---|
|
新增 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
com.neo4j.configuration.OnlineBackupSettings
| 设置 | 变更 |
|---|---|
|
新增 |
|
已移除 |
com.neo4j.configuration.SecuritySettings
| 设置 | 变更 |
|---|---|
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
已移除 |
作为日志记录变更的一部分,以下设置已被移除并移至 Log4j 2 配置文件中
| 设置 | 变更 |
|---|---|
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
com.neo4j.configuration.SecuritySettings.OIDCSetting
| 设置 | 变更 |
|---|---|
|
新增 |
|
已移除 |
com.neo4j.configuration.EnterpriseEditionSettings
| 设置 | 变更 |
|---|---|
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
已移除 |
|
已移除 |
Neo4j 集群设置变更
com.neo4j.configuration.ClusterNetworkSettings
| 设置 | 变更 |
|---|---|
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
com.neo4j.configuration.KubernetesSettings
| 设置 | 变更 |
|---|---|
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
com.neo4j.configuration.ClusterSettings
添加了一些常量
| 设置 | 变更 |
|---|---|
|
新增 |
|
新增 |
|
新增 |
以下设置已移至 ClusterNetworkSettings 类并重命名
| 设置 | 变更 |
|---|---|
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
以下设置已移至 KubernetesSettings
| 设置 | 变更 |
|---|---|
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
已添加以下设置
| 设置 | 变更 |
|---|---|
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
以下设置已被移除
| 设置 | 变更 |
|---|---|
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
org.neo4j.configuration.connectors.BoltConnector
| 设置 | 变更 |
|---|---|
|
已移除 |
org.neo4j.configuration.GraphDatabaseSettings
已添加以下设置
| 设置 | 变更 |
|---|---|
|
新增 |
|
新增 |
以下设置已被移除
| 设置 | 变更 |
|---|---|
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
设置 record_format 已重命名为 db_format,以便未来可以选择非记录格式
| 设置 | 变更 |
|---|---|
|
新增 |
|
已移除 |
以下设置已被移除,其默认值现已永久生效
| 设置 | 变更 |
|---|---|
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
设置 pagecache_memory 的类型已更改
| 设置 | 变更 |
|---|---|
|
新增 |
|
已移除 |
作为日志记录变更的一部分,添加了两个指向 Log4j 2 配置文件的设置。所有旧的日志设置已被移除
| 设置 | 变更 |
|---|---|
|
新增 |
|
新增 |
|
新增 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
|
已移除 |
SeedProvider 的变更
在 Neo4j 5.26 中,SeedProvider 已被废弃,由 DatabaseSeedProvider 取代。更多详细信息,请参阅 Java 参考 → DatabaseSeedProvider。
遍历 API (Traversal API) 的变更
遍历 API 可以通过 Transaction.traversalDescription() 和 Transaction.bidirectionalTraversalDescription() 访问。获取完整文档,请参阅 Java 参考 → 遍历框架。
作为遍历 API 一部分新增的类、接口和枚举
| 接口 | org.neo4j.graphdb.traversal.BidirectionalTraversalDescription |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
org.neo4j.graphdb.PathExpanders
添加了一些常用的 `PathExpander`
| 设置 | 变更 |
|---|---|
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
结果 API (Result API) 的变更
在 Neo4j 5.26 LTS 中,结果 API 的 getNotifications() 方法和 NotificationCategory 类已被废弃。它们分别由结果 API 的 getGqlStatusObjects() 方法和 NotificationClassification 类取代。
ErrorGqlStatusObject API 的变更
Neo4j 5.26 LTS 引入了 ErrorGqlStatusObject API。有关 Neo4j 中错误状态码的完整文档,请参阅 错误和通知状态码 → 服务器错误。