graphql-dotnet/graphql-dotnet/和graphql-dotnet/server/有什么区别

Question

早上好。

我对这两个存储库(graphql-dotnet/graphql-dotnet/和graphql-dotnet/server/)感到有点困惑。

https://github.com/graphql-dotnet/graphql-dotnet/和https://github.com/graphql-dotnet/server

他们都在同一个组织下，并且有一些重叠的贡献者，但我有点迷茫，不知道该使用哪一个。

我想构建一个托管graphql端点的DotNet5应用程序。简而言之，这就是我的目标。

我注意到graphql-dotnet/server/存储库内置了一些帮助程序，例如。

 serviceCollection
                    .AddGraphQL((options, provider) =>
                    {
                        options.EnableMetrics = HostEnvironment.IsDevelopment();
                        var logger = provider.GetRequiredService<ILogger<Startup>>();
                        options.UnhandledExceptionDelegate = ctx => logger.LogError("{Error} occurred", ctx.OriginalException.Message);
                    })
                    .AddSystemTextJson()
                    .AddErrorInfoProvider(opt => opt.ExposeExceptionStackTrace = HostEnvironment.IsDevelopment())
                    .AddWebSockets() 
                    .AddDataLoader() 
                    .AddGraphTypes(typeof(ApplicationSchema))

这使得我的DI设置起来又好又简单。与之对应的graphql-dotnet/graphql-dotnet/并非如此。

所以我的问题是“我应该排他性地使用哪一个?次要目标是添加jwt身份验证和最终的联合支持。但这两个是很遥远的。”

我的一个同事继续使用graphql-dotnet/graphql-dotnet/，他的服务器应用程序的配置比graphql-dotnet/server/的文档多得多，那么我如何知道我使用的是哪一个呢？

有谁能推荐一些文档来突出这两者之间的区别吗？

Answer 1

主要的graphql-dotnet代码库是GraphQL组件的“核心”库。服务器存储库包含特定于ASP.NET的扩展。它使用核心库。如果您使用服务器项目，那么您也在使用核心库。

GraphQL本身可以与任何协议一起使用，它不需要与HTTP或JSON一起使用。因此，核心库没有任何HTTP或ASP.NET依赖项。

如果您使用的是ASP.NET，那么服务器项目是最快的入门方式。如果要使用订阅，则服务器项目将提供该功能。

如果您不需要订阅，并且希望对框架处理HTTP请求的方式有更多的控制，那么编写自己的控制器或中间件会更容易一些。

使用JWT身份验证是由ASP.NET处理的，可以在任一场景中使用。在这两种场景中，也可以使用联合。