Beizsoft.IdProvision
1.0.0-rc1
dotnet add package Beizsoft.IdProvision --version 1.0.0-rc1
NuGet\Install-Package Beizsoft.IdProvision -Version 1.0.0-rc1
<PackageReference Include="Beizsoft.IdProvision" Version="1.0.0-rc1" />
paket add Beizsoft.IdProvision --version 1.0.0-rc1
#r "nuget: Beizsoft.IdProvision, 1.0.0-rc1"
// Install Beizsoft.IdProvision as a Cake Addin
#addin nuget:?package=Beizsoft.IdProvision&version=1.0.0-rc1&prerelease
// Install Beizsoft.IdProvision as a Cake Tool
#tool nuget:?package=Beizsoft.IdProvision&version=1.0.0-rc1&prerelease
Beizsoft.IdProvision
A library used for ID provision.
The IIdProvider<T>
interface provides a T Claimid()
method, which can be called to claim a one-use ID. The built-in ID types are: Guid
, int
, uint
, long
and ulong
.
The GuidIdProvider
simply returns a Guid.NewGuid()
, while the integer ID providers return an incrementing ID starting at zero.
Please note, the integer ID providers do not check for overflow; you should consider how many IDs you are likely to ever claim in the worst-case scenario, and pick the long
or ulong
ID provider if in any doubt; the int
and uint
providers should only really be used as a memory footpring optimization when you are certain you will not overflow the IDs.
The integer ID providers each expose a Synchronous
, Locked
and Interlocked
variant. For example, the type names for the uint
ID providers are:
SynchronousUnsignedIntegerIdProvider
InterlockedUnsignedIntegerIdProvider
LockedUnsignedIntegerIdProvider
The Synchronous
ID providers are not thread-safe, while the Locked
variants lock on an internal object monitor, and the Interlocked
variants use Interlocked.Increment(ref nextId) - 1
.
The library also provides an IFreeableIdProvider<T>
interface and six wrapper implementations. IFreeableIdProvider<T>
implements IIdProvider<T>
, but also provides a void Free(T id)
method.
This method is called to mark an already-claimed ID as free to use again, and the next call to ClaimId
will return that ID instead.
There are stack-based implementations, and queue-based implementations, each providing a Synchronous
, Locked
and Concurrent
variant.
Each implementation is constructed with an IIdProvider<T>
, and first checks whether there are any waiting freed IDs, and, if none are available, returns IIdProvider<T>.ClaimId()
instead.
The available wrappers are:
SynchronousFreeableIdProviderQueueWrapper
SynchronousFreeableIdProviderStackWrapper
ConcurrentFreeableIdProviderQueueWrapper
ConcurrentFreeableIdProviderStackWrapper
LockedFreeableIdProviderQueueWrapper
LockedFreeableIdProviderStackWrapper
The Concurrent
variants use the System.Collections.Concurrent
implementations of their underlying storage mechanism, and the Locked
variants lock on their underlying Queue
or Stack
.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 is compatible. net5.0-windows was computed. 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 was computed. 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 was computed. 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. |
.NET Core | netcoreapp1.0 was computed. netcoreapp1.1 was computed. netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard1.1 is compatible. netstandard1.2 is compatible. netstandard1.3 is compatible. netstandard1.4 is compatible. netstandard1.5 is compatible. netstandard1.6 is compatible. netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net45 was computed. net451 was computed. net452 was computed. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen30 was computed. tizen40 was computed. tizen60 was computed. |
Universal Windows Platform | uap was computed. uap10.0 was computed. |
Windows Phone | wpa81 was computed. |
Windows Store | netcore was computed. netcore45 was computed. netcore451 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 1.1
- NETStandard.Library (>= 1.6.1)
-
.NETStandard 1.2
- NETStandard.Library (>= 1.6.1)
-
.NETStandard 1.3
- NETStandard.Library (>= 1.6.1)
-
.NETStandard 1.4
- NETStandard.Library (>= 1.6.1)
-
.NETStandard 1.5
- NETStandard.Library (>= 1.6.1)
-
.NETStandard 1.6
- NETStandard.Library (>= 1.6.1)
-
.NETStandard 2.0
- No dependencies.
-
.NETStandard 2.1
- No dependencies.
-
net5.0
- No dependencies.
-
net6.0
- No dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|