Question

我想了解这些不同的GraphQL指令。我试图在网上找到这些指令，但没有得到解释。请说明这些不同类型的指令。

enum __DirectiveLocation {
    QUERY,
    MUTATION,
    SUBSCRIPTION,
    FIELD,
    FRAGMENT_DEFINITION,
    FRAGMENT_SPREAD,
    INLINE_FRAGMENT,
    SCHEMA,
    SCALAR,
    OBJECT,
    FIELD_DEFINITION,
    ARGUMENT_DEFINITION,
    INTERFACE,
    UNION,
    ENUM,
    ENUM_VALUE,
    INPUT_OBJECT,
    INPUT_FIELD_DEFINITION
}

Answer 1

GraphQL指令可在任何GraphQL document中使用-包括操作（如查询和变异）以及用于定义特定模式的类型定义。指令必须指定一个或多个locations。这些位置分为两组。

ExecutableDirectiveLocation用于可执行文档（即包含可执行操作的文档）。这包括：

QUERY
MUTATION
SUBSCRIPTION
FIELD
FRAGMENT_DEFINITION
FRAGMENT_SPREAD
INLINE_FRAGMENT

类型系统定义（即用于创建模式的类型定义）内部的位置称为TypeSystemDirectiveLocation，其中包括：

SCHEMA
SCALAR
OBJECT
FIELD_DEFINITION
ARGUMENT_DEFINITION
INTERFACE
UNION
ENUM
ENUM_VALUE
INPUT_OBJECT
INPUT_FIELD_DEFINITION

GraphQL文档可以表示为由AST节点组成的抽象语法树（AST）对象。上面的每个位置都与同一个名称的ASTNode匹配。

使用一个或多个TypeSystemDirectiveLocations的伪指令称为schema directives。像Apollo Server这样的库允许我们为架构指令定义逻辑，该逻辑可用于转换该指令所附加的架构元素。例如，使用Apollo Server，我们扩展了SchemaDirectiveVisitor类，该类在每个可能的位置都有一个method －在生成架构时将调用该方法，以确定如何更改对象中的目标元素。模式。

使用ExecutableDirectiveLocations的指令称为客户端指令。即使这些是规范的一部分，也仅存在两个标准的客户端指令-@skip和@include。可以定义其他自定义客户端指令，但是目前还没有一种在服务器上实现它们的好方法（至少在Node.js生态系统中没有）。

下面是每个指令位置的用法示例：

schema @SCHEMA {
  query: Query
}

scalar DateTime @SCALAR

type SomeType @OBJECT {
  someField(someArg: Int! @ARGUMENT_DEFINITION): String @FIELD_DEFINITION 
}

interface SomeInterface @INTERFACE {
  someField: String
}

union SomeUnion @UNION = SomeType | SomeOtherType

enum SomeEnum @ENUM {
  someEnumValue @ENUM_VALUE
}

input SomeInputType @INPUT_OBJECT {
  someInputField: String @INPUT_FIELD_DEFINITION 
}

对于可执行文件：

query MyQuery @QUERY {
  someField @FIELD
  someOtherField {
    ...MyFragment @FRAGMENT_SPREAD
    ... on SomeType @INLINE_FRAGMENT {
      aDifferentField
    }
  }
}

fragment MyFragment @FRAGMENT_DEFINITION {
  yetAnotherField
}

mutation MyMutation @MUTATION {
  doSomething
}

subscription MySubscription @SUBSCRIPTION {
  somethingHappened
}

各种GraphQL指令的说明

1 个答案: