使用Hot Chocolate和.NET 6构建GraphQL应用(1)——GraphQL及示例项目介绍
系列导航
使用Hot Chocolate和.NET 6构建GraphQL应用文章索引
前言
这篇文章是这个系列的第一篇,我们会简单地讨论一下GraphQL,然后介绍一下这个系列将会使用的示例项目。
关于GraphQL
关于GraphQL和Restful API的讨论已经有很多了,我在本文里不会试图去推销什么技术。GraphQL的官方主页在这里GraphQL | A query language for your API,它的出现是为了解决Restful API面临的当所需查询的数据结构呈现及其复杂的树状结构或依赖关系时,需要多次按顺序发送不同的Restful请求,并且需要额外的Dto对象来保证当前的API接口不会返回多余的数据,此外,当数据之间的关系发生变动导致原本的Resful API无法获取关联的数据时,就需要去修改接口定义。
GraphQL能通过精确定义客户端需要的数据,无需多次请求就可以获取无冗余的结果。关于GraphQL的基本概念就不详细介绍了,可以参考官方文档,或者跟着这个系列亲手实现一个感受一下。
关于GraphQL和Restful API各自的优点和缺点,可以参考这篇文章REST vs GraphQL for an API。用我的理解简单地解释就是:
- Restful API更为开发人员所熟悉,但是我觉得文章里提到的API Client的接受度和Learning Resources现在来看几乎都不是太大的优势了,越来越多的主流API Client像是Postman,小众一点的Insomia,都支持发送GraphQL请求,社区的资源也很多了。Restful API最明显的短处在于我们必须使用Dto来减少返回数据的冗余。
- GraphQL的优势在于它能更好地发送聚合请求,并且能够精确定义数据使得返回值无冗余。缺点也很明显,开发人员相对来说不够熟悉,对文件下载的支持不好。
项目模版
这两天抽空整理之前的内容,写了一个基于Clean Architecture的.NET 6 Web API项目模版,放在这里了:Asinta/Code4NothingCaTempate,还没有推到Nuget上,如果有需要使用的,可以clone到本地,在解决方案根目录执行:
$ dotnet new --install .
The following template packages will be installed:
/Users/yu.li1/Projects/asinta/netcore/Code4Nothing
Success: /Users/yu.li1/Projects/asinta/netcore/Code4Nothing installed the following templates:
Template Name Short Name Language Tags
------------------------------------------------- ---------- -------- ----
Code4Nothing Clean Architecture Solution Template ca-c4n [C#]
接下来就可以从本地使用这个模版来创建新项目了
dotnet new ca-c4n -n PostGraphi
这个解决方案模版包含了测试项目,我们在这个系列里暂时都不会用到,src目录下的项目还是按照之前使用.NET 6开发TodoList应用文章索引这个系列里的方式进行划分,用做示例的TodoItem相关的可以作为参考实现自己的实体和相关功能。
在GraphQL的这个系列里,我们会基于这个模版来构建一个博客文章管理的示例应用,主要用来练习如何在.NET 6 Web API应用里构建GraphQL接口以及相关的功能。
领域实体关系
下图是我们即将构建的应用涉及的实体以及相互之间的关系,一些基础字段比如创建时间和更新时间我没有画上去,足够理解用了。
关于Hot Chocolate
Hot Chocolate作为GraphQL和.NET生态中近几年迅速获得大量使用的GraphQL服务端框架,提供了非常方便的使用方法。你可以应用它来构建独立的基于.NET 6的GraphQL Server,也可以用来部署在Azure Functions或者AWS Lambda上用来作为GraphQL Server,同时也可以实现GraphQL网关,一些.NET生态中推荐使用的网关框架如Envoy也支持GraphQL请求。
我们会使用这个框架来实现GraphQL的常用功能。
关于GraphQL更多的资源
- chentsulin/awesome-graphql
- graphql/graphiql
- 一个很棒的GraphQL接口可视化工具:APIs-guru/graphql-voyager
使用Hot Chocolate和.NET 6构建GraphQL应用(1)——GraphQL及示例项目介绍的更多相关文章
- 使用Hot Chocolate和.NET 6构建GraphQL应用文章索引
系列背景 在进入微服务的实践系列之前,我们一起来学习和实践一下.NET应用开发生态中一些比较重要的技术,这个系列就是关于GraphQL在.NET 6应用中的实现. 系列导航 使用Hot Chocola ...
- 使用Hot Chocolate和.NET 6构建GraphQL应用(2) —— 实体相关功能实现
系列导航 使用Hot Chocolate和.NET 6构建GraphQL应用文章索引 需求 在本文中,我们将会准备好用于实现GraphQL接口所依赖的底层数据,为下一篇文章具体实现GraphQL接口做 ...
- 使用Hot Chocolate和.NET 6构建GraphQL应用(3) —— 实现Query基础功能
系列导航 使用Hot Chocolate和.NET 6构建GraphQL应用文章索引 需求 在本文中,我们通过一个简单的例子来看一下如何实现一个最简单的GraphQL的接口. 实现 引入Hot Cho ...
- 使用Hot Chocolate和.NET 6构建GraphQL应用(4) —— 实现Query映射功能
系列导航 使用Hot Chocolate和.NET 6构建GraphQL应用文章索引 需求 在上一篇文章使用Hot Chocolate和.NET 6构建GraphQL应用(3) -- 实现Query基 ...
- 使用Hot Chocolate和.NET 6构建GraphQL应用(5) —— 实现Query过滤功能
系列导航 使用Hot Chocolate和.NET 6构建GraphQL应用文章索引 需求 对于查询来说,还有一大需求是针对查询的数据进行过滤,本篇文章我们准备实现GraphQL中基本的查询过滤. 思 ...
- 使用Hot Chocolate和.NET 6构建GraphQL应用(6) —— 实现Query排序功能
系列导航 使用Hot Chocolate和.NET 6构建GraphQL应用文章索引 需求 从前几篇文章可以看出,使用Hot Chocolate实现GraphQL接口是比较简单的,本篇文章我们继续查询 ...
- 使用Hot Chocolate和.NET 6构建GraphQL应用(7) —— 实现Query分页功能
系列导航 使用Hot Chocolate和.NET 6构建GraphQL应用文章索引 需求 GraphQL中的查询分页相对来说是查询中比较难理解的,接口的Schema也和其他不一样.在这篇文章中,我们 ...
- 使用Hot Chocolate和.NET 6构建GraphQL应用(8) —— 实现Mutate添加数据
系列导航 使用Hot Chocolate和.NET 6构建GraphQL应用文章索引 需求 在讨论完GraphQL中的查询需求后,这篇文章我们将演示如何实现GraphQL中的数据添加任务. 思路 在G ...
- 使用Hot Chocolate和.NET 6构建GraphQL应用(9) —— 实现Mutate更新数据
系列导航 使用Hot Chocolate和.NET 6构建GraphQL应用文章索引 需求 在上一篇文章中,我们演示了如何使用Hot Chocolate进行GraphQL的Mutate新增数据,这篇文 ...
随机推荐
- 后端调用WebApi
using System;using System.Collections.Generic;using System.Linq;using System.Net.Http;using System.W ...
- 【LeetCode】229. Majority Element II 解题报告(Python & C++)
作者: 负雪明烛 id: fuxuemingzhu 个人博客: http://fuxuemingzhu.cn/ 目录 题目描述 题目大意 解题方法 hashmap统计次数 摩尔投票法 Moore Vo ...
- 【LeetCode】518. Coin Change 2 解题报告(Python)
[LeetCode]518. Coin Change 2 解题报告(Python) 作者: 负雪明烛 id: fuxuemingzhu 个人博客: http://fuxuemingzhu.cn/ 题目 ...
- 【LeetCode】640. Solve the Equation 解题报告(Python)
[LeetCode]640. Solve the Equation 解题报告(Python) 标签(空格分隔): LeetCode 作者: 负雪明烛 id: fuxuemingzhu 个人博客: ht ...
- 最大流问题的Ford-Fulkerson模板
详细讲解:http://blog.csdn.net/smartxxyx/article/details/9293665 下面贴上我的第一道最大流的题: hdu3549 1 #include<st ...
- poj 2566Bound Found(前缀和,尺取法)
http://poj.org/problem?id=2566: Bound Found Time Limit: 5000MS Memory Limit: 65536K Total Submissi ...
- elasticsearch之多索引查询
一.问题源起 在elasticsearch的查询中,我们一般直接通过URL来设置要search的index: 如果我们需要查询的索引比较多并且没有什么规律的话,就会面临一个尴尬的局面,超过URL的长度 ...
- 【算法】01-数据结构概述(注意区分jvm堆与堆/jvm栈与栈)
[算法]01-数据结构概述(注意区分jvm堆与堆/jvm栈与栈) 欢迎关注b站账号/公众号[六边形战士夏宁],一个要把各项指标拉满的男人.该文章已在github目录收录. 屏幕前的大帅比和大漂亮如果有 ...
- 美和易思 MOOT去鼠标检测,快进,倍速,自动下一章
F12 放到 console 直接运行即可 或者油猴添加新脚本 核心去除网页绑定焦点事件代码: if (!-[1,] && !window.XMLHttpRequest || navi ...
- springboot的build.gradle增加阿里仓库地址以及eclipse增加lombok
该随笔仅限自己记录,请谨慎参考!! 为什么把这2块内容放一个标题里? 发现lombok和eclipse结合的一些问题 关于lombok如何与eclipse结合,网上应该有很多教程,我这块已经做过了,但 ...