graphql-具有不同参数的相同查询

Question

可以使用图形 ql 实现以下功能:
我们有 getusers()/getusers(id=3)/getusers(name='John) .我们可以使用相同的查询来接受不同的参数(参数)吗？

Answer 1

我假设你的意思是这样的:

type Query {
    getusers: [User]!
    getusers(id: ID!): User
    getusers(name: String!): User
}

恕我直言，首先要做的是尝试。您应该收到一条错误消息，指出 Query.getusers 只能定义一次，这将立即回答您的问题。

这是实际规范说这样的事情是无效的: http://facebook.github.io/graphql/June2018/#example-5e409

报价:

Each named operation definition must be unique within a document when referred to by its name.

解决方案

据我所见，创建此类 API 的最 GraphQL 方法是定义过滤器输入类型，如下所示:

input UserFilter {
    ids: [ID]
    names: [String]
}

然后:

type Query {
    users(filter: UserFilter)
}

解析器将检查通过了哪些过滤器(如果有)并相应地查询数据。

这非常简单但非常强大，因为它允许客户端使用任意过滤器查询任意数量的用户。作为后端开发人员，您可以向 UserFilter 添加更多选项。稍后，包括一些分页选项和其他很酷的东西，同时保持旧的 API 完好无损。而且，当然，这取决于您希望此 API 有多灵活。

但为什么会这样呢？

警告!我在这里和那里假设了一些事情，可能是错误的。

GraphQL 只是一个逻辑 API 层，它应该是与服务器无关的。但是，我相信最初的实现是在 JavaScript 中(需要引用)。如果您随后考虑在 JS 中实现 GraphQL API 的技术方面，您可能会了解为什么会这样。

每个查询都指向一个解析器函数。在 JS 中，解析器是简单的函数，它们存储在由查询/变异/订阅名称指定的路径中的普通对象中。您可能知道，JS 对象不能有多个同名的路径。这意味着您只能为给定的查询名称定义一个解析器，因此所有三个 getusers将映射到相同的函数 Query.getusers(obj, args, ctx, info)反正。

因此，即使 GraphQL 允许具有相同名称的字段，解析器也必须明确检查传递的任何参数，即 if (args.id) { ... } else if (args.name) { ... }等，从而部分地破坏了具有单独端点的观点。另一方面，有一种总体上更好的方式(特别是从客户的角度来看)来定义这样的 API，如上所示。

最后说明

GraphQL 在概念上与 REST 不同，因此从三个端点(/users、/users/:id 和/users/:name)的角度来思考是没有意义的，我猜你正在这样做。为了揭示语言的全部潜力，需要进行范式转变。