Hot Chocolate 是 .NET 平臺下的一個開源組件庫, 您可以使用它創建 GraphQL 服務, 它消除了構建成熟的 GraphQL 服務的復雜性, Hot Chocolate 可以連接任何服務或數據源，并創建一個有凝聚力的服務，為您的消費者提供統一的 API。

在本文中, 我會在 .NET 應用中使用 Hot Chocolate 組件來構建 GraphQL 服務, 讓我們開始吧！

01

創建 GraphQL?Server

這里我們創建一個空的 .NET Web項目, 并且使用了 .NET 6 的 mini api

dotnet new web -n HotChocolateDemo

然后通過命令或者 Nuget 安裝 Hot Chocolate 包

dotnet add ./HotChocolateDemo package HotChocolate.AspNetCore

接下來，需要修改 Program.cs, 注入 GraphQL 服務

var builder = WebApplication.CreateBuilder(args);var services = builder.Services;services.AddGraphQLServer();var app = builder.Build();app.MapGet("/", () => "Hello World!");app.UseRouting().UseEndpoints(endpoints =>{endpoints.MapGraphQL();});app.Run();

運行項目, 并訪問?/graphql?端點

項目會顯示上面的頁面, 這是 ChilliCream 平臺提供的 GraphQL IDE, Banana Cake Pop, 可以使用它瀏覽，請求 GraphQL 服務, 有點像 swagger 和 Postman 的結合體。

現在它是空的, 因為我們沒有創建任何的 GraphQL API, 接下來，我會創建最簡單的查詢服務, 然后使用 Banana Cake Pop 查詢我們的 GraphQL 服務。

02

?創建 GraphQL Schema

首先, 在項目中添加下面的實體類

/// <summary>/// 書籍/// </summary>public class Book{ /// <summary>/// 編號/// </summary>public int Id { get; set; }/// <summary>/// 標題/// </summary>public string? Title { get; set; } }/// <summary>/// 用戶/// </summary>public class Person{/// <summary>/// 年齡/// </summary>public int Age { get; set; }/// <summary>/// 姓名/// </summary>public string? Name { get; set; }}

接下來，為實體創建查詢服務

public class Query{/// <summary>/// 獲取指定的書籍/// </summary>/// <param name="id">書籍編號</param>/// <returns></returns>public Book GetBook(int id){return new Book{Id = id,Title = "C# in depth."}; }/// <summary>/// 獲取指定的用戶/// </summary>/// <param name="name">用戶名</param>/// <returns></returns>public Person GetPerson(string name){return new Person{ Age = 20,Name = name};}}

然后修改 Program.cs, 如下

services.AddGraphQLServer().AddQueryType<Query>();

?

03

執行 GraphQL 查詢

準備工作完成，我們再次運行項目，并訪問?/graphql?端點，Ctrl + Alt + T?新建 tab, 然后選擇 Schema Reference，可以查看到 Query API, 如您所見, 也可以看到每個api 的描述信息, 前提是在 .NET 項目中選擇輸出 xml 文檔。

然后可以輸入下面的查詢語句，進行查詢

query{book(id:123456){idtitle} }

后端服務會返回下面的內容, 這是一個最簡單的查詢

使用 Hot Chocolate 搭建一個 GraphQL 服務, 就是這么簡單！當然接下來我會繼續介紹更新，訂閱，以及和 EF Core 結合使用的操作。

創作挑戰賽新人創作獎勵來咯，堅持創作打卡瓜分現金大獎

總結

以上是生活随笔為你收集整理的【.NET 遇上 GraphQL】使用 Hot Chocolate 构建 GraphQL 服务的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。