yujinqiu / goSnowFlake

一个实现 Twitter SnowFlake 算法 的 Go 分布式 UID 生成器.A ThreadSafe Unique ID Generator written by Golang according to Twitter's snowflake theory

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

goSnowFlake

Build Status GoDoc

According to the Twitter SnowFlake Theory, A ThreadSafe Unique ID Generator written by Golang

根据 Twitter SnowFlake 算法, 实现的分布式线程安全 UID 生成器

goSnowFlake

Feature

  • ThreadSafe unique id generator
  • Green pluggable, without external storage like Redis or MySQL
  • Suitable for distributed systems
  • Implement Twitter's SnowFlake theory

Description

0               41	           51			64
+---------------+----------------+-----------+
|timestamp(ms)  | worker node id | sequence	 |
+---------------+----------------+-----------+

id  = timestamp | workerid | sequence (eg. 1451063443347648410)

An id is composed by three part: timestamp in millon second, worker id, and sequence. Sequence is zero default. when timestamp is the same, we use sequence to avoid conflict

Installation

go get github.com/zheng-ji/goSnowFlake

Example

import (
	"fmt"
	"github.com/zheng-ji/goSnowFlake"
)

func main() {
    // Params: Given the workerId, 0 < workerId < 1024
	iw, err := goSnowFlake.NewIdWorker(1) 
	if err!= nil {
		fmt.Println(err)
	}
	for i := 0; i < 100; i++ {
		if id, err := iw.NextId(); err != nill {
			fmt.Println(id)
        }
	}
}

Documentation

License

Copyright (c) 2015 by zheng-ji released under MIT License.

About

一个实现 Twitter SnowFlake 算法 的 Go 分布式 UID 生成器.A ThreadSafe Unique ID Generator written by Golang according to Twitter's snowflake theory


Languages

Language:Go 100.0%