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){idnametel}b:student(id:20){idnametel}c:student(id:30){idnametel}d:student(id:40){idnametel}
}
返回结果：
调置断点，可以看到监视里的keys是四个元素，一次请求来的，DataLoader会把条件id分离出来提供给我们，方便进行后端数据查询，这也是便是DataLoader的神奇之处。