GraphQL 是一种用于 API 的查询语言，它的主要优点是可以让客户端精确地获取需要的数据，从而减少网络传输量和提高效率。然而，在复杂的应用中，GraphQL Schema 可能会变得非常冗长和复杂，给开发带来很大的困难。本文将介绍如何解决这个问题，并提供一些示例代码来帮助读者理解。
问题描述
假设我们有一个电商平台，其中有很多商品，每个商品都有很多属性，如名称、描述、价格、库存等等。我们需要为客户端提供一个查询接口，让客户端可以根据自己的需要获取商品的信息。下面是一个简单的 GraphQL Schema：
-- -------------------- ---- ------- ---- ------- - --- --- ----- ------- ------------ ------- ------ ------ ------ ---- - ---- ----- - ----------- ----- ------- --------- ----------- -
这个 Schema 很简单，只有一个 Product 类型和两个查询字段。但是，如果我们需要为商品添加更多的属性，比如品牌、分类、尺寸、颜色等等，那么这个 Schema 就会变得非常冗长和复杂。而且，如果我们还需要支持商品的搜索和过滤，那么这个 Schema 就更加复杂了。
解决方法
为了解决这个问题，我们可以使用一些技巧来简化 Schema。下面是一些常用的技巧：
1. 使用接口
如果我们有多个类型具有相似的属性，比如品牌、分类、尺寸、颜色等等，那么我们可以将它们定义为一个接口，然后让这些类型实现这个接口。这样，我们就可以将这些类型的相似属性抽象出来，从而简化 Schema。
-- -------------------- ---- ------- --------- --------- - --- --- ----- ------- - ---- ----- ---------- --------- - --- --- ----- ------- --------- ----------- - ---- -------- ---------- --------- - --- --- ----- ------- --------- ----------- - ---- ---- ---------- --------- - --- --- ----- ------- --------- ----------- - ---- ----- ---------- --------- - --- --- ----- ------- --------- ----------- - ---- ------- - --- --- ----- ------- ------------ ------- ------ ------ ------ ---- ------ ------ --------- --------- ----- ----- ------ ------ - ---- ----- - ----------- ----- ------- --------- ----------- ------- --------- ----------- ------------ ------ -------- ------- --------- -
在上面的 Schema 中，我们定义了一个 Attribute 接口，然后让品牌、分类、尺寸、颜色等类型实现这个接口。然后，我们将这些类型的相似属性抽象出来，定义为一个接口的属性。最后，我们将这些属性添加到 Product 类型中。
2. 使用联合类型
如果我们有多个类型具有相似的查询接口，比如搜索、过滤等等，那么我们可以将它们定义为一个联合类型，然后让这些类型加入这个联合类型。这样，我们就可以将这些类型的相似查询接口抽象出来，从而简化 Schema。
union SearchResult = Product | Brand | Category | Size | Color
type Query {
search(query: String!): [SearchResult!]!
}在上面的 Schema 中，我们定义了一个 SearchResult 联合类型，然后让商品、品牌、分类、尺寸、颜色等类型加入这个联合类型。然后，我们定义了一个 search 查询字段，让客户端可以根据自己的需要搜索所有的 SearchResult 类型。
3. 使用输入对象
如果我们需要在查询中使用多个参数，比如搜索关键字、排序方式、分页信息等等，那么我们可以将这些参数定义为一个输入对象，然后在查询中使用这个输入对象。这样，我们就可以将多个参数合并成一个对象，从而简化 Schema。
-- -------------------- ---- ------- ----- ----------- - ------ ------ -------- ------ ------ --- ------- --- - ---- ----- - ------------- -------------- ---------------- -
在上面的 Schema 中，我们定义了一个 SearchInput 输入对象，然后将搜索关键字、排序方式、分页信息等参数添加到这个对象中。然后，我们定义了一个 search 查询字段，让客户端可以使用这个输入对象来搜索所有的 SearchResult 类型。
示例代码
下面是一个完整的示例代码，包含上述三种技巧的使用。
-- -------------------- ---- ------- --------- --------- - --- --- ----- ------- - ---- ----- ---------- --------- - --- --- ----- ------- --------- ----------- - ---- -------- ---------- --------- - --- --- ----- ------- --------- ----------- - ---- ---- ---------- --------- - --- --- ----- ------- --------- ----------- - ---- ----- ---------- --------- - --- --- ----- ------- --------- ----------- - ---- ------- - --- --- ----- ------- ------------ ------- ------ ------ ------ ---- ------ ------ --------- --------- ----- ----- ------ ------ - ----- ------------ - ------- - ----- - -------- - ---- - ----- ----- ----------- - ------ ------ -------- ------ ------ --- ------- --- - ---- ----- - ----------- ----- ------- --------- ----------- ------- --------- ----------- ------------ ------ -------- ------- --------- ------------- -------------- ---------------- -
结论
在复杂的应用中，GraphQL Schema 可能会变得非常冗长和复杂。为了解决这个问题，我们可以使用一些技巧来简化 Schema，比如使用接口、联合类型和输入对象。这些技巧可以使我们的 Schema 更加简洁和易于维护，从而提高开发效率和代码质量。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/67627614856ee0c1d403a909