GraphQL 是一种由 Facebook 开发的数据查询语言和执行引擎，它可以有效地减少网络数据请求量和数据传输量。它通过提供一种清晰、灵活的方式来描述和请求数据，从而优化了前端与后端之间的数据交互流程。本文将介绍如何在 ASP .NET 3.1 中使用 GraphQL。
第一步：安装 GraphQL
方法一：使用 NuGet 包管理器
可以通过 NuGet 包管理器，在项目中直接安装 GraphQL 相关的包。
- 打开 Visual Studio，打开项目文件。
- 在 Solution Explorer 窗口中，右键单击项目名称，选择“Manage NuGet Packages...”。
- 在 NuGet 窗口中，选择“Browse”选项卡，输入“GraphQL”关键词，选择最新版本的 GraphQL 包，然后单击“Install”按钮安装即可。
方法二：使用 dotnet 命令
另外一种安装 GraphQL 的方法是使用 dotnet 命令行工具。
- 打开命令提示符。
- 输入以下命令安装 GraphQL 支持：
dotnet add package Microsoft.AspNetCore.GraphQL
第二步：创建 GraphQL 查询
在 ASP .NET 3.1 中，创建 GraphQL 查询主要有两种方式：使用 GraphQL 库和使用自定义解析器。下面将对这两种方式进行详细介绍。
方法一：使用 GraphQL 库
ASP .NET 3.1 提供了一种使用 GraphQL 库的方式来创建查询，其中包括使用 GraphQL 的 Query 类型、Mutation 类型和 Subscription 类型。下面的示例代码演示了如何在 ASP .NET 3.1 中使用 GraphQL 库。
-- -------------------- ---- -------
------ ----- -------
-
------ ---- ------------------------------------ ---------
-
-- -- ------- --
--------------------------- -- --------------------- - -----
-------------------
----------------------
----------------------------
------------------------------------
---------------------------
-------------------------
-
------ ---- ----------------------------- ---- ------------------- ----
-
-- ---------------------
-
--------------------------------
-
--------------------
-----------------
-----------------
---------------------------
-
-
------ ----- -----
-
------ ------ ------- -- ------ ---- ----------
-
------ ----- --------
-
------ ------ ------------ ----- -- ------------- --- ---- ----- ---------------
-
------ ----- ------------
-
------ ------ ----------- -- -- --- ------- --- ----------
-
------ ----- ----
-
------ ------ ---- - ---- ---- -
------ ------ ----- - ---- ---- -
-上面的代码中，Query、Mutation 和 Subscription 分别定义了查询、变更和订阅类型。AddGraphQL 方法用于注册 GraphQL 服务并启用指标统计。AddQueryType、AddMutationType 和 AddSubscriptionType 分别用于添加查询、变更和订阅类型。AddInMemorySubscriptions 方法用于启用内存订阅，AddType 方法用于添加类型。最后，Configure 方法中的三个 Use 方法用于注册中间件并配置路由。
方法二：使用自定义解析器
另外一种创建 GraphQL 查询的方式是使用自定义解析器。自定义解析器可以将 GraphQL 查询转换为实际的数据操作，具有更高的自由度和灵活性。下面的示例代码演示了如何在 ASP .NET 3.1 中使用自定义解析器。
-- -------------------- ---- -------
------ ----- -------
-
------ ---- ------------------------------------ ---------
-
---------------------------
-----------------------
-
------ ---- ----------------------------- ---- ------------------- ----
-
-- ---------------------
-
--------------------------------
-
--------------------
-----------------
-------------------------- --
-
-----------------------
---
-
-
------ ----- -----
-
------------------ - ---------
------ ------ ---------- -- ------ ---- ----------
-上面的代码中，AddQueryType 方法用于添加查询类型。Query 类中定义了一个名为 SayHello 的方法，并使用 [GraphQLQuery(Name = "hello")] 特性标记为 GraphQL 查询。在这个方法中，我们可以执行所需的数据操作并返回结果。
第三步：测试 GraphQL 查询
一旦创建了 GraphQL 查询，就可以使用 GraphQL Playground 界面来测试它。如果您还没有安装 GraphQL Playground，可以使用以下命令安装：
dotnet tool install --global GraphQL.Playground
在本地运行应用程序之后，打开浏览器并输入以下地址即可开始测试 GraphQL 查询：
http://localhost:5000/graphql
在 GraphQL Playground 中，您可以使用左侧的查询编辑器来编写和测试查询。在右侧的结果窗格中，将显示查询结果。
query {
hello
}上面的查询请求 SayHello 方法并返回“Hello from GraphQL!”。
结论
本文介绍了在 ASP .NET 3.1 中使用 GraphQL 的基本操作。您可以使用 GraphQL 完成更强大的数据操作，例如查询、变更和订阅等。此外，您也可以使用自定义解析器来实现更高的自由度和灵活性。希望这个入门指南能帮助您快速入门 GraphQL。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/670b913ed91dce0dc88b4dd0