Kratos微服务框架下实现GraphQL服务

Kratos 微服务框架下实现 GraphQL 服务

GraphQL 是一种用于应用编程接口（API）的查询语言和服务器端运行时，它可以使客户端准确地获得所需的数据，没有任何冗余。

GraphQL 由 Facebook 开发，并于 2012 年首次应用于移动应用。GraphQL 规范于 2015 年实现开源。现在，它受 GraphQL 基金会监管。

GraphQL 有什么用？

GraphQL 旨在让 API 变得快速、灵活并且为开发人员提供便利。它甚至可以部署在名为 GraphiQL 的集成开发环境（IDE）中。作为 REST 的替代方案，GraphQL 允许开发人员构建相应的请求，从而通过单个 API 调用从多个数据源中提取数据。

此外，GraphQL 还可让 API 维护人员灵活地添加或弃用字段，而不会影响现有查询。开发人员可以使用自己喜欢的方法来构建 API，并且 GraphQL 规范将确保它们以可预测的方式在客户端发挥作用。

GraphQL 的优缺点

GraphQL 的优点

• GraphQL 模式会在 GraphQL 应用中设置单一事实来源。它为企业提供了一种整合其整个 API 的方法。
• 一次往返通讯可以处理多个 GraphQL 调用。客户端可得到自己所请求的内容，不会超量。
• 严格定义的数据类型可减少客户端与服务器之间的通信错误。
• GraphQL 具有自检功能。客户端可以请求一个可用数据类型的列表。这非常适合文档的自动生成。
• GraphQL 允许应用 API 进行更新优化，而无需破坏现有查询。
• 许多开源 GraphQL 扩展可提供 REST API 所不具备的功能。
• GraphQL 不指定特定的应用架构。它能够以现有的 REST API 为基础，并与现有的 API 管理工具配合使用。

GraphQL 的缺点

• 即便是熟悉 REST API 的开发人员，也需要一定时间才能掌握 GraphQL。
• GraphQL 将数据查询的大部分工作都转移到服务器端，由此增加了服务器开发人员工作的复杂度。
• 根据不同的实施方式，GraphQL 可能需要不同于 REST API 的 API 管理策略，尤其是在考虑速率限制和定价的情况下。
• 缓存机制比 REST 更加复杂。
• API 维护人员还会面临编写可维护 GraphQL 模式的额外任务。

GraphQL 支持的数据类型以及关键字

标量类型

• Int：带符号的 32 位整数，对应 JavaScript 的 Number
• Float：带符号的双精度浮点数，对应 JavaScript 的 Number
• String：UTF-8 字符串，对应 JavaScript 的 String
• Boolean：布尔值，对应 JavaScript 的 Boolean
• ID：ID 值，是一个序列化后值唯一的字符串，可以视作对应 ES 2015 新增的 Symbol

高级类型

接口类型

Interface是包含一组确定字段的集合的抽象类型，实现该接口的类型必须包含interface定义的所有字段。比如：

interface Character {
   
  id: ID!
  name: String!
  friends: [Character]
  appearsIn: [Episode]!
}

type Human implements Character {
   
  id: ID!
  name: String!
  friends: [Character]
  appearsIn: [Episode]!
  starships: [Starship]
  totalCredits: Int
}

type Droid implements Character {
   
  id: ID!
  name: String!
  friends: [Character]
  appearsIn: [Episode]!
  primaryFunction: String
}

联合类型

Union 类型非常类似于 interface，但是他们在类型之间不需要指定任何共同的字段。通常用于描述某个字段能够支持的所有返回类型以及具体请求真正的返回类型。比如定义：

union SearchResult = Human | Droid | Starship

枚举类型

又称 Enums,这是一种特殊的标量类型，通过此类型，我们可以限制值为一组特殊的值。比如：

enum Episode {
   
  NEWHOPE
  EMPIRE
  JEDI
}

输入类型

input 类型对 mutations 来说非常重要，在 GraphQL schema 语言中，它看起来和常规的对象类型非常类似，但是我们使用关键字 input 而非 type,input 类型按如下定义：