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 图解