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

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#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

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

EasilyNET.MongoDistributedLock

基于 GitHub 开源项目

使用方法

// 使用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);
}

注意事项和工作原理

当您尝试获取锁时,具有指定 lockId 的文档将添加到锁集合中,或者更新(如果存在).
释放锁时,将更新文档,并将新文档添加到信号上限集合中
当锁定正在等待时,将使用服务器端等待的可尾游标.详细信息
生存期是锁有效的时间段.在此时间之后,锁将自动“释放”,并且可以再次获取.它可以防止死锁.
不要使用长时间的超时,这可能会引发 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.

Product

.NET

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net6.0
- MongoDB.Driver (>= 2.22.0)
net7.0
- MongoDB.Driver (>= 2.22.0)
net8.0
- MongoDB.Driver (>= 2.22.0)

NuGet packages (1)

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

Package	Downloads
EasilyNET.MongoDistributedLock.AspNetCore MongoDB分布式锁方案	18.3K

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

EasilyNET.MongoDistributedLock 1.9.0-preview1

EasilyNET.MongoDistributedLock

使用方法

net6.0

net7.0

net8.0

NuGet packages (1)

GitHub repositories