GraphQL API
GraphQL API
在前面的章节讲到了使用GraphQL 进行实体的定义。
GraphQL 是一种用于API查询的语言，对 API 中的数据提供了一套易于理解的完整描述，使得客户端能够准确地获得它需要的数据。因而可以用于描述数据实体，也可以用于请求想要的数据，得到结果。子图中的数据实体就是使用 GraphQL 接口定义语言（IDL）来描述和定义。
本节来说明如何在HyperGraph 中使用GraphQL查询数据。
查询
在子图 schema.graphql 中，定义了称为实体的类型。对于每种实体类型，将在顶层查询类型上生成一个实体和实体关联的字段。
例子
查询您在实体定义文件中定义的单个Token实体：
{
token(id: "1") {
id
owner
}}
注意：查询单个实体时，id字段是必填字段，并且必须是字符串，一般是地址或者Hash等具有唯一标识作用的值。
查询所有Token实体：
tokens {
id
owner
}}
排序
查询集合时，可以使用orderBy参数按特定属性进行排序。另外，orderDirection可用于指定排序方向，升序表示升序，降序表示降序。
例子
{
tokens(orderBy: price, orderDirection: asc) {
id
owner
}}
分页
查询集合时，可以使用第一个参数从集合的开头进行分页。值得注意的是，默认排序顺序是按ID升序字母和数字顺序排序，而不是按创建时间。
此外，skip参数可用于跳过实体和分页。例如 first：100 显示前100个实体，first：100，skip：100 显示以第100个开始的下100个实体。这跟SQL查询中的 Limit start, number 很像。
查询应避免使用非常大的skip值，因为它们通常速度会很慢。对于检索大量数据，最好根据上一个示例中所示的属性来对实体进行分页。
例子
查询前10个Token：
tokens(first: 10) {
id
owner
}}
为了查询集合中间的一组实体，可以将skip参数与first参数结合使用，以从集合的开头开始跳过指定数量的实体。
例子
查询10个Token实体，从集合开始偏移10个位置：
tokens(first: 10, skip: 10) {
id
owner
}}
例子
如果需要检索大量实体，则将查询基于属性并按该属性进行过滤会更有效率。例如，使用以下查询检索大量Token实体的数据：
{
query manyTokens($lastID: String) {
tokens(first: 1000, where: { id_gt: $lastID }) {
id
owner
}
}}
第一次，它将发送带有 lastID =“” 的查询，并且对于后续请求，会将lastID 设置为上一个请求中最后一个实体的id属性。与使用增加的skip值相比，此方法的性能要好得多。
筛选
您可以在查询中使用where参数来筛选不同的属性。您可以过滤where参数中的多个值，也就是说在where中设置多个条件。
例子
查询失败的 challenge：
{
challenges(where: { outcome: "failed" }) {
challenger
outcome
application {
id
}
}}
您可以使用诸如_gt，_lte之类的后缀进行值比较：
例子
{
applications(where: { deposit_gt: "10000000000" }) {
id
whitelisted
deposit
}}
参数后缀的完整列表：
_not
_gt
_lt
_gte
_lte
_in
_not_in
_contains
_not_contains
_starts_with
_ends_with
_not_starts_with
_not_ends_with
请注意，某些后缀仅适用于特定类型。例如，布尔仅支持_not，_in和_not_in。
时间遍历查询
您不仅可以查询最新区块中实体的状态（默认情况下是查最新块），还可以查询过去的任意区块的状态。通过在查询的顶层字段中包含block参数，可以通过其块号或其块哈希来指定进行查询的块。
这样的查询结果不会随时间变化，即，无论执行什么时候，在特定的过去的块中查询都将返回相同的结果，但有一个例外，如果您在非常靠近以太坊开始的块中进行查询，如果该区块不在主链上并且链被重组，结果可能会改变。一旦一个块可以被认为是最终确认的，查询的结果将不会改变。
例子
{
challenges(block: { number: 8000000 }) {
challenger
outcome
application {
id
}
}}
该查询将返回challenge实体及其关联的应用程序实体，因为它们在8,000,000块后直接存在。
例子
{
challenges(block: { hash: "0x5a0b54d5dc17e0aadc383d2db43b0a0d3e029c4c" }) {
challenger
outcome
application {
id
}
}}
该查询将返回challenge实体及其关联的应用程序实体，因为它们是在使用给定哈希所对应的块之后直接存在的。
Last updated