GraphQL vs REST 代码和用例解析

GraphQL和REST是两种广泛使用的API设计方法。根据应用程序获取、转换和更新数据的方式，每种方法都有其优势和权衡。本指南分解了GraphQL和REST之间的核心差异，提供示例，并解释何时选择其中一种而非另一种。

什么是REST？

REST（表述性状态转移）是一种围绕资源构建API的架构风格。每个资源通过唯一的URL使用HTTP方法如GET、POST、PUT和DELETE进行访问。

示例

GET /users
GET /users/1
GET /users/1/posts

每个端点返回固定的数据结构。REST得到广泛支持，对缓存友好，且易于学习。

什么是GraphQL？

GraphQL是一种API查询语言。与多个端点不同，通常只有一个/graphql端点。客户端精确描述所需的数据，服务器响应匹配的结构。

示例

query {
  user(id: 1) {
    name
    posts {
      title
    }
  }
}

GraphQL响应只返回请求的内容——不多也不少。

REST vs GraphQL：功能比较

功能 REST GraphQL 数据获取 多个端点 单一灵活查询 过度获取 常见 避免 获取不足 常见 避免 版本控制 URL或头部 模式演进 缓存 原生HTTP级别 需要工具（Apollo, Relay） 学习曲线 较低 较高 文件上传 原生支持 需要设置 工具 成熟且广泛 不断增长（Apollo, GraphiQL等）

真实世界示例

REST

• 适合公共API和CRUD应用
• 示例：博客API，有如/posts、/comments、/users等端点

GraphQL

• 非常适合具有动态数据需求的移动端和前端
• 示例：在一个请求中获取用户、其项目和活动日志的仪表板

代码比较

REST：获取用户和帖子

GET /users/1
GET /users/1/posts

客户端必须手动组合响应。

GraphQL：一个查询完成相同任务

query {
  user(id: 1) {
    name
    posts {
      title
    }
  }
}

客户端在一个响应中获取所有需要的数据。

性能和扩展

• REST 受益于浏览器和CDN缓存。适合静态或读取密集型API。
• GraphQL 最小化有效负载大小，但需要安全措施（查询深度限制，速率限制）。
• 过于复杂的GraphQL查询如果不加管理可能影响后端性能。

何时使用REST

• 你有明确定义的资源
• 你的客户端数据需求不经常变化
• 你想利用HTTP缓存

何时使用GraphQL

• 你的前端经常变化或请求深层嵌套数据
• 你希望从单一端点获得灵活查询
• 你的移动应用或单页应用需要精简的有效负载

结论

REST和GraphQL都很强大。REST简单、熟悉，适用于许多用例。GraphQL为客户端提供更多控制和效率，尤其是在复杂应用中。根据应用的数据需求、前端灵活性和基础设施选择合适的方案。

常见问题