GraphQL 在 C# (.NET) 上的应用：构建现代 API 完全指南

本书是一本全面的指南，教你如何使用 C# (.NET) 平台上的 GraphQL 构建现代、灵活且高效的 API。无论你是已经熟悉 REST 并希望提升客户端-服务器交互的性能和便利性，还是刚刚开始后端开发之旅，本书都将成为你可靠的助手。

本书内容简介

本书从 GraphQL 的基本概念开始：什么是模式、类型、查询（queries）、变更（mutations）和订阅（subscriptions）。你将理解 GraphQL 与 REST 的区别，以及在哪些项目中应用它能获得最大效果。接着，作者将带你深入使用最流行的库 Hot Chocolate 在 C#.NET 上进行实际实现。

你将一步步创建一个完整的 GraphQL 服务器：从项目设置和数据类型定义，到与 Entity Framework Core 和数据库的集成。特别关注以下方面：

• 模式设计：如何巧妙地设计类型图，使 API 直观且可扩展。
• 性能优化：解决 N+1 问题，使用 DataLoader，批量数据加载。
• 身份验证与授权：保护端点，字段和类型级别的访问策略。
• 错误处理与验证：清晰的错误消息，自定义过滤器和中间件。
• 测试：为 GraphQL 解析器编写单元测试和集成测试。
• 实际案例：分页、过滤、排序、文件处理以及实时订阅（WebSockets）。

本书适合谁？

• .NET 开发者（从初级到高级），希望掌握构建 API 的现代方法。
• 后端工程师，希望提高服务的灵活性并减少客户端的请求数量。
• 技术主管和架构师，评估将 GraphQL 引入现有基础设施的可行性。
• 所有对 C# 和 .NET 感兴趣，并希望用热门工具扩展技术栈的人。

你将学到什么？

• 如何从零开始配置 Hot Chocolate 并将其与 ASP.NET Core 集成。
• 如何设计包含继承、接口和联合类型的复杂图模式。
• 如何通过 Entity Framework Core 高效处理数据库并避免性能问题。
• 如何通过 GraphQL 订阅实现实时功能。
• 如何编写干净、可测试的解析器和中间件代码。
• 如何使用内置工具（Banana Cake Pop、GraphiQL）记录 API。

本书包含大量可直接用于你项目的代码示例。每章末尾都有实践任务以巩固所学内容。这不仅仅是理论——这是一个工具，让你从明天开始就能用 C# 编写更高性能、更便捷的 API。

作者寄语：“GraphQL 不仅仅是 REST 的替代品。它是一种将客户端置于交互中心的哲学。在这本书中，我不仅分享语法，还分享能帮助你避免常见陷阱的模式。”