Sparkdo.DistributedLocking.StackExchangeRedis
1.0.2-preview.5
This is a prerelease version of Sparkdo.DistributedLocking.StackExchangeRedis.
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package Sparkdo.DistributedLocking.StackExchangeRedis --version 1.0.2-preview.5
NuGet\Install-Package Sparkdo.DistributedLocking.StackExchangeRedis -Version 1.0.2-preview.5
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Sparkdo.DistributedLocking.StackExchangeRedis" Version="1.0.2-preview.5" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Sparkdo.DistributedLocking.StackExchangeRedis" Version="1.0.2-preview.5" />
<PackageReference Include="Sparkdo.DistributedLocking.StackExchangeRedis" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Sparkdo.DistributedLocking.StackExchangeRedis --version 1.0.2-preview.5
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Sparkdo.DistributedLocking.StackExchangeRedis, 1.0.2-preview.5"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Sparkdo.DistributedLocking.StackExchangeRedis@1.0.2-preview.5
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Sparkdo.DistributedLocking.StackExchangeRedis&version=1.0.2-preview.5&prerelease
#tool nuget:?package=Sparkdo.DistributedLocking.StackExchangeRedis&version=1.0.2-preview.5&prerelease
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Sparkdo.DistributedLocking.StackExchangeRedis
Sparkdo 分布式锁 Redis 实现库,基于 StackExchange.Redis 和 Medallion.Threading.Redis 提供分布式锁功能的 Redis 实现。
功能特性
- 基于 StackExchange.Redis 的分布式锁实现
- 与 Sparkdo 分布式锁抽象层无缝集成
- 支持 Redis 作为分布式锁后端
安装
<PackageReference Include="Sparkdo.DistributedLocking.StackExchangeRedis" Version="x.x.x" />
核心组件
StackExchangeRedisDistributedLockProviderFactory
基于 StackExchange.Redis 的分布式锁提供程序工厂实现:
- 实现了
IDistributedLockProviderFactory接口 - 使用 StackExchange.Redis 库创建 Redis 分布式锁提供程序
- 通过 Medallion.Threading.Redis 包装器实现分布式锁功能
SparkdoDistributedLockingStackExchangeRedisModule
Sparkdo 分布式锁 StackExchangeRedis 模块类:
- 用于注册基于 StackExchange.Redis 的分布式锁相关服务到依赖注入容器
- 替换默认的分布式锁提供程序工厂实现
使用示例
// 获取分布式锁服务
var distributedLock = serviceProvider.GetService<IDistributedLock>();
// 尝试获取锁
await using var handle = await distributedLock.TryAcquireAsync("myLock", TimeSpan.FromSeconds(10));
if (handle != null)
{
// 执行需要同步保护的代码
// 锁会在 using 语句结束时自动释放
}
配置要求
要使用该库,需要先配置 StackExchange.Redis 连接:
// 配置 Redis 连接
services.AddSingleton<IDatabase>(provider => {
var connection = ConnectionMultiplexer.Connect("localhost:6379");
return connection.GetDatabase();
});
代码结构说明
本项目包含以下主要组件:
核心实现
StackExchangeRedisDistributedLockProviderFactory: 基于 StackExchange.Redis 的分布式锁提供程序工厂实现
配置
SparkdoDistributedLockingStackExchangeRedisModule: 分布式锁 StackExchangeRedis 模块配置
所有公共接口和类都添加了详细的 XML 文档注释,便于开发者理解和使用。
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net10.0
- DistributedLock.Core (>= 1.0.9)
- DistributedLock.Redis (>= 1.1.1)
- JetBrains.Annotations (>= 2025.2.4)
- Microsoft.Extensions.Configuration (>= 10.0.5)
- Microsoft.Extensions.Configuration.CommandLine (>= 10.0.5)
- Microsoft.Extensions.Configuration.EnvironmentVariables (>= 10.0.5)
- Microsoft.Extensions.Configuration.FileExtensions (>= 10.0.5)
- Microsoft.Extensions.Configuration.Json (>= 10.0.5)
- Microsoft.Extensions.Configuration.UserSecrets (>= 10.0.5)
- Microsoft.Extensions.DependencyInjection (>= 10.0.5)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.5)
- Microsoft.Extensions.DependencyModel (>= 10.0.5)
- Microsoft.Extensions.FileProviders.Physical (>= 10.0.5)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Localization (>= 10.0.5)
- Microsoft.Extensions.Logging (>= 10.0.5)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Options (>= 10.0.5)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.5)
- Microsoft.Extensions.Options.DataAnnotations (>= 10.0.5)
- Nito.AsyncEx.Context (>= 5.1.2)
- Sparkdo.DistributedLocking (>= 1.0.2-preview.5)
- Sparkdo.StackExchangeRedis (>= 1.0.2-preview.5)
- StackExchange.Redis (>= 2.12.14)
- System.Linq.Dynamic.Core (>= 1.7.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.0.3-preview.1 | 37 | 5/17/2026 |
| 1.0.2 | 105 | 4/27/2026 |
| 1.0.2-preview.5 | 62 | 4/15/2026 |
| 1.0.2-preview.4 | 79 | 2/8/2026 |
| 1.0.2-preview.3 | 71 | 2/1/2026 |
| 1.0.2-preview.2 | 66 | 1/31/2026 |
| 1.0.2-preview.1 | 180 | 12/4/2025 |
| 1.0.1 | 217 | 11/27/2025 |
| 1.0.0 | 217 | 11/25/2025 |
| 1.0.0-preview.5 | 136 | 10/24/2025 |