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.

#:package EasilyNET.MongoDistributedLock@1.9.0-preview1

#: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=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分布式锁方案	19.1K

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
3.24.1113.100	149	11/13/2024
3.24.1112.125	123	11/12/2024
3.24.1107.140	119	11/7/2024
3.24.1107.54	127	11/7/2024
3.24.1107.34	133	11/7/2024
3.24.1105.111	129	11/5/2024
3.24.1103.31	137	11/2/2024
3.24.1103	131	11/2/2024
3.24.1031.135	123	10/31/2024
3.24.1031.112	129	10/31/2024
3.24.1031.104	127	10/31/2024
3.24.1029.142	120	10/29/2024
3.24.1025.30	134	10/24/2024
3.24.1022.142	119	10/22/2024
3.24.1018.204	182	10/18/2024
3.24.1018.175	178	10/18/2024
3.24.1018.166	165	10/18/2024
3.24.1018.93	174	10/18/2024
3.24.1017.42	127	10/16/2024
3.24.1016.161	124	10/16/2024
3.24.1015.231	119	10/15/2024
3.24.1015.14	131	10/14/2024
3.24.1012.114	126	10/12/2024
3.24.1009.115	129	10/9/2024
3.24.1008.160	117	10/8/2024
3.24.1008.133	129	10/8/2024
3.24.1007.185	123	10/7/2024
3.24.1003.33	129	10/2/2024
3.24.1002.162	135	10/2/2024
3.24.929.143	131	9/29/2024
3.24.929.141	128	9/29/2024
3.24.929.131	126	9/29/2024
3.24.929.122	117	9/29/2024
3.24.926.184	135	9/26/2024
3.24.926.182	128	9/26/2024
3.24.926.175	134	9/26/2024
3.24.924.160	121	9/24/2024
3.24.924.133	130	9/24/2024
3.24.924.124	120	9/24/2024
3.24.924.10	133	9/23/2024
3.24.924.1	124	9/23/2024
3.24.923.234	118	9/23/2024
3.24.923.232	126	9/23/2024
3.24.923.155	129	9/23/2024
3.24.919.92	124	9/19/2024
3.24.914.125	151	9/14/2024
3.24.914.115	140	9/14/2024
3.24.914.111	152	9/14/2024
3.24.911.95	145	9/11/2024
3.24.908.215	130	9/8/2024
3.24.904.200	139	9/4/2024
3.24.828.163	163	8/28/2024
3.24.820.173	156	8/20/2024
3.24.814.92	159	8/14/2024
3.24.812.115	155	8/12/2024
3.24.802.100	122	8/2/2024
3.24.801.162	140	8/1/2024
3.24.801.160	130	8/1/2024
3.24.801.155	126	8/1/2024
3.24.730.164	96	7/30/2024
3.24.730.91	101	7/30/2024
3.24.724.91	120	7/24/2024
3.24.718.105	150	7/18/2024
3.24.716.95	130	7/16/2024
3.24.712.94	133	7/12/2024
3.24.710.14	150	7/9/2024
3.24.709.105	133	7/9/2024
3.24.704.94	156	7/4/2024
3.24.701.90	144	7/1/2024
3.24.628.114	150	6/28/2024
3.24.627.145	132	6/27/2024
3.24.620.160	141	6/20/2024
3.24.613.115	130	6/13/2024
3.24.612.95	134	6/12/2024
3.24.528.90	139	5/28/2024
3.24.522.84	141	5/22/2024
3.24.512.213	133	5/12/2024
3.24.508.112	156	5/8/2024
2.2024.428.71	156	4/28/2024
2.2024.427.1128	156	4/27/2024
2.2.72	150	4/14/2024
2.2.71	140	4/12/2024
2.2.8	138	4/26/2024
2.2.6	146	4/10/2024
2.2.5	136	3/26/2024
2.2.4	144	3/25/2024
2.2.3	139	3/24/2024
2.2.2	164	3/21/2024
2.2.1	173	3/20/2024
2.2.0	165	3/13/2024
2.1.9	164	2/21/2024
2.1.8	141	2/18/2024
2.1.7	167	2/16/2024
2.1.6	146	2/14/2024
2.1.5	147	2/14/2024
2.1.4	175	2/9/2024
2.1.3	171	2/8/2024
2.1.2	154	2/5/2024
2.1.1.2	222	12/26/2023
2.1.1.1	164	12/26/2023
2.1.1	164	12/25/2023
2.1.0	180	12/17/2023
2.0.11	170	12/6/2023
2.0.1	200	11/15/2023
2.0.0	184	11/14/2023
1.9.1	172	11/1/2023
1.9.0	164	10/19/2023
1.9.0-preview2	134	10/12/2023
1.9.0-preview1	152	10/12/2023
1.8.9	175	10/11/2023
1.8.8	185	10/11/2023
1.8.7-rc2	126	9/21/2023
1.8.7-rc1	139	9/12/2023
1.8.6	196	8/31/2023
1.8.5	185	8/25/2023
1.8.4	181	8/24/2023
1.8.3	213	8/23/2023
1.8.2	190	8/22/2023
1.8.1	182	8/18/2023
1.8.0	203	8/15/2023
1.7.9	202	8/11/2023
1.7.8	206	8/11/2023
1.7.7	209	8/10/2023
1.7.6	192	8/9/2023
1.7.5	206	8/9/2023
1.7.4	210	8/3/2023
1.7.3	212	8/1/2023
1.7.2	209	7/31/2023
1.7.1	200	7/27/2023
1.7.0	218	7/27/2023

EasilyNET.MongoDistributedLock 1.9.0-preview1

EasilyNET.MongoDistributedLock

使用方法

net6.0

net7.0

net8.0

NuGet packages (1)

GitHub repositories