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

What is the difference between graphql-dotnet/graphql-dotnet/ and 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 处理,可用于任一场景。联邦也可以用在任何一种情况下。