.NET Core 使用 GraphQL.Server 在 Azure Functions 中实现依赖注入

变量

使用$符号来声明变量，可以在查询中重用变量。

例如：

query getPerson($id: ID!) {
  person(id: $id) {
    name
    age
  }
}

在执行时，需要提供变量的值。例如：

{
  "id": "1"
}

片段

可以在查询中使用片段来重用查询部分。片段以'…'开头，后面跟上片段名称。

例如：

query {
  person(id: "1") {
    name
    age
    address {
      ...addressFields
    }
  }
}

fragment addressFields on Address {
  street
  city
  state
}

操作名称

可以使用操作名称来标识查询，方便调试和追踪。操作名称在关键字'query'或'mutation'之后的花括号之间定义。

例如：

query getPerson($id: ID!) {
  person(id: $id) {
    name
    age
  }
}

变更

使用关键字'mutation'来声明变更操作。变更可以用来进行数据的修改和创建。

例如：

mutation {
  createPerson(name: "Sam", age: 25) {
    id
    name
    age
  }
}

以上是 GraphQL 的基本语法，还有更多高级特性和语法详情可以参考 GraphQL 官方文档。

Azure Functions 集成

创建项目

新建一个 Azure Functions 项目。

安装依赖

安装以下 NuGet 包：

Microsoft.NET.Sdk.Functions
Microsoft.Azure.Functions.Extensions

注册服务

要注册服务，我们需要创建一个 FunctionStartup 类，就像我们在一个常见的 ASP.NET Core 应用程序中一样。

在应用程序的根目录下创建一个名为 FunctionStartup.cs 的文件。

using GraphQL;
using Microsoft.Azure.Functions.Extensions.DependencyInjection;
using Microsoft.Extensions.DependencyInjection;
using Chat = GraphQL.Samples.Schemas.Chat;

[assembly: FunctionsStartup(typeof(Samples.AzureFunctions.Startup))]
namespace Samples.AzureFunctions;

public class Startup : FunctionsStartup
{
    public override void Configure(IFunctionsHostBuilder builder)
    {
        builder.Services.AddSingleton<Chat.IChat, Chat.Chat>();

        builder.Services.AddGraphQL(b => b
            .AddAutoSchema<Chat.Query>()
            .AddSystemTextJson());
    }
}

使用服务

打开你的函数文件进行以下更改：从类和函数中删除 static 标记（我们需要使用构造函数注入），创建构造函数并注入依赖接口。

using GraphQL.Server.Transports.AspNetCore;
using GraphQL.Server.Ui.Playground;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.Extensions.Logging;

namespace Samples.AzureFunctions;

public class GraphQL
{
    [FunctionName("GraphQL")]
    public IActionResult RunGraphQL(
        [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest request,
        ILogger log)
    {
        log.LogInformation("C# HTTP trigger function processed a GraphQL request.");

        return new GraphQLExecutionActionResult();
    }

    [FunctionName("Playground")]
    public IActionResult RunPlayground(
        [HttpTrigger(AuthorizationLevel.Anonymous, "get")] HttpRequest request,
        ILogger log)
    {
        log.LogInformation("C# HTTP trigger function processed a request for the GraphQL Playground UI.");

        return new PlaygroundActionResult(opts => opts.GraphQLEndPoint = "/api/graphql"); // /api/graphql route will call RunGraphQL method
    }
}

运行

启动项目并访问相应端点进行验证。