订阅事件
这是 GraphQL 库 7 版的文档。对于长期支持 (LTS) 的 5 版,请参阅 GraphQL 库 5 LTS。 |
此页面介绍了 Neo4j GraphQL 库提供的各种订阅选项。
CREATE
对 CREATE
事件的订阅**仅**监听新创建的节点,而不监听新关系。在这种情况下,每次创建新节点时都会触发一个新事件,其中包含其属性。
此操作通过顶级订阅 [type]Created
执行,该订阅包含以下字段:
-
event
:触发此订阅的事件(在本例中为CREATE
)。 -
created<typename>
:新创建节点的顶级属性,不包含关系。 -
timestamp
:发生突变的时间戳。如果同一个查询触发多个事件,它们应具有相同的时间戳。
例如,请考虑以下类型定义:
type Movie @node {
title: String
genre: String
}
extend schema @subscription
对 Movie
类型任何新创建节点的订阅应如下所示:
subscription {
movieCreated {
createdMovie {
title
genre
}
event
timestamp
}
}
UPDATE
对 UPDATE
事件的订阅**仅**监听节点属性的更改,而不监听其他字段的更新。在这种情况下,每次修改节点顶级属性的突变都会触发一个新事件。
此操作通过顶级订阅 [type]Updated
执行,该订阅包含以下字段:
-
event
:触发此订阅的事件(在本例中为UPDATE
)。 -
updated<typename>
:更新节点的顶级属性,不包含关系。 -
previousState
:UPDATE
事件发生前节点的先前顶级属性。 -
timestamp
:发生突变的时间戳。如果同一个查询触发多个事件,它们应具有相同的时间戳。
例如,请考虑以下类型定义:
type Movie @node {
title: String
genre: String
}
extend schema @subscription
对 Movie
类型中其属性最近更新的任何节点的订阅应如下所示:
subscription MovieUpdated {
movieUpdated {
event
previousState {
title
genre
}
updatedMovie {
title
}
timestamp
}
}
DELETE
对 DELETE
事件的订阅**仅**监听被删除的节点,而不监听被删除的关系。此操作通过顶级订阅 [type]Deleted
执行,该订阅包含以下字段:
-
event
:触发此订阅的事件(在本例中为DELETE
)。 -
deleted<typename>
:已删除节点的顶级属性,不包含关系。 -
timestamp
:发生突变的时间戳。如果同一个查询触发多个事件,它们应具有相同的时间戳。
例如,请考虑以下类型定义:
type Movie @node {
title: String
genre: String
}
extend schema @subscription
对 Movie
类型中任何已删除节点的订阅应如下所示:
subscription {
movieDeleted {
deletedMovie {
title
}
event
timestamp
}
}