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 的变更
遍历 API 可以通过 Transaction.traversalDescription() 和 Transaction.bidirectionalTraversalDescription() 访问。有关完整文档,请参阅 Java 参考 → 遍历框架。
作为遍历 API 的一部分新增的类、接口和枚举
| 接口 | org.neo4j.graphdb.traversal.BidirectionalTraversalDescription |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
org.neo4j.graphdb.PathExpanders
新增了一些常用的 PathExpander
| 设置 | 变更 |
|---|---|
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
|
新增 |
结果 API 的变更
在 Neo4j 5.26 LTS 中,Result API 的 getNotifications() 方法和 NotificationCategory 类已被弃用。它们分别被 Result API 的 getGqlStatusObjects() 方法和 NotificationClassification 类替代。
ErrorGqlStatusObject API 的变更
Neo4j 5.26 LTS 引入了 ErrorGqlStatusObject API。有关 Neo4j 中错误状态码的完整文档,请参阅 错误和通知的状态码 → 服务器错误。