GraphQL 既是一种用于 API 的查询语言也是一个满足你数据查询的运行时。GraphQL 对你的 API 中的数据提供了一套易于理解的完整描述,使得客户端能够准确地获得它需要的数据,而且没有任何冗余,也让 API 更容易地随着时间推移而演进,还能用于构建强大的开发者工具。
——出自 https://graphql.cn
前面几篇博文介绍了GraphQL在asp.net core框架下的实例,初步了解到Hot Chocolate的功能,不如从这篇开始,细致的过一下Hot Chocoklate,看看.net下这个GrpahQL框架究竟做了点什么,我们又能做点什么。
首先使用HotChocolate有两种姿势,代码姿势(code-first)和脚手架姿势(schema-first),那长什么样呢?实例送上:
using HotChocolate; using HotChocolate.Execution; using HotChocolate.Types; using System; namespace GraphQLBase001 { class Program { static void Main(string[] args) { var schemaString = @" type Query { hello: String }"; Console.WriteLine("Schema-First"); SchemaFirst.Run(schemaString); Console.WriteLine("Schema-First"); CodeFirst.Run(schemaString); Console.WriteLine("PurCode-First"); PureCodeFirst.Run(); C.Run(schemaString); D.Run(schemaString); E.Run(); } } #region Schema-First public class SchemaFirst { public static void Run(string schemaString) { var schema = SchemaBuilder .New() .AddDocumentFromString(schemaString) .AddResolver("Query", "hello", () => "world") .Create(); var executor = schema.MakeExecutable(); Console.WriteLine(executor.Execute("{ hello }").ToJson()); } } #endregion #region Code-First public class CodeFirst { public static void Run(string schemaString) { var schema = SchemaBuilder .New() .AddDocumentFromString(schemaString) .BindComplexType<Query>() .Create(); var executor = schema.MakeExecutable(); Console.WriteLine(executor.Execute("{ hello }").ToJson()); } public class Query { /// <summary> /// 目测这里只对Hello或GetHello免疫 /// </summary> /// <returns></returns> public string Hello() => "world"; } } #endregion #region PureCode-First public class PureCodeFirst { public static void Run() { var schema = SchemaBuilder .New() .AddQueryType<Query>() .Create(); var executor = schema.MakeExecutable(); Console.WriteLine(executor.Execute("{ hello }").ToJson()); } public class Query { /// <summary> /// 目测这里只对Hello或GetHello免疫 /// </summary> /// <returns></returns> public string Hello() => "world"; } } #endregion }
通过上面实例,这两种不同点在于Query是定义了一个类来实现,还是通过一个约定字符串来实现,本质上都是一个方法(也可以是属性要一个字符串的返回值)。如果你注意到了PureCode-First,这只是一个变种,不过这个看起来对一个C#程序来说情怀实足。
其中不管那种方式,执行api的方式始终不变"{hello}",这里我们实际上调用的是hello方法,不过看来也只有这样一个数据了。
想要更快更方便的了解相关知识,可以关注微信公众号