GraphQL:面对复杂类型
GraphQL 既是一種用于 API 的查詢語言也是一個滿足你數據查詢的運行時。GraphQL 對你的 API 中的數據提供了一套易于理解的完整描述,使得客戶端能夠準確地獲得它需要的數據,而且沒有任何冗余,也讓 API 更容易地隨著時間推移而演進,還能用于構建強大的開發者工具。
? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?——出自?https://graphql.cn
上一篇博文中,我們返回值是一個字符串,對于大多數情況,我們更多的是返回實體類的json格式。
第一版
using HotChocolate; using HotChocolate.Data; using HotChocolate.Execution; using HotChocolate.Types; using System; using System.Collections.Generic;namespace GraphQLBase002 {class?Program{static?void?Main(string[]?args){?????????FirstVersion.Run();???????}}//實體類public?class?Student{public?int?Id?{?get;?set;?}public?string?Name?{?get;?set;?}public?int?Age?{?get;?set;?}}#region FirstVersionpublic?class?FirstVersion{public?static?void?Run() {var schema = SchemaBuilder.New().AddQueryType<QueryType>().Create();var executor = schema.MakeExecutable();//回為返回是字符串,所以用定義的Resolver name來查詢Console.WriteLine(executor.Execute("{ students }").ToJson());}public?class?Query{public?IList<Student>?GetStudents(){return?new?List<Student>()?{new?Student?{Id = 100,Name = "ABCD",Age=20},new?Student?{Id = 101,Name = "EFGH",Age=19}};}}public?class?QueryType?:?ObjectType<Query>{protected?override?void?Configure(IObjectTypeDescriptor<Query>?descriptor) {//定義了有students來請求GetStudents方法,返回的類型是StringType,所以在Resolver中會把實體轉成Jsondescriptor.Field<Query>(t => t.GetStudents()).Name("students").Type<NonNullType<StringType>>().Resolver(ctx =>{var result = ctx.Parent<Query>().GetStudents();return Newtonsoft.Json.JsonConvert.SerializeObject(result);});}}}#endregion為了返回一個json,用Resolver來獲取GetStudents,并把實例親手轉成json返回,因為是字符串,所以這個Field的Type是StringType。
運行結果,看起來是個json,不,準確說是一個json格式的字符串,其實從我們定義Resolver來說就非常清楚了;這并不是我們想要的。
第二版
這次我們為了不再是json格式字符串,在代碼中定義了StudentType這個的類型,告訴系統Student不是一個簡單類型,但Student內的屬性,都是簡單類型,所以在Configure中沒有作任何處理(如果Student中有自定義復雜類型的屬性,還得進一步定義這個類型,并在Configure中處理),在QueryType中,處理了Query中的兩個方法的類型定義和重命名。
運行結果如下,對,這就是我們要的結果;但總覺得為了實現返回json,我們的代價是不是有點大?
第三版
#region ThreeVersionpublic class ThreeVersion{public static void Run(){var schema = SchemaBuilder.New().AddProjections().AddQueryType<Query>().Create();var?executor?=?schema.MakeExecutable();Console.WriteLine(executor.Execute("{ student{id name age} }").ToJson());Console.WriteLine(executor.Execute("{?students{id?name age}?}").ToJson());}public class Query{[UseProjection] public Student GetStudent(){return new Student{Id = 1,Name = "AAAAA",Age = 19};}[UseProjection]public List<Student> GetStudents(){return new List<Student>{new Student{Id = 100,Name = "ABCD",Age = 19},new Student{Id = 101,Name = "EFGH",Age = 20}};}}}#endregion這一版我們借雞下蛋,用UseProjection來替代了我們定義的類型,連QueryType也消失了,這樣的代碼才是我們想要的,讓我們更關注業務的邏輯,而不是關注為了GraphQL,而做很多技術配合工作;其實我們從第二版看定義的類型StudentType,QueryType,也知道這些類型是非常規律性的,是可以通過代碼手段替代的,那就是UseProjection。
運行結果與版本二一樣。
總結
以上是生活随笔為你收集整理的GraphQL:面对复杂类型的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 了解一下HTTP1.1 Pipelini
- 下一篇: 为什么建议学生积极参与开源项目?