graphql 彻底改变了我们获取和塑造数据的方式，在客户端和服务器之间提供了一个干净的抽象层。它的核心功能之一是解析器，它允许我们定义模式中的每个字段如何获取其数据。在某些情况下，开发人员可能会通过依赖解析器中的实用方法无意中削弱 graphql 的优势。这种做法不仅违背了 graphql 的设计初衷，还引入了不必要的复杂性和潜在的 bug。
让我们深入探讨为什么会出现这个问题以及如何做得更好。
旋转变压器的力量
在 graphql 中，会为类型的每个实例调用解析器，无论该类型出现在架构中的位置。这种抽象确保了解析数据的逻辑在整体上保持一致。例如：
schema {
query: query
}
type query {
project(id: id!): project
user(id: id!): user
}
type project {
id: id!
name: string!
owner: user!
}
type user {
id: id!
name: string!
email: string!
}
这里，user 类型在两个地方使用：直接在 query 中用于获取用户，以及作为所有者嵌套在 project 类型中。借助 graphql 的解析器系统，我们可以定义单个 user 解析器来处理 user 字段的解析方式，确保 user 出现的任何地方的行为一致。
utils 的问题
当您引入实用方法来在解析器之外塑造数据时，您就打破了这种抽象。考虑这个例子：
// utils.ts
function maptouser(userdata: datasourceuser) {
return {
id: userdata.id,
name: userdata.full_name,
email: userdata.contact_email,
};
}
// resolvers.ts
const resolvers: resolvers<context> = {
query: {
project: async (_, { id }, { datasources }) => {
const project = await datasources.projectapi.getproject(id);
return {
...project,
owner: maptouser(project.owner), // utility method called here
};
},
user: async (_, { id }, { datasources }) => {
const user = await datasources.userapi.getuser(id);
return maptouser(user); // utility method called here
},
},
};
乍一看，这似乎没问题。但这就是为什么它有问题：
1. 重复的逻辑
您被迫在出现用户类型的每个解析器中调用maptouser。忘记调用它或错误地调用它可能会导致 api 中的行为不一致。
2. 打破抽象
graphql 的解析器系统旨在集中解决每种类型的方式。通过使用实用程序方法，您可以回避此功能并使您的代码不太直观。
3. 失去灵活性
如果您需要修改 user 类型的解析方式（例如，添加新字段或处理错误），则必须查找调用 maptouser 的每个位置，而不是更新单个解析器。
更好的方法：杠杆式旋转变压器
不要使用实用方法，而是为 graphql 类型定义解析器。以下是重写上面示例的方法：
const resolvers: Resolvers<Context> = {
Query: {
project: async (_, { id }, { dataSources }) => {
return dataSources.projectAPI.getProject(id);
},
user: async (_, { id }, { dataSources }) => {
return dataSources.userAPI.getUser(id);
},
},
User: {
id: (user) => user.id,
name: (user) => user.full_name,
email: (user) => user.contact_email,
},
Project: {
owner: (project, _, { dataSources }) => {
return dataSources.userAPI.getUser(project.ownerId);
},
},
};
为什么这更好
- 一致性：用户解析器确保所有用户实例都以相同的方式解析，无论它们出现在架构中的哪个位置。
- 集中逻辑：只需在一处更改用户的解析方式。
- 利用 graphql 的优势：通过采用解析器系统，您可以与 graphql 的核心设计原则保持一致并充分发挥其潜力。
结论
在解析器中使用实用方法似乎是一种捷径，但它最终会破坏 graphql 的强大功能和优雅性。通过为您的类型定义解析器，您可以维护一个干净、一致且可扩展的 api。因此，停止在解析器中使用 utils，拥抱 graphql 提供的抽象——未来的你会感谢你的！
