GraphQL 是一种用于 API 的查询语言,它允许客户端仅请求它们需要的数据。这个教程将帮助你入门 GraphQL,了解其基本概念和使用方法。

基本概念

1. 查询

在 GraphQL 中,查询用于请求数据。以下是一个简单的查询示例:

{
  user(id: "123") {
    name
    email
  }
}

2. 变量

变量可以用于传递动态值到查询中。例如:

{
  user(id: $id) {
    name
    email
  }
}

然后,在查询中传递变量值:

{
  "id": "123"
}

3. 分页

GraphQL 支持分页功能。以下是一个使用游标进行分页的示例:

{
  users(first: 10, after: "cursor") {
    edges {
      node {
        id
        name
      }
      cursor
    }
  }
}

快速开始

安装 GraphQL 工具

首先,你需要安装一些 GraphQL 工具,例如 Apollo CLI。

npm install -g @apollo/cli

创建新的 GraphQL 项目

使用 Apollo CLI 创建一个新的 GraphQL 项目:

apollo new graphql-tutorial

查询示例

在项目目录中,创建一个名为 queries.graphql 的文件,并添加以下查询:

query GetUsers {
  users {
    id
    name
  }
}

然后,运行以下命令来查看查询结果:

apollo query --query-file queries.graphql

扩展阅读

更多关于 GraphQL 的信息,请访问我们的官方文档

GraphQL 图解