如何：在 .NET SDK 中编写和管理 Dapr 任务

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

我们来创建一个端点，该端点将在 Dapr 任务触发时被调用，然后在同一个应用中调度该任务。我们将使用此处提供的简单示例，进行以下演示，并通过它来解释如何使用间隔或 Cron 表达式自行调度一次性或重复性任务。在本指南中，您将：

在 .NET 示例项目中：

前提条件

请注意，虽然 .NET 6 是 Dapr v1.15 中支持的最低版本，但从 v1.16 开始，Dapr 仅支持 .NET 8 和 .NET 9。

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

从 .NET SDK 根目录，导航到 Dapr 任务示例。

cd examples/Jobs

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

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

DaprJobsClient 是专门用于与 Dapr Jobs API 交互的 Dapr 客户端。它可以与 DaprClient 和其他 Dapr 客户端一起注册而不会出现问题。

它通过 TCP 套接字与 Dapr sidecar 通信，并实现了 IDisposable 接口以便快速清理资源。

为了获得最佳性能，建议创建一个长生命周期的 DaprJobsClient 实例，并在整个应用程序中共享使用。DaprJobsClient 实例是线程安全的，适合在多个线程中共享。

可以通过依赖注入来实现这一点。注册方法支持以单例、作用域实例或瞬态方式注册，但也可以利用 IConfiguration 或其他注入服务中的值进行注册，这样就不需要在每个类中重新创建客户端。

避免为每个操作创建一个新的 DaprJobsClient 并在操作完成后销毁它。

可以通过 DaprJobsClientBuilder 类上的方法来配置 DaprJobsClient，然后调用 .Build() 来创建客户端。每个 DaprJobsClient 的设置是独立的，调用 .Build() 后无法更改。

var daprJobsClient = new DaprJobsClientBuilder()
 .UseDaprApiToken("abc123") // 指定用于验证到其他 Dapr sidecar 的 API 令牌
 .Build();

DaprJobsClientBuilder 包含以下设置：

SDK 将读取以下环境变量来配置默认值：