EasilyNET.MongoDistributedLock 1.9.0-preview1

.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher.
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 6 months ago
3.24.1112.125 106 6 months ago
3.24.1107.140 103 6 months ago
3.24.1107.54 101 6 months ago
3.24.1107.34 112 6 months ago
3.24.1105.111 112 6 months ago
3.24.1103.31 118 7 months ago
3.24.1103 114 7 months ago
3.24.1031.135 108 7 months ago
3.24.1031.112 108 7 months ago
3.24.1031.104 106 7 months ago
3.24.1029.142 106 7 months ago
3.24.1025.30 113 7 months ago
3.24.1022.142 88 7 months ago
3.24.1018.204 160 7 months ago
3.24.1018.175 158 7 months ago
3.24.1018.166 150 7 months ago
3.24.1018.93 157 7 months ago
3.24.1017.42 109 7 months ago
3.24.1016.161 107 7 months ago
3.24.1015.231 103 7 months ago
3.24.1015.14 109 7 months ago
3.24.1012.114 104 7 months ago
3.24.1009.115 110 7 months ago
3.24.1008.160 99 7 months ago
3.24.1008.133 107 7 months ago
3.24.1007.185 103 7 months ago
3.24.1003.33 116 8 months ago
3.24.1002.162 119 8 months ago
3.24.929.143 116 8 months ago
3.24.929.141 110 8 months ago
3.24.929.131 111 8 months ago
3.24.929.122 100 8 months ago
3.24.926.184 115 8 months ago
3.24.926.182 115 8 months ago
3.24.926.175 113 8 months ago
3.24.924.160 105 8 months ago
3.24.924.133 109 8 months ago
3.24.924.124 103 8 months ago
3.24.924.10 117 8 months ago
3.24.924.1 110 8 months ago
3.24.923.234 99 8 months ago
3.24.923.232 105 8 months ago
3.24.923.155 116 8 months ago
3.24.919.92 110 8 months ago
3.24.914.125 139 8 months ago
3.24.914.115 125 8 months ago
3.24.914.111 133 8 months ago
3.24.911.95 124 8 months ago
3.24.908.215 114 8 months ago
3.24.904.200 119 8 months ago
3.24.828.163 145 9 months ago
3.24.820.173 140 9 months ago
3.24.814.92 143 9 months ago
3.24.812.115 140 9 months ago
3.24.802.100 104 10 months ago
3.24.801.162 121 10 months ago
3.24.801.160 116 10 months ago
3.24.801.155 113 10 months ago
3.24.730.164 83 10 months ago
3.24.730.91 87 10 months ago
3.24.724.91 107 10 months ago
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