DaprClient 使用

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

生命周期管理

DaprClient 使用 TCP 套接字来访问网络资源，与 Dapr sidecar 进行通信。它实现了 IDisposable 接口，以便快速清理资源。

依赖注入

通过 AddDaprClient() 方法可以在 ASP.NET Core 中注册 Dapr 客户端。此方法接受一个可选的配置委托，用于配置 DaprClient，以及一个 ServiceLifetime 参数，允许您为注册的资源指定不同的生命周期，默认是 Singleton。

以下示例展示了如何使用默认值注册 DaprClient：

services.AddDaprClient();

您可以通过配置委托在 DaprClientBuilder 上指定选项来配置 DaprClient，例如：

services.AddDaprClient(daprBuilder => {
 daprBuilder.UseJsonSerializerOptions(new JsonSerializerOptions {
 WriteIndented = true,
 MaxDepth = 8
 });
 daprBuilder.UseTimeout(TimeSpan.FromSeconds(30));
});

另一个重载允许访问 DaprClientBuilder 和 IServiceProvider，以便进行更高级的配置，例如从依赖注入容器中获取服务：

services.AddSingleton<SampleService>();
services.AddDaprClient((serviceProvider, daprBuilder) => {
 var sampleService = serviceProvider.GetRequiredService<SampleService>();
 var timeoutValue = sampleService.TimeoutOptions;
 
 daprBuilder.UseTimeout(timeoutValue);
});

手动实例化

除了依赖注入，您还可以使用静态客户端构建器手动创建 DaprClient。

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

避免为每个操作创建一个新的 DaprClient 实例并在操作完成后释放它。

配置 DaprClient

在调用 .Build() 创建客户端之前，可以通过 DaprClientBuilder 类上的方法来配置 DaprClient。每个 DaprClient 对象的设置是独立的，创建后无法更改。

var daprClient = new DaprClientBuilder()
 .UseJsonSerializerSettings( ... ) // 配置 JSON 序列化器
 .Build();

默认情况下，DaprClientBuilder 会按以下顺序优先获取配置值：

开始使用 Dapr 客户端 .NET SDK on Dapr 文档库

DaprClient 使用

生命周期管理

依赖注入

手动实例化

配置 DaprClient