EasilyNET.MongoDistributedLock 1.9.0-preview1

This is a prerelease version of EasilyNET.MongoDistributedLock.
There is a newer version of this package available.
See the version list below for details.
dotnet add package EasilyNET.MongoDistributedLock --version 1.9.0-preview1
                    
NuGet\Install-Package EasilyNET.MongoDistributedLock -Version 1.9.0-preview1
                    
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="EasilyNET.MongoDistributedLock" Version="1.9.0-preview1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="EasilyNET.MongoDistributedLock" Version="1.9.0-preview1" />
                    
Directory.Packages.props
<PackageReference Include="EasilyNET.MongoDistributedLock" />
                    
Project file
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 EasilyNET.MongoDistributedLock --version 1.9.0-preview1
                    
#r "nuget: EasilyNET.MongoDistributedLock, 1.9.0-preview1"
                    
#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.
#addin nuget:?package=EasilyNET.MongoDistributedLock&version=1.9.0-preview1&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=EasilyNET.MongoDistributedLock&version=1.9.0-preview1&prerelease
                    
Install as a Cake Tool
EasilyNET.MongoDistributedLock
使用方法
// 使用MongoDB驱动创建一个链接
var setting = new MongoClientSettings
{
    Servers = new List<MongoServerAddress> { new("127.0.0.1", 27018) },
    Credential = MongoCredential.CreateCredential("admin", "guest", "guest"),
    LinqProvider = LinqProvider.V3
};
var client = new MongoClient(setting);
var db = client.GetDatabase("locks");
try
{
    // 由于使用到一些特性.需要将这个集合设置成 上限集合
    db.CreateCollection("release.signal", new()
    {
        // 这个数量理论上可以决定同时系统能有多少个锁.
        MaxDocuments = 100,
        MaxSize = 4096,
        Capped = true
    });
}
catch
{
    // ignored
}
IMongoCollection<LockAcquire> _locks = db.GetCollection<LockAcquire>("lock.acquire");
IMongoCollection<ReleaseSignal> _signals = db.GetCollection<ReleaseSignal>("release.signal");

// 获取锁
// 这里使用一个随机的ID作为锁ID,相当于其他锁中的Key.用来区分不同的业务的锁,也可以将不同的业务类型放到MongoDB中存起来,然后再使用的时候再取获取这个id
const string lockId = "64d44afde4473b85a177084c";

var mongoLock = DistributedLock.GenerateNew(_locks, _signals, ObjectId.Parse(lockId));
var acq = await mongoLock.AcquireAsync(TimeSpan.FromSeconds(5), TimeSpan.FromSeconds(0));

// 释放锁 也可以等超时释放
await mongoLock.ReleaseAsync(acq1);
  • 实际用的时候大概是这样.
try
{
    if (acq.Acquired)
    {
        // 关键部分,它不能一次由任何服务器上的多个线程执行
        // ...
        // ...
    }
    else
    {
        // 超时!也许另一个线程没有释放锁...我们可以再试一次或抛出例外
    }
}
finally
{
    // 如果(acq.Acquired)无需手动操作
    await mongoLock.ReleaseAsync(acq);
}
  • 注意事项和工作原理
  1. 当您尝试获取锁时,具有指定 lockId 的文档将添加到锁集合中,或者更新(如果存在).
  2. 释放锁时,将更新文档,并将新文档添加到信号上限集合中
  3. 当锁定正在等待时,将使用服务器端等待的可尾游标.详细信息
  4. 生存期是锁有效的时间段.在此时间之后,锁将自动“释放”,并且可以再次获取.它可以防止死锁.
  5. 不要使用长时间的超时,这可能会引发 MongoDB 驱动程序的异常.正常超时不超过 1-2 分钟!
Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  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.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on EasilyNET.MongoDistributedLock:

Package Downloads
EasilyNET.MongoDistributedLock.AspNetCore

MongoDB分布式锁方案

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.24.1113.100 141 8 months ago
3.24.1112.125 118 8 months ago
3.24.1107.140 114 8 months ago
3.24.1107.54 116 8 months ago
3.24.1107.34 125 8 months ago
3.24.1105.111 124 8 months ago
3.24.1103.31 127 8 months ago
3.24.1103 124 8 months ago
3.24.1031.135 118 8 months ago
3.24.1031.112 118 8 months ago
3.24.1031.104 116 8 months ago
3.24.1029.142 114 8 months ago
3.24.1025.30 124 8 months ago
3.24.1022.142 112 9 months ago
3.24.1018.204 173 9 months ago
3.24.1018.175 169 9 months ago
3.24.1018.166 161 9 months ago
3.24.1018.93 170 9 months ago
3.24.1017.42 119 9 months ago
3.24.1016.161 116 9 months ago
3.24.1015.231 115 9 months ago
3.24.1015.14 123 9 months ago
3.24.1012.114 120 9 months ago
3.24.1009.115 123 9 months ago
3.24.1008.160 110 9 months ago
3.24.1008.133 120 9 months ago
3.24.1007.185 115 9 months ago
3.24.1003.33 125 9 months ago
3.24.1002.162 129 9 months ago
3.24.929.143 127 9 months ago
3.24.929.141 124 9 months ago
3.24.929.131 122 9 months ago
3.24.929.122 111 9 months ago
3.24.926.184 129 9 months ago
3.24.926.182 124 9 months ago
3.24.926.175 127 9 months ago
3.24.924.160 115 9 months ago
3.24.924.133 121 9 months ago
3.24.924.124 114 9 months ago
3.24.924.10 129 10 months ago
3.24.924.1 120 10 months ago
3.24.923.234 112 10 months ago
3.24.923.232 121 10 months ago
3.24.923.155 125 10 months ago
3.24.919.92 120 10 months ago
3.24.914.125 147 10 months ago
3.24.914.115 134 10 months ago
3.24.914.111 145 10 months ago
3.24.911.95 135 10 months ago
3.24.908.215 124 10 months ago
3.24.904.200 129 9/4/2024
3.24.828.163 155 8/28/2024
3.24.820.173 152 8/20/2024
3.24.814.92 153 8/14/2024
3.24.812.115 151 8/12/2024
3.24.802.100 118 8/2/2024
3.24.801.162 136 8/1/2024
3.24.801.160 126 8/1/2024
3.24.801.155 122 8/1/2024
3.24.730.164 92 7/30/2024
3.24.730.91 97 7/30/2024
3.24.724.91 116 7/24/2024
3.24.718.105 145 7/18/2024
3.24.716.95 126 7/16/2024
3.24.712.94 126 7/12/2024
3.24.710.14 144 7/9/2024
3.24.709.105 129 7/9/2024
3.24.704.94 148 7/4/2024
3.24.701.90 140 7/1/2024
3.24.628.114 141 6/28/2024
3.24.627.145 128 6/27/2024
3.24.620.160 136 6/20/2024
3.24.613.115 126 6/13/2024
3.24.612.95 129 6/12/2024
3.24.528.90 135 5/28/2024
3.24.522.84 136 5/22/2024
3.24.512.213 129 5/12/2024
3.24.508.112 152 5/8/2024
2.2024.428.71 152 4/28/2024
2.2024.427.1128 150 4/27/2024
2.2.72 146 4/14/2024
2.2.71 135 4/12/2024
2.2.8 133 4/26/2024
2.2.6 138 4/10/2024
2.2.5 132 3/26/2024
2.2.4 140 3/25/2024
2.2.3 135 3/24/2024
2.2.2 155 3/21/2024
2.2.1 169 3/20/2024
2.2.0 159 3/13/2024
2.1.9 160 2/21/2024
2.1.8 137 2/18/2024
2.1.7 163 2/16/2024
2.1.6 142 2/14/2024
2.1.5 143 2/14/2024
2.1.4 167 2/9/2024
2.1.3 166 2/8/2024
2.1.2 143 2/5/2024
2.1.1.2 214 12/26/2023
2.1.1.1 160 12/26/2023
2.1.1 160 12/25/2023
2.1.0 176 12/17/2023
2.0.11 168 12/6/2023
2.0.1 197 11/15/2023
2.0.0 177 11/14/2023
1.9.1 169 11/1/2023
1.9.0 158 10/19/2023
1.9.0-preview2 131 10/12/2023
1.9.0-preview1 149 10/12/2023
1.8.9 171 10/11/2023
1.8.8 180 10/11/2023
1.8.7-rc2 122 9/21/2023
1.8.7-rc1 134 9/12/2023
1.8.6 191 8/31/2023
1.8.5 179 8/25/2023
1.8.4 175 8/24/2023
1.8.3 207 8/23/2023
1.8.2 184 8/22/2023
1.8.1 176 8/18/2023
1.8.0 197 8/15/2023
1.7.9 196 8/11/2023
1.7.8 199 8/11/2023
1.7.7 196 8/10/2023
1.7.6 185 8/9/2023
1.7.5 200 8/9/2023
1.7.4 201 8/3/2023
1.7.3 206 8/1/2023
1.7.2 202 7/31/2023
1.7.1 193 7/27/2023
1.7.0 212 7/27/2023