如何：在 .NET SDK 中编写和管理 Dapr 流式订阅

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

我们来创建一个使用流式功能的发布/订阅主题或队列的订阅。我们将使用此处提供的简单示例，进行演示，并逐步讲解如何在运行时配置消息处理程序，而无需预先配置端点。在本指南中，您将会学习如何：

部署一个 .NET Web API 应用程序 (StreamingSubscriptionExample)
使用 Dapr .NET Messaging SDK 动态订阅发布/订阅主题。

前提条件

Dapr CLI
已初始化的 Dapr 环境
安装 .NET 6、.NET 8 或 .NET 9
项目中安装 Dapr.Messaging NuGet 包

注意

请注意，虽然 .NET 6 是 Dapr v1.15 中支持的最低版本，但只有 .NET 8 和 .NET 9 将在 v1.16 及更高版本中继续受到支持。

设置环境

克隆 .NET SDK 仓库。

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

从 .NET SDK 根目录，导航到 Dapr 流式发布/订阅示例。

cd examples/Client/PublishSubscribe

本地运行应用程序

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

cd StreamingSubscriptionExample

我们将运行一个命令，同时启动 Dapr sidecar 和 .NET 程序。

DaprPublishSubscribeClient 使用指南

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

生命周期管理

DaprPublishSubscribeClient 是 Dapr 客户端的一个版本，专门用于与 Dapr 消息 API 交互。它可以与 DaprClient 和其他 Dapr 客户端一起注册而不会出现问题。

它通过 TCP 套接字与 Dapr sidecar 通信，维护对网络资源的访问，并实现了 IAsyncDisposable 接口以支持资源的快速清理。

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

可以通过依赖注入来实现这一点。注册方法支持以单例、作用域实例或瞬态（每次注入时重新创建）的方式进行注册，但也可以通过 IConfiguration 或其他注入服务的值来注册，这在每个类中从头创建客户端时是不切实际的。

避免为每个操作创建一个 DaprPublishSubscribeClient 并在操作完成后销毁它。DaprPublishSubscribeClient 应仅在您不再希望接收订阅事件时才被销毁，因为销毁它将取消正在进行的新事件接收。

通过 DaprPublishSubscribeClientBuilder 配置 DaprPublishSubscribeClient

可以通过在 DaprPublishSubscribeClientBuilder 类上调用方法来配置 DaprPublishSubscribeClient，然后调用 .Build() 来创建客户端本身。每个 DaprPublishSubscribeClient 的设置是独立的，并且在调用 .Build() 之后无法更改。

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

DaprPublishSubscribeClientBuilder 包含以下设置：

Dapr sidecar 的 HTTP 端点
Dapr sidecar 的 gRPC 端点
用于配置 JSON 序列化的 JsonSerializerOptions 对象
用于配置 gRPC 的 GrpcChannelOptions 对象
用于认证请求到 sidecar 的 API 令牌
用于创建 SDK 使用的 HttpClient 实例的工厂方法
用于在向 sidecar 发出请求时使用的 HttpClient 实例的超时

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

Dapr Messaging .NET SDK on Dapr 文档库