自从2.8

使用上下文来共享数据

在不过度加载@keys的情况下，沿着类型层次结构共享数据

该@context和@fromContext是指令，属于Apollo企业功能的ApolloRouter并且需要拥有一个

GraphOS Enterprise计划。如果你的组织没有企业计划，你可以通过注册一个免费的

为了让后代能访问祖先的字段，你可以将其添加为 @key 字段到链中的每个实体，但这可能会造成问题。deeply nested types 可能会改变许多实体的 @key 字段。添加的字段可能与其添加到的实体无关。最重要的是，过度使用 @key 字段经常打破不同子图之间的关注点分离。

使用 @context 和 @fromContext 指令，可以允许一个子图在不加载 @key 字段的情况下共享字段。您可以使用这些指令在一个子图中定义一个或多个 上下文。上下文提供了子图在嵌套类型层次结构中共享数据的方式，同时不会过度使用实体键中的无关字段。上下文还保持了不同子图之间的关注点分离。

使用一个上下文

以下是一个单一上下文的示例，下面的子图跟踪每个用户最后一次金融交易。 Transaction 类型是 User 类型的子类。每个交易都依赖于相关用户的货币来计算交易额。这种依赖性— currencyCode 参数—取决于用户的货币 userCurrency { isoCode } 的一User— 是通过上下文定义的。在 User 上的 @context 指令设置上下文，在 currencyCode 上的 @fromContext 获取上下文数据。

示例：使用 @context 和 @fromContext

1
scalar CurrencyCode;
2

3
type Currency {
4
   id: ID!
5
   isoCode: CurrencyCode!
6
}
7

8
type User @key(fields: "id") @context(name: "userContext") {
9
   id: ID!
10
   lastTransaction: Transaction!
11
   userCurrency: Currency!
12
}
13

14
type Transaction @key(fields: "id") {
15
  id: ID!
16
  currency: Currency!
17
  amount: Int!
18
  amountInUserCurrency(
19
    currencyCode: CurrencyCode
20
        @fromContext(field: "$userContext { userCurrency { isoCode } }")
21
  ): Int!
22
}

ⓘ 注意

上下文名称不能包含下划线。
- 在上面的示例中，userContext 是一个有效的上下文名称，但 user_context 就不是。
@fromContext 的参数在API架构中不存在。相反，它由路由器自动填充。
- 在上面的示例中，参数 currencyCode: CurrencyCode! 不会出现在API架构中。

在 @fromContext 中使用类型条件

在这个示例中，注意@fromContext指令是如何使用一系列类型条件来选择访问Child.prop1时的所需字段。如果没有所有可能的上下文都有一个字段，那么就不需要类型条件，例如Child.prop2的情况。

示例：使用多个上下文

1
type Query {
2
  a: A!
3
  b: B!
4
  c: C!
5
}
6

7
type A @key(fields: "id") @context(name: "context1"){
8
  id: ID!
9
  field: String!
10
  someField: String!
11
  child: Child!
12
} 
13

14
type B @key(fields: "id") @context(name: "context1"){
15
  id: ID!
16
  field: String!
17
  someField: String!
18
  child: Child!
19
} 
20

21
type C @key(fields: "id") @context(name: "context1") {
22
  id: ID!
23
  field: String!
24
  someOtherField: String!
25
  child: Child!
26
} 
27

28
type Child @key(fields: "id") {
29
  id: ID!
30
  prop1(
31
    arg: String! 
32
        @fromContext(field: "$context1 ... on A { someField } ... on B { someField } ... on C { someOtherField }")
33
  ): Int!
34
  prop2(
35
    arg: String! 
36
        @fromContext(field: "$context1 { field }")
37
  ): Int!
38
}

如果相同上下文值设置在多个位置——就像示例中的Child.prop1和Child.prop2参数——那么FieldValue必须将每个位置的所有类型解析为单个与参数类型匹配的值。

ⓘ 注意

联接不保证如果字段可通过多个上下文访问，将使用哪个上下文。

区分上下文

当类型层次结构中的多个祖先实体可能满足一组上下文时，会选择最近的祖先。例如，如果类型的父亲和祖父母都能提供上下文的值，则选择父辈，因为它比父辈更接近。

在以下示例中，给定嵌套类型A，B和C，其中C引用的上下文可以是A或B提供，C使用B的值，因为它是比A更近的祖先：

1
type Query { 
2
  a: A!
3
}
4

5
type A @key(fields: "id") @context(name: "context1") {
6
  id: ID!
7
  field: String!
8
  b: B!
9
} 
10

11
type B @key(fields: "id") @context(name: "context1") {
12
  id: ID!
13
  field: String!
14
  c: C!
15
} 
16

17
type C @key(fields: "id") {
18
  id: ID!
19
  prop(
20
    arg: String! @fromContext(field: "$context1 { field }")
21
  ): Int!
22
}

在一个更复杂的图形中，一个字段可以通过多个路径访问，并且可以使用不同的字段根据使用的路径来解析prop。

跨子图引用字段

上下文作用域的定义只能存在于一个子图模式中。 @fromContext 指令不能引用其他 @context 子图中定义的上下文。然而，您可以使用上下文通过 @external 引用在不同子图间共享数据。

以重用 Transaction 示例为例，想象一个用于处理 User 和 Currency 类型的 子图：

1
scalar CurrencyCode
2

3
type Currency @shareable {
4
   id: ID!
5
   isoCode: CurrencyCode!
6
}
7

8
type User @key(fields: "id") {
9
   id: ID!
10
   userCurrency: Currency!
11
}

如果您想从另一个子图中引用这些字段，您可以使用 @external 指令在子图边界传递数据：

1
scalar CurrencyCode
2

3
type Currency @shareable {
4
   id: ID!
5
   isoCode: CurrencyCode!
6
}
7

8
type User @key(fields: "id") @context(name: "userContext") {
9
   id: ID!
10
   
11
  # This is a reference to the field resolved elsewhere
12
   userCurrency: Currency! @external
13
   
14
   # We add this field to our type here
15
   lastTransaction: Transaction! 
16
}
17

18
type Transaction @key(fields: "id") {
19
  id: ID!
20
  currency: Currency!
21
  amount: Int!
22
  amountInUserCurrency(
23
    currencyCode: CurrencyCode 
24
        @fromContext(field: "$userContext { userCurrency { isoCode } }")
25
  ): Int!
26
}

解析另一个子图的字段

实体接口