GraphQL 既是一种用于 API 的查询语言也是一个满足你数据查询的运行时。GraphQL 对你的 API 中的数据提供了一套易于理解的完整描述,使得客户端能够准确地获得它需要的数据,而且没有任何冗余,也让 API 更容易地随着时间推移而演进,还能用于构建强大的开发者工具。
——出自 https://graphql.cn
Rest API中,一个api,通过参数,只能获取这个参数范围内的数据,如果想获取别的参数范围内数据,就得再次调用,比如GetStudent(id),想获取多个Student,就得多次调用,把替换id就可以,GraphQL的其中优势就是,在一次请求中,返回你所要的数据,减少请求,就像请求聚合。
using GreenDonut; using HotChocolate; using HotChocolate.Data; using HotChocolate.Fetching; using HotChocolate.Resolvers; using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Hosting; using Microsoft.AspNetCore.Http; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Hosting; using System; using System.Collections.Generic; using System.Linq; using System.Threading; using System.Threading.Tasks; namespace GraphQLDemo04 { public class Startup { /// <summary> /// Persons只是假装数据库 /// </summary> public static List<Result<Student>> Persons = new List<Result<Student>>(); public void ConfigureServices(IServiceCollection services) { for (int i = 0; i < 200; i++) { //NameCreater.GetFullName只是随机生成人的名称 var student = new Student { Id = i, Tel = "13453467" + i.ToString("D3"), Name = NameCreater.GetFullName() }; var result = Result<Student>.Resolve(student); Persons.Add(result); } services .AddGraphQLServer() .AddQueryType<Query>() ; } public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { if (env.IsDevelopment()) { app.UseDeveloperExceptionPage(); } app.UseRouting(); app.UseEndpoints(endpoints => { endpoints.MapGraphQL(); }); } } /// <summary> /// 查询类 /// </summary> public class Query { public Task<Student> GetStudent(int id, [DataLoader] StudentDataLoader loader) { return loader.LoadAsync(id); } } /// <summary> /// /// </summary> public class StudentDataLoader : DataLoaderBase<int, Student> { public StudentDataLoader(IBatchScheduler scheduler) : base(scheduler) { } protected override ValueTask<IReadOnlyList<Result<Student>>> FetchAsync(IReadOnlyList<int> keys, CancellationToken cancellationToken) { return new ValueTask<IReadOnlyList<Result<Student>>>(Startup.Persons.Where(s => keys.Contains(s.Value.Id)).ToList()); } } /// <summary> /// 学生 /// </summary> public class Student { public int Id { get; set; } public string Name { get; set; } public string Tel { get; set; } } }
代码中的StudentDataLoader就是来完成请求聚合的。
请求条件如下,请求四个id=10,id=20,id=30,id=40
{ a:student(id:10){ id name tel } b:student(id:20){ id name tel } c:student(id:30){ id name tel } d:student(id:40){ id name tel } }
返回结果:
调置断点,可以看到监视里的keys是四个元素,一次请求来的,DataLoader会把条件id分离出来提供给我们,方便进行后端数据查询,这也是便是DataLoader的神奇之处。
想要更快更方便的了解相关知识,可以关注微信公众号