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 EasilyNET.MongoDistributedLock as a Cake Addin
#tool nuget:?package=EasilyNET.MongoDistributedLock&version=1.9.0-preview1&prerelease
                    
Install EasilyNET.MongoDistributedLock 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 124 11/13/2024
3.24.1112.125 106 11/12/2024
3.24.1107.140 103 11/7/2024
3.24.1107.54 101 11/7/2024
3.24.1107.34 112 11/7/2024
3.24.1105.111 112 11/5/2024
3.24.1103.31 118 11/2/2024
3.24.1103 114 11/2/2024
3.24.1031.135 108 10/31/2024
3.24.1031.112 108 10/31/2024
3.24.1031.104 106 10/31/2024
3.24.1029.142 106 10/29/2024
3.24.1025.30 113 10/24/2024
3.24.1022.142 88 10/22/2024
3.24.1018.204 160 10/18/2024
3.24.1018.175 158 10/18/2024
3.24.1018.166 150 10/18/2024
3.24.1018.93 157 10/18/2024
3.24.1017.42 109 10/16/2024
3.24.1016.161 107 10/16/2024
3.24.1015.231 103 10/15/2024
3.24.1015.14 109 10/14/2024
3.24.1012.114 104 10/12/2024
3.24.1009.115 110 10/9/2024
3.24.1008.160 99 10/8/2024
3.24.1008.133 107 10/8/2024
3.24.1007.185 103 10/7/2024
3.24.1003.33 116 10/2/2024
3.24.1002.162 119 10/2/2024
3.24.929.143 116 9/29/2024
3.24.929.141 110 9/29/2024
3.24.929.131 111 9/29/2024
3.24.929.122 100 9/29/2024
3.24.926.184 115 9/26/2024
3.24.926.182 115 9/26/2024
3.24.926.175 113 9/26/2024
3.24.924.160 105 9/24/2024
3.24.924.133 109 9/24/2024
3.24.924.124 103 9/24/2024
3.24.924.10 117 9/23/2024
3.24.924.1 110 9/23/2024
3.24.923.234 99 9/23/2024
3.24.923.232 105 9/23/2024
3.24.923.155 116 9/23/2024
3.24.919.92 110 9/19/2024
3.24.914.125 139 9/14/2024
3.24.914.115 125 9/14/2024
3.24.914.111 133 9/14/2024
3.24.911.95 124 9/11/2024
3.24.908.215 114 9/8/2024
3.24.904.200 119 9/4/2024
3.24.828.163 145 8/28/2024
3.24.820.173 140 8/20/2024
3.24.814.92 143 8/14/2024
3.24.812.115 140 8/12/2024
3.24.802.100 104 8/2/2024
3.24.801.162 121 8/1/2024
3.24.801.160 116 8/1/2024
3.24.801.155 113 8/1/2024
3.24.730.164 83 7/30/2024
3.24.730.91 87 7/30/2024
3.24.724.91 107 7/24/2024
3.24.718.105 134 7/18/2024
3.24.716.95 116 7/16/2024
3.24.712.94 110 7/12/2024
3.24.710.14 132 7/9/2024
3.24.709.105 119 7/9/2024
3.24.704.94 137 7/4/2024
3.24.701.90 130 7/1/2024
3.24.628.114 127 6/28/2024
3.24.627.145 119 6/27/2024
3.24.620.160 125 6/20/2024
3.24.613.115 115 6/13/2024
3.24.612.95 117 6/12/2024
3.24.528.90 121 5/28/2024
3.24.522.84 128 5/22/2024
3.24.512.213 115 5/12/2024
3.24.508.112 143 5/8/2024
2.2024.428.71 143 4/28/2024
2.2024.427.1128 140 4/27/2024
2.2.72 137 4/14/2024
2.2.71 125 4/12/2024
2.2.8 124 4/26/2024
2.2.6 124 4/10/2024
2.2.5 122 3/26/2024
2.2.4 128 3/25/2024
2.2.3 124 3/24/2024
2.2.2 145 3/21/2024
2.2.1 159 3/20/2024
2.2.0 149 3/13/2024
2.1.9 151 2/21/2024
2.1.8 129 2/18/2024
2.1.7 151 2/16/2024
2.1.6 131 2/14/2024
2.1.5 133 2/14/2024
2.1.4 154 2/9/2024
2.1.3 158 2/8/2024
2.1.2 134 2/5/2024
2.1.1.2 205 12/26/2023
2.1.1.1 149 12/26/2023
2.1.1 152 12/25/2023
2.1.0 168 12/17/2023
2.0.11 162 12/6/2023
2.0.1 189 11/15/2023
2.0.0 172 11/14/2023
1.9.1 161 11/1/2023
1.9.0 146 10/19/2023
1.9.0-preview2 119 10/12/2023
1.9.0-preview1 139 10/12/2023
1.8.9 161 10/11/2023
1.8.8 169 10/11/2023
1.8.7-rc2 112 9/21/2023
1.8.7-rc1 123 9/12/2023
1.8.6 177 8/31/2023
1.8.5 168 8/25/2023
1.8.4 165 8/24/2023
1.8.3 190 8/23/2023
1.8.2 171 8/22/2023
1.8.1 164 8/18/2023
1.8.0 185 8/15/2023
1.7.9 182 8/11/2023
1.7.8 183 8/11/2023
1.7.7 180 8/10/2023
1.7.6 171 8/9/2023
1.7.5 186 8/9/2023
1.7.4 187 8/3/2023
1.7.3 190 8/1/2023
1.7.2 189 7/31/2023
1.7.1 181 7/27/2023
1.7.0 199 7/27/2023