graphql-dotnet/graphql-dotnet/ 和 graphql-dotnet/server/

问题描述

早上好。

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

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

他们都在同一个组织下,贡献者有一些重叠,但我在决定使用哪一个时有点迷茫。

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

我注意到 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/ 的文档多得多,所以我怎么知道我使用的是哪一个

任何人都可以推荐任何突出两者之间差异的文档吗?

解决方法

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

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

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

如果您不需要订阅,并且想要更多地控制框架如何处理 HTTP 请求,那么编写自己的控制器或中间件会更容易。

使用 JWT 身份验证由 ASP.NET 处理,可用于任一场景。联合也可用于任一场景。