在graphql模式中在连接中有边缘和节点的原因是什么？

Question

我试图理解实现继电器光标连接规范的更复杂的graphql

如果您查看我在github graphql api资源管理器上运行的下面的查询

{
  repository(owner: "getsmarter", name: "moodle-api") {
    id
    issues(first:2 ) {
      edges {
        node {
          id
          body
        }
      }
      nodes {
        body
      }
      pageInfo {
        endCursor
        hasNextPage
        hasPreviousPage
        startCursor
      }
      totalCount
    } 
  }
}

注意，它有字段、边、和节点。

为什么github在其api中有一个额外的字段称为节点？为什么他们不直接使用边缘字段，因为您可以从边缘获取相同的数据？这只是为了方便吗？

Answer 1

如果我们查看公共连接实现的一般结构，通常有以下内容: TypeA -> TypeAToTypeBConnection (通常是TypeA上的字段，名称类似于typeBConnection)、-> TypeAToTypeBEdge (通常是与名称edges连接的名称字段) -> TypeB (通常字段名位于带有名称node的边缘)

A -> connection -> edges -> B

连接类型通常有包含特定于整个连接的信息的字段，这些信息通常是分页信息、总数等。

边缘类型通常具有特定于该连接但并非所有节点通用的信息的字段。本例中最常见的字段是cursor，它表示连接中的节点‘位置’，它不是全局唯一的ID，而是返回到连接中该位置的一种方法。

节点类型通常只是连接的类型，它不包含特定于连接的信息。

在github的API中，Edge类型具有通常实现的cursor字段，可以在以后的连接中用作引用。在不需要游标的情况下，它们还有一个绕过edge类型的字段。这就是为什么直接从连接类型中看到edges和nodes字段的原因。

要查看这些游标字段，您可以发送以下查询来查看我正在说的内容：

{
  repository(owner: "getsmarter", name: "moodle-api") {
    issues(first:2 ) {
      edges {
        cursor
        node {
          id
        }
      }
    }
  }
}

有关这种连接样式的更多细节，请在这里查看：https://facebook.github.io/relay/graphql/connections.htm

编辑-附加响应：允许访问连接处的边缘类型和节点类型，至少有两个原因我可以想到。首先，为了方便使用API的人，当他们的用例不需要游标时。其次，可能有一种情况，根据发送的查询，它们甚至不需要生成游标。第二个问题可能是CPU时间的最小节省，而且可能会带来比它更大的麻烦。

过去在GraphQL端点中实现游标之后，一旦您克服了如何实现游标，实际生成它们就不会那么困难了。这只是一个序列化几个关键信息的问题。同样值得注意的是，一旦您已经创建了边缘类型，那么提供两者(A->conn->edge->B和A->conn->B)是非常简单的。

因为我不为吉特布工作，我不能告诉你确切的意图是什么。然而，我肯定认为这是…的第一个原因简单的开发方便。

Answer 2

无论如何到达节点，节点总是相同的。边缘是连接上下文中有关该节点的元数据，通常只是光标，但如果连接表示搜索查询，则还可以添加关联得分之类的内容。该数据不应该存在于节点本身，因为它在不同的上下文中没有任何意义。

术语

1. Node表示一个实体。在由直线连接的圆圈图中，这些就是圆。
2. Edge，将两个节点连接在一起，可能包括元数据。在图表中，这些是线条。
3. Connection，一个分页的节点列表。在图表中，这将是一行的集合。

Answer 3

这可能只是他们的一个方便，因为他们可能有一些疯狂的查询，它减少了在JavaScript中的对象查找。边还将包含一个cursor属性和一个node属性，它们可能不需要所有的属性，因此拥有顶级node字段的另一个好处就是。

我还应该指出，edge/cursor约定非常适合于特定于中继的环境，而且是一个基于游标的分页系统，您只能通过一个索引/页移动。如果您希望创建一个更基于遗留的分页系统，那么您就不必实现这种分页。

中断游标分页的用例是，如果客户端想跳转到第5页，并且在第1页上，这在Relay中是不可能的，因为游标是不透明的，是当前集合中“何处”的基础。

希望这能帮上忙！