片段

的GraphQL 规范定义了两种类型的片段：

命名的片段，允许多个操作或选择集中重用一组字段。
内联片段，可以将字段组成一组并应用类型条件或指令，但 不可重用。

命名和内联片段都可以用作类型条件，这允许您访问聚合类型的字段。

阅读关于类型条件的指南以了解更多信息。

命名的片段

命名的片段定义在 .graphql文件，就像一个操作定义。一个命名的碎片始终有一个名称和一个“父类型”，即它可以应用到的模式中的类型。此碎片可以包含在操作定义的选择集中。

Apollo iOS为命名的碎片生成单独的结果类型，这意味着它们是一种保持UI组件或工具函数独立于特定查询的极佳方式。

HeroDetailsFragment.graphql

fragment HeroDetails on Character {
  name
  appearsIn
}

HeroAndFriendsQuery.graphql

query HeroAndFriends {
  hero {
    name
    ...HeroDetails
    friends {
      ...HeroDetails
    }
  }
}

Apollo iOS为HeroDetails碎片生成一个类型安全的模型，看起来像这样（省略详情以关注类结构）：

HeroDetails.graphql.swift

1
struct HeroDetails: MySchema.SelectionSet, Fragment {
2
  let name: String
3
  let appearsIn: [Episode]
4
}

为HeroAndFriendsQuery生成的结果数据模型将包括HeroDetails碎片的字段，并且能够转换为HeroDetails模型的格式。

HeroAndFriendsQuery.graphql.swift

1
class HeroAndFriendsQuery: GraphQLQuery {
2
  struct Data: SelectionSet {
3
    let hero: Hero
4

5
    struct Hero: SelectionSet {
6
      let name: String
7
      let friends: [Friend]
8
      let appearsIn: [Episode]
9

10
      // Fragment Conversion Declaration
11
      var fragments: Fragments
12
      struct Fragments {
13
        var heroDetails: HeroDetails { ... }
14
      }
15

16
      struct Friend: SelectionSet {
17
        let name: String
18
        let appearsIn: [Episode]
19

20
        // Fragment Conversion Declaration
21
        var fragments: Fragments
22
        struct Fragments {
23
          var heroDetails: HeroDetails { ... }
24
        }
25
      }
26
    }
27
  }
28
}

碎片转换

一个定义中包含碎片的结果模型将包含一个Fragments结构体以支持碎片的转换。

以上Hero和Friend模型均包含Fragments结构体，并且可以被转换为HeroDetails碎片

1
let hero: HeroDetails = data.hero.fragments.heroDetails
2
let friends: [HeroDetails] = data.hero.friends.map { $0.fragments.heroDetails }

碎片重用

碎片转换允许您在不同操作或同一操作内的多个对象间重用碎片作为通用模型。

一种常见的模式是为子视图定义碎片，并在父级定义的查询中包含这个碎片。这样，子视图可以轻松重用，并且只依赖于它所需的特定数据。

上面的HeroDetails碎片被用于Hero和Friend模型，但可以通过显示一个包含HeroDetails碎片模型的视图列表来在你的应用程序中显示英雄与其朋友。

HeroDetailsView.swift

1
struct HeroDetailsListView: View {
2
  let data: HeroAndFriendsQuery.Data
3

4
  var body: some View {
5
    VStack {
6
      HeroDetailsView(hero: data.hero.fragments.heroDetails)
7
      for friend in data.hero.friends {
8
        HeroDetailsView(hero: friend.fragments.heroDetails)
9
      }
10
    }
11
  }
12
}
13

14
struct HeroDetailsView: View {
15
  let hero: HeroDetails
16

17
  var body: some View {
18
    HStack {
19
      Text(hero.name)
20
      Text(hero.appearsIn.description)
21
    }
22
  }
23
}

您可以向HeroDetails碎片添加更多数据，并在HeroDetailsView中显示这些数据，而不会对父视图造成任何影响。此外，HeroDetailsView可用于包含HeroDetails碎片的任何其他GraphQL操作

内联碎片

内联碎片是一个没有名称的碎片。它在另一个定义中“内联”声明，无法重用。内联碎片可以包含在操作定义、命名碎片定义中，或嵌套在另一个内联碎片内。它们通常用于使用类型条件或@skip/@include指令有条件地包含字段

Apollo iOS不会为内联碎片生成单个模型，而是影响包含它们的操作或碎片的生成模型。

您可以使用内联碎片和类型条件来查询类型特定的字段:

1
query HeroAndFriends($episode: Episode) {
2
  hero(episode: $episode) {
3
    name
4
    ... on Droid {
5
      primaryFunction
6
    }
7
  }
8
}

内联碎片与类型条件的结果将通过特别生成的as<Type>属性提供：

1
let name: String = data.hero.name
2
let primaryFunction: String = data.hero.asDroid?.primaryFunction

有关如何使用内联碎片作为类型条件的更多信息，请参阅类型条件文档。

操作参数