IdGenerator

A powerful unique id generator.

Inspired by yitter/IdGenerator. Please see it for original documentation on the option choice.

Shorter ID and faster generation with a new snowflake drift algorithm. The core is to shorten the ID length, but also can have a very high instantaneous concurrent processing capacity (50W/0.1s), and powerful configuration capacity.

If you want to have such a high throughput, please set a higher seq_bit_len (e.g. 10).

Also support for multiple worker_id in one instance, using HashMap or Vector. More usage examples please see tests in lib.rs or docs on docs.rs

DO NOT USE A MIXTURE OF THEM!

Simple Usage example

First, global initialize:

use idgenerator::{IdHelper, IdGeneratorOptions};
// Create a instance
IdHelper::init();
// Create IdGeneratorOptions, worker_id is the only parameter needed：
let mut options = IdGeneratorOptions::new(1);
// If you want to have a larger work_id range, set worker_id_bit_len to a larger number
options.worker_id_bit_len = 8; // default to 8, meaning the max number of work_id is 2^8 - 1
// Other options can be seen in IdGeneratorOptions

// You must save parameters before generating
IdHelper::set_id_generator(options);

Second, generate ID:

use idgenerator::IdHelper;
// call next_id() at where you want to generate the ID
let new_id: i64 = IdHelper::next_id();
println!("ID: {}", new_id);

More usage examples please see docs on docs.rs or mod.rs. Also can see the tests in lib.rs

Credits

• yitter/IdGenerator