简单介绍一下graphql

graphql 是一种用于 API 的查询语言,对你的 API 中的数据提供了一套易于理解的完整描述,使得客户端能够准确地获得它需要的数据,减少数据的冗余。

对比 Rest API

Rest API 是和 GraphQL 同类的用于查询的语言。Rest 把每个资源都用一个 URL 表示,访问这个 URL 就能够得到一份 JSON 格式的数据响应,但是这有一个缺点,你可能会得到与需求不相关的数据。而 GraphQL 则不会,发送过去的请求中指定了需要哪个资源,举个简单的例子,你需要这本书的作者的姓资源,那么 Rest API 会把把作者的名字也发给你,因为你是通过访问作者的信息的 URL 来获得姓的,而 GraphQL 则会只把需要的信息发过来,换句话说,需要什么资源是用户来决定的。

RPC vs REST vs GraphQL(参考资料点击这里)

在合适的时候选择合适的工具是重要的,下面则列举了在一些场景下最好使用什么工具来作为参考

1、如果是 Management API,这类 API 的特点如下:

  • 关注于对象与资源
  • 会有多种不同的客户端
  • 需要良好的可发现性和文档
  • 这种情景使用 REST + JSON API 可能会更好。

2、如果是 Command or Action API,这类 API 的特点如下:

  • 面向动作或者指令
  • 仅需要简单的交互
  • 这种情况使用 RPC 就足够了。

3、如果是 Internal Micro Services API,这类 API 的特点如下:

  • 消息密集型
  • 对系统性能有较高要求
  • 这种情景仍然建议使用 RPC。

4、如果是 Micro Services API,这类 API 的特点如下:

  • 消息密集型
  • 期望系统开销较低
  • 这种情景使用 RPC 或者 REST 均可。

5、如果是 Data or Mobile API,这类 API 的特点是:

  • 数据类型是具有图状的特点
  • 希望对于高延迟场景可以有更好的优化
  • 这种场景无疑 GraphQL 是最好的选择。

GraphQL 的查询与变更——如何查询 GraphQL 服务器 以一个查询结果为例:

{
hero {
name
}
}

该查询将会获得一个与其结构几乎一样的结果:

{
"data": {
"hero": {
"name""R2-D2"
}
}
}

这是 GraphQL 最重要的特性,因为这样一来,你就总是能得到你想要的数据,而服务器也准确地知道客户端请求的字段。并且在GraphQL中查询是可交互的,你可以按你喜欢来改变查询,然后看看新的结果。

在查询时可以添加上参数,结果也会显得更有趣。参数可以是多种不同的类型。GraphQL 自带一套默认类型,但是 GraphQL 服务器可以声明一套自己的定制类型,只要能序列化成你的传输格式即可。

例如,有如下查询:

{
human(id: "1000") {
name
height
}
}

其结果为:

{
"data": {
"human": {
"name""Luke Skywalker",
"height": 1.72
}
}
}

在类似 REST 的系统中,你只能传递一组简单参数 —— 请求中的 query 参数和 URL 段。但是在 GraphQL 中,每一个字段和嵌套对象都能有自己的一组参数,从而使得 GraphQL 可以完美替代多次 API 获取请求。甚至你也可以给 标量(scalar)字段传递参数,用于实现服务端的一次转换,而不用每个客户端分别转换。

更多GrophQL的类型系统请点击这里

文章来源网络,作者:运维,如若转载,请注明出处:https://shuyeidc.com/wp/223955.html<

(0)
运维的头像运维
上一篇2025-04-16 05:09
下一篇 2025-04-16 05:11

相关推荐

  • 个人主题怎么制作?

    制作个人主题是一个将个人风格、兴趣或专业领域转化为视觉化或结构化内容的过程,无论是用于个人博客、作品集、社交媒体账号还是品牌形象,核心都是围绕“个人特色”展开,以下从定位、内容规划、视觉设计、技术实现四个维度,详细拆解制作个人主题的完整流程,明确主题定位:找到个人特色的核心主题定位是所有工作的起点,需要先回答……

    2025-11-20
    0
  • 社群营销管理关键是什么?

    社群营销的核心在于通过建立有温度、有价值、有归属感的社群,实现用户留存、转化和品牌传播,其管理需贯穿“目标定位-内容运营-用户互动-数据驱动-风险控制”全流程,以下从五个维度展开详细说明:明确社群定位与目标社群管理的首要任务是精准定位,需明确社群的核心价值(如行业交流、产品使用指导、兴趣分享等)、目标用户画像……

    2025-11-20
    0
  • 香港公司网站备案需要什么材料?

    香港公司进行网站备案是一个涉及多部门协调、流程相对严谨的过程,尤其需兼顾中国内地与香港两地的监管要求,由于香港公司注册地与中国内地不同,其网站若主要服务内地用户或使用内地服务器,需根据服务器位置、网站内容性质等,选择对应的备案路径(如工信部ICP备案或公安备案),以下从备案主体资格、流程步骤、材料准备、注意事项……

    2025-11-20
    0
  • 如何企业上云推广

    企业上云已成为数字化转型的核心战略,但推广过程中需结合行业特性、企业痛点与市场需求,构建系统性、多维度的推广体系,以下从市场定位、策略设计、执行落地及效果优化四个维度,详细拆解企业上云推广的实践路径,精准定位:明确目标企业与核心价值企业上云并非“一刀切”的方案,需先锁定目标客户群体,提炼差异化价值主张,客户分层……

    2025-11-20
    0
  • PS设计搜索框的实用技巧有哪些?

    在PS中设计一个美观且功能性的搜索框需要结合创意构思、视觉设计和用户体验考量,以下从设计思路、制作步骤、细节优化及交互预览等方面详细说明,帮助打造符合需求的搜索框,设计前的规划明确使用场景:根据网站或APP的整体风格确定搜索框的调性,例如极简风适合细线条和纯色,科技感适合渐变和发光效果,电商类则可能需要突出搜索……

    2025-11-20
    0

发表回复

您的邮箱地址不会被公开。必填项已用 * 标注