查询创建

本章将讨论在使用 SDN 的抽象层时，查询的技术创建过程。由于我们不会讨论所有可能的情况，而是坚持其背后的总体思想，因此会进行一些简化。

保存

除了 find/load 操作之外，save 操作是在处理数据时最常用的操作之一。通常，保存操作调用会针对数据库发出多个语句，以确保生成的图模型与给定的 Java 模型匹配。

  1. 将创建一个联合语句，如果找不到节点的标识符，则创建节点；如果节点本身存在，则更新节点的属性。

    (OPTIONAL MATCH (hlp:Person) WHERE id(hlp) = $__id__ WITH hlp WHERE hlp IS NULL CREATE (n:Person) SET n = $__properties__ RETURN id(n) UNION MATCH (n) WHERE id(n) = $__id__ SET n = $__properties__ RETURN id(n))

  2. 如果实体**不是**新的，则将域模型中找到的第一种类型的全部关系从数据库中删除。

    (MATCH (startNode)-[rel:Has]→(:Hobby) WHERE id(startNode) = $fromId DELETE rel)

  3. 相关实体将以与根实体相同的方式创建。

    (OPTIONAL MATCH (hlp:Hobby) WHERE id(hlp) = $__id__ WITH hlp WHERE hlp IS NULL CREATE (n:Hobby) SET n = $__properties__ RETURN id(n) UNION MATCH (n) WHERE id(n) = $__id__ SET n = $__properties__ RETURN id(n))

  4. 关系本身将被创建

    (MATCH (startNode) WHERE id(startNode) = $fromId MATCH (endNode) WHERE id(endNode) = 631 MERGE (startNode)-[:Has]→(endNode))

  5. 如果相关实体也与其他实体具有关系，则将启动与步骤 2. 相同的过程。

  6. 对于根实体上定义的下一个关系，从步骤 2. 开始，但将“first”替换为“next”。

如您所见，SDN 尽最大努力使您的图模型与 Java 世界保持同步。这就是我们强烈建议您不要加载、操作和保存子图的原因之一，因为这可能会导致关系从数据库中删除。

多个实体

save 操作重载了接受相同类型多个实体的功能。如果您使用的是生成的 ID 值或使用乐观锁，则每个实体都将导致单独的 CREATE 调用。

在其他情况下，SDN 将创建包含实体信息的参数列表，并使用 MERGE 调用提供它。

UNWIND $__entities__ AS entity MERGE (n:Person {customId: entity.$__id__}) SET n = entity.__properties__ RETURN collect(n.customId) AS $__ids__

参数如下所示

:params {__entities__: [{__id__: 'aa', __properties__: {name: "PersonName", theId: "aa"}}, {__id__ 'bb', __properties__: {name: "AnotherPersonName", theId: "bb"}}]}

加载

load 文档不仅会向您展示查询的 MATCH 部分的外观，还会展示数据的返回方式。

最简单的加载操作类型是 findById 调用。它将匹配与您查询的类型的标签匹配的所有节点，并对 ID 值进行过滤。

MATCH (n:Person) WHERE id(n) = 1364

如果提供了自定义 ID，则 SDN 将使用您定义为 ID 的属性。

MATCH (n:Person) WHERE n.customId = 'anId'

要返回的数据定义为 映射投影。

RETURN n{.first_name, .personNumber, __internalNeo4jId__: id(n), __nodeLabels__: labels(n)}

如您所见，其中有两个特殊字段：__internalNeo4jId__ 和 __nodeLabels__。在将数据映射到 Java 对象时，这两个字段都至关重要。__internalNeo4jId__ 的值要么是 id(n)，要么是提供的自定义 ID，但在映射过程中必须存在一个已知的引用字段。__nodeLabels__ 确保可以找到并映射此节点上的所有定义的标签。这对于使用继承且您没有查询具体类或定义仅定义超类型的关系的情况是必要的。

谈到关系：如果您在实体中定义了关系，它们将作为 模式推导 添加到返回的映射中。然后，上面的返回部分将如下所示

RETURN n{.first_name, …​, Person_Has_Hobby: [(n)-[:Has]→(n_hobbies:Hobby)|n_hobbies{__internalNeo4jId__: id(n_hobbies), .name, nodeLabels: labels(n_hobbies)}]}

SDN 使用的映射投影和模式推导确保仅查询您定义的属性和关系。

在您具有自引用节点或创建可能导致返回数据中出现循环的架构的情况下，SDN 会回退到级联/数据驱动的查询创建。从查找特定节点并考虑条件的初始查询开始，它会遍历结果节点，如果它们的关系也已映射，则会动态创建更多查询。此查询创建和执行循环将继续，直到没有查询找到新的关系或节点。创建方式可以类比于保存/更新过程。