IdGen v3.0.0 Release Notes

Release Date: 2020-07-06 // almost 4 years ago
  • ๐Ÿš€ This release contains a few (minor) breaking changes. Generated 2.x ID's are still compatible with 3.x ID's.

    • Most of the constructor overloads for the IdGenerator have been replaced with a single constructor which accepts IdGeneratorOptions that contains the ITimeSource, IdStructure and SequenceOverflowStrategy.
    • The MaskConfig class is now more appropriately named IdStructure since it describes the structure of the generated ID's.
    • ๐Ÿšš The UseSpinWait property has moved to the IdGeneratorOptions and is now an enum of type SequenceOverflowStrategy instead of a boolean value. Note that this property has also been renamed in the config file (from useSpinWait to sequenceOverflowStrategy) and is no longer a boolean but requires one of the values from SequenceOverflowStrategy.
    • ID is now Id (only used as return value by the FromId(...) method)

Previous changes from v2.4.1

  • ๐Ÿ”ง The IdGenerator now offers a spinwaiting strategy when a sequenceoverflow occurs instead of throwing a SequenceOverflowException. This will spinwait until the next tick and then return a new Id. New constructoroverloads have been added to be able to set this property at construction time. Also the configuration package supports this new option with a useSpinWait attribute on the idGenerator element.