Sequence (libby-http-cache-control 2022.1.5 API)

java.lang.Object
- plus.wcj.libby.http.cache.control.sequence.Sequence

```
public class Sequence
extends Object
```
Sequence. copy https://gitee.com/yu120/sequence/
基于Twitter的Snowflake算法实现分布式高效有序ID生产黑科技(sequence)——升级版Snowflake
SnowFlake的结构如下(每部分用-分开):

0 - 0000000000 0000000000 0000000000 0000000000 0 - 00000 - 00000 - 000000000000

1位标识，由于long基本类型在Java中是带符号的，最高位是符号位，正数是0，负数是1，所以id一般是正数，最高位是0

41位时间截(毫秒级)，注意，41位时间截不是存储当前时间的时间截，而是存储时间截的差值（当前时间截 - 开始时间截) 得到的值），这里的的开始时间截，一般是我们的id生成器开始使用的时间，由我们程序来指定的（如下START_TIME属性）。41位的时间截，可以使用69年，年T = (1L << 41) / (1000L * 60 * 60 * 24 * 365) = 69

10位的数据机器位，可以部署在1024个节点，包括5位dataCenterId和5位workerId

12位序列，毫秒内的计数，12位的计数顺序号支持每个节点每毫秒(同一机器，同一时间截)产生4096个ID序号

加起来刚好64位，为一个Long型。
SnowFlake的优点是，整体上按照时间自增排序，并且整个分布式系统内不会产生ID碰撞(由数据中心ID和机器ID作区分)，并且效率较高，经测试，SnowFlake每秒能够产生26万ID左右。

特性： 1.支持自定义允许时间回拨的范围
2.解决跨毫秒起始值每次为0开始的情况（避免末尾必定为偶数，而不便于取余使用问题）
3.解决高并发场景中获取时间戳性能问题
4.支撑根据IP末尾数据作为workerId 5.时间回拨方案思考：1024个节点中分配10个点作为时间回拨序号（连续10次时间回拨的概率较小）
常见问题: 1.时间回拨问题 2.机器id的分配和回收问题 3.机器id的上限问题

版本:

3.0

作者:

lry

字段概要

字段
限定符和类型字段和说明

protected long maxDatacenterId

protected long maxWorkerId

字段
限定符和类型	字段和说明
`protected long`	`maxDatacenterId`
`protected long`	`maxWorkerId`

构造器概要

构造器
构造器和说明

Sequence()

Sequence(long workerId, long datacenterId)
有参构造器

构造器
构造器和说明
`Sequence()`
`Sequence(long workerId, long datacenterId)` 有参构造器

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`protected long`	`getDatacenterId()` 基于网卡MAC地址计算余数作为数据中心可自定扩展
`static InetAddress`	`getLocalAddress()` Find first valid IP from local network card
`protected long`	`getMaxWorkerId(long datacenterId)` 基于 MAC + PID 的 hashcode 获取16个低位可自定扩展
`long`	`nextId()` 获取下一个 ID
`protected long`	`tilNextMillis(long lastTimestamp)`
`protected long`	`timeGen()`

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - maxDatacenterId
```
protected final long maxDatacenterId
```
    另请参阅:
    
    常量字段值
  - maxWorkerId
```
protected final long maxWorkerId
```
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - Sequence
```
public Sequence()
```
  - Sequence
```
public Sequence(long workerId,
                long datacenterId)
```
    有参构造器
    
    参数:
    
    workerId - 工作机器 ID
    
    datacenterId - 序列号
- 方法详细资料
  - getDatacenterId
```
protected long getDatacenterId()
```
    基于网卡MAC地址计算余数作为数据中心
    可自定扩展
  - getMaxWorkerId
```
protected long getMaxWorkerId(long datacenterId)
```
    基于 MAC + PID 的 hashcode 获取16个低位
    可自定扩展
  - nextId
```
public long nextId()
```
    获取下一个 ID
    
    返回:
    
    next id
  - tilNextMillis
```
protected long tilNextMillis(long lastTimestamp)
```
  - timeGen
```
protected long timeGen()
```
  - getLocalAddress
```
public static InetAddress getLocalAddress()
```
    Find first valid IP from local network card
    
    返回:
    
    first valid local IP

类 Sequence

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

maxDatacenterId

maxWorkerId

构造器详细资料

Sequence

Sequence

方法详细资料

getDatacenterId

getMaxWorkerId

nextId

tilNextMillis

timeGen

getLocalAddress