概述
我们已经足够测试我们的GraphQL 服务器。我们可以使用 curl
命令发送请求 — GraphQL 服务器 毕竟会接受 HTTP 请求!但是让我们使用 GraphQL IDE 来简化操作。
在本课中,我们将
- 了解使用 Apollo 沙盒
- 检查一个 GraphQL 服务器 的架构
- 构建我们的第一个 查询
Apollo 沙盒
进入 Apollo 沙盒。沙盒可免费使用,无需帐户。它是 Apollo GraphOS 平台的一部分,有助于本地图开发。
Apollo GraphOS 是一个完整的云平台,用于构建、管理和扩展您的 图。 GraphOS 提供了一套工具和服务,使产品开发人员能够专注于更快地构建更好的应用程序。
使用沙盒,我们可以加载一个 GraphQL 服务器 的架构,并使用一些很酷的 GraphOS 功能(例如架构参考和浏览器)来探索它。
浏览器是一个强大的 Web IDE,用于创建、运行和管理 GraphQL 操作。它使我们能够轻松快速地构建操作、查看操作历史记录、查看响应提示以及与他人共享操作。
我们已经告诉 Strawberry 使用 Apollo 沙盒 作为 IDE,使用 graphql_ide
参数。
graphql_router = GraphQLRouter(schema, path="/", graphql_ide="apollo-sandbox")
让我们试试吧!在浏览器中访问 https://127.0.0.1:8000。
探索我们的架构
让我们看看我们的架构,这是主导航中的第一个选项卡。
在这里,我们可以全面查看并参考我们的架构!现在它还很稀疏,但我们可以看到我们的 Query
类型,其中有一个 hello
字段,返回一个 String
类型。
在 SDL 选项卡中,我们还可以看到 SDL 语法中的架构。
探索浏览器
让我们跳回到浏览器页面。
中间的 操作 面板是用于创建查询的地方。浏览器可能已经填充了默认的 操作。让我们使用 + 按钮打开一个新的工作区选项卡,以便从头开始。
我们可以手动编写 操作,或者从左侧的 文档 面板添加 字段。
浏览器的 文档 选项卡使我们能够深入了解架构的 字段,从 Query
类型的入口点开始。
单击 字段 旁边的加号(⊕)按钮会自动将该字段添加到我们当前的 操作 中。这是一种方便的方法,可以组装复杂的查询,而无需记住架构的精确结构或 GraphQL 语法。
继续添加 hello
字段。
query Query {hello}
在 操作 面板的顶部是用于运行我们的 查询 的按钮。让我们现在单击它,看看会发生什么:
右侧的 响应 面板向我们展示了第一个“Hello world”! 👋
{"data": {"hello": "Hello world"}}
我们刚刚运行了第一个 GraphQL 查询! 🎉
练习
关键要点
- Apollo 沙盒 是一个功能强大的 Web IDE,专为本地 图 开发而设计。它简化了创建、运行和管理 GraphQL 操作 的过程。
- Apollo 沙盒 浏览器允许我们探索我们的 GraphQL 架构 并轻松构建和运行 GraphQL 操作。
- Strawberry 允许开发人员在熟悉的 Python 环境和约定中进行编码。它将这些 Python 类型和约定转换为后台的 GraphQL SDL 和约定。
接下来
让我们提升此架构的节奏,并展示一些播放列表!
分享您关于本课的疑问和评论
此课程目前处于
您需要一个 GitHub 帐户才能在下面发布。还没有? 请在我们的 Odyssey 论坛中发布。