目前在 Web 开发中,GraphQL 得到越来越多的关注。GraphQL 能够充分支持前端开发和 APIs。
在 GraphQL 开发中,使用服务端过滤是非常重要的。服务端过滤可以帮助我们更好地控制我们的查询和操作,提高 API 的效率和性能。
本文将介绍如何在 GraphQL 中使用服务端过滤。我们将学习如何进行过滤、如何编写过滤查询、如何测试过滤查询以及怎样在 GraphQL API 中实现过滤。
过滤方法
GraphQL 的查询语言是非常灵活的,这种灵活性是通过提供过滤器函数来实现的。过滤器函数允许我们对查询进行过滤,以便我们只获得需要的结果。常见的几种方法包括:
where
where 方法可以用来指定查询的限制条件,只有符合指定条件的条目才会被返回。例如:
- --------------- ----------- ------ - -- ----- - -
这个查询获取了所有已发布的帖子。where
参数是必需的,因为它指定了 limit、orderBy 等参数。
order_by
order_by 方法允许我们对查询返回的结果进行排序。例如:
- ----------------- --------------- - -- ----- - -
这个查询按照创建时间降序排列所有帖子。
limit
limit 方法用来指定返回结果的数量。例如:
- --------------- --- - -- ----- - -
这个查询返回系统中最近的10条帖子。
offset
offset 方法提供了跳过前 n 项的能力。例如:
- ---------------- -- - -- ----- - -
这个查询跳过前 5 条消息并返回接下来的所有帖子。
编写过滤查询
在 GraphQL 中,过滤查询是通过 where
参数来实现的。下面是一些示例:
等于
- --------------- ----------- ------ - -- ----- - -
这个查询返回被发布了的所有帖子。
不等于
- --------------- -------- ---- ----------- - -- ---- - -
这个查询返回所有没有被禁言的用户。
小于
- --------------- ------- ----- ------ - -- ----- - -
这个查询返回小于或等于100个浏览量的所有帖子。
大于
- --------------- ------- ---- ------- - -- ----- - -
这个查询返回超过1000个浏览量的所有帖子。
包含
- --------------- ------- ---------- ------------ - -- ----- - -
这个查询返回标题中包含“GraphQL”的所有帖子。
正则表达式
- --------------- ------- -------- ----------------- - -- ----- - -
这个查询返回所有标题以“GraphQL”开头的帖子。
测试过滤查询
为了测试过滤查询的正确性,我们可以使用 GraphiQL
。GraphiQL
是一个 GraphQL 环境,可以方便地测试 API,看到我们的查询和结果。
下面是一些示例:
测试等于查询
- --------------- -------- ---- ----------- - -- ---- - -
所有 result 在查询期间都包含“banned”。
测试不等于查询
- --------------- -------- ---- ----------- - -- ---- - -
所有 result 在查询期间不包含“banned”。
测试小于查询
- --------------- ------- ---- ------- - -- ----- - -
所有 result 在查询期间的浏览量小于1000。
测试大于查询
- --------------- ------- ---- ------ - -- ----- - -
所有 result 在查询期间的浏览量超过100。
实现过滤
为了在 GraphQL API 中实现过滤,我们需要创建适当的参数。我们可以使用 GraphQLInputObjectType
来定义一个新的输入对象类型。
例如,我们可以创建一个名为 BlogFilter
的输入对象类型如下:
----- ---------- - --- ------------------------ ----- ------------- ------------ ------- --- ------- ------- -- -- -- --- - ----- ---------- -- ------ - ----- ------------- -- ---------- - ----- -------------- - -- --
这个过滤器包括许多常见属性,例如 id
、title
和 published
。
我们还可以扩展此过滤器的功能,以包括其他操作符和属性。
然后,我们可以在我们的查询和 mutation 类型中使用这个输入对象。例如,对于我们的查询类型,我们可以添加一个名为 allBlogs
的字段:
----- ----- - --- ------------------- ----- -------- ------- - --------- - ----- --------- ----- - ------- - ----- ---------- - -- -------- --- ----- -- ------------------------------- - - --
这个 allBlogs
查询现在接受一个名为 filter
的参数,用于过滤我们的博客。然后我们将过滤器传递给我们的 blogLoader
,该 loader 将使用 where
参数对我们的查询执行过滤。
结论
在本文中,我们已经了解了如何在 GraphQL 中使用服务端过滤。我们已经详细介绍了常见的过滤方法、编写过滤查询和测试过滤查询的方法,并且学习了如何在 GraphQL API 中实现过滤。这些方法将帮助我们更好地控制查询和操作,提高 API 的效率和性能。
来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/66f0eea46fbf960197346b7f