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 中,您可以使用左侧的查询编辑器来编写和测试查询。在右侧的结果窗格中,将显示查询结果。
----- - ----- -
上面的查询请求 SayHello 方法并返回“Hello from GraphQL!”。
结论
本文介绍了在 ASP .NET 3.1 中使用 GraphQL 的基本操作。您可以使用 GraphQL 完成更强大的数据操作,例如查询、变更和订阅等。此外,您也可以使用自定义解析器来实现更高的自由度和灵活性。希望这个入门指南能帮助您快速入门 GraphQL。
来源:JavaScript中文网 ,转载请注明来源 本文地址:https://www.javascriptcn.com/post/670b913ed91dce0dc88b4dd0