snowflakepro

snowflakepro is a plus version with 128 bits

Getting Started

Installing

This assumes you already have a working Go environment, if not please see this page first.

go get github.com/xsean2020/snowflakepro-go 

Usage

Import the package into your project then construct a new snowflake Node using a unique node number and a random number in [0, 2^40-1]. With the object call the Next() method to generate and return a unique snowflake ID.

Example Program:

	var s, _ = NewSnowflakePro(100, uint64(rand.Int63n(int64(MaxNonce))))
	id := s.Next()
	if id.Time() != s.tms {
		log.Fatal("time error")
	}

	if id.Nonce() != s.nonce {
		log.Fatal("nonce error", id.Nonce(), s.nonce)
	}

	if id.Node() != s.node {
		log.Fatal("node error")
	}

	if id.SN() != s.sn {
		log.Fatal("sn error")
	}

Specification

Below is the current specification of SPID as implemented in this repository.

0                   1                   2                   3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                      32_bit_uint_time_high                    |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|     16_bit_uint_time_low      |       16_bit_uint_node_id     |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                       32_bit_uint_random                      |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|     8_bit_uint_random |          24_bit_uint_sn               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

Components

Timestamp

• 48 bits
• UNIX-time in milliseconds
• Won't run out of space till the year 10889 AD

NodeID

• 16 bits
• User defined nodeid .

Nonce

• 40 bits
• User defined a nonce number for avoid confict.

SequenceNumber

• 24 bits
• Sequence number in milliseconds.