DaprWorkflowClient 使用

Mon, 01 Jan 0001 00:00:00 +0000

生命周期管理

DaprWorkflowClient 可以访问网络资源，这些资源通过 TCP 套接字与 Dapr sidecar 以及其他用于管理和操作工作流的类型进行通信。DaprWorkflowClient 实现了 IAsyncDisposable 接口，以便快速清理资源。

依赖注入

AddDaprWorkflow() 方法用于通过 ASP.NET Core 的依赖注入机制注册 Dapr 工作流服务。此方法需要一个选项委托，用于定义您希望在应用程序中注册和使用的每个工作流和活动。

注意

此方法会尝试注册一个 DaprClient 实例，但仅在尚未以其他生命周期注册的情况下才有效。例如，如果之前以单例生命周期调用了 AddDaprClient()，那么无论为工作流客户端选择何种生命周期，都会始终使用单例。DaprClient 实例用于与 Dapr sidecar 通信，如果尚未注册，则在 AddDaprWorkflow() 注册期间提供的生命周期将用于注册 DaprWorkflowClient 及其依赖项。

单例注册

默认情况下，AddDaprWorkflow 方法会以单例生命周期注册 DaprWorkflowClient 和相关服务。这意味着服务只会被实例化一次。

以下是在典型的 Program.cs 文件中注册 DaprWorkflowClient 的示例：

builder.Services.AddDaprWorkflow(options => {
 options.RegisterWorkflow<YourWorkflow>();
 options.RegisterActivity<YourActivity>();
});

var app = builder.Build();
await app.RunAsync();

作用域注册

虽然默认的单例注册通常适用，但您可能希望指定不同的生命周期。这可以通过在 AddDaprWorkflow 中传递一个 ServiceLifetime 参数来实现。例如，您可能需要将另一个作用域服务注入到 ASP.NET Core 处理管道中，该管道需要 DaprClient 使用的上下文，如果前者服务注册为单例，则无法使用。

以下示例演示了这一点：

builder.Services.AddDaprWorkflow(options => {
 options.RegisterWorkflow<YourWorkflow>();
 options.RegisterActivity<YourActivity>();
}, ServiceLifecycle.Scoped);

var app = builder.Build();
await app.RunAsync();

瞬态注册

最后，Dapr 服务也可以使用瞬态生命周期注册，这意味着每次注入时都会重新初始化。这在以下示例中演示：

如何：在 .NET SDK 中编写和管理 Dapr 工作流

Mon, 01 Jan 0001 00:00:00 +0000

我们来创建一个 Dapr 工作流并通过控制台调用它。在提供的订单处理工作流示例中，控制台会提示如何进行购买和补货。在本指南中，您将：

部署一个 .NET 控制台应用程序 (WorkflowConsoleApp)。
使用 .NET 工作流 SDK 和 API 调用来启动和查询工作流实例。

在 .NET 示例项目里：

主要的 Program.cs 文件包含应用程序的设置，包括工作流和工作流活动的注册。
工作流定义位于 Workflows 目录中。
工作流活动定义位于 Activities 目录中。

先决条件

注意

Dapr.Workflows 在 v1.15 中支持 .NET 7 或更高版本。然而，从 Dapr v1.16 开始，仅支持 .NET 8 和 .NET 9。

设置环境

克隆 .NET SDK 仓库。

git clone https://github.com/dapr/dotnet-sdk.git

从 .NET SDK 根目录，导航到 Dapr 工作流示例。

cd examples/Workflow

本地运行应用程序

要运行 Dapr 应用程序，您需要启动 .NET 程序和一个 Dapr sidecar。导航到 WorkflowConsoleApp 目录。

Dapr Workflow .NET SDK on Dapr 文档库