Xid (com.github.fangjinuo.langx:langx-java:4.7.2 4.7.2 API)

java.lang.Object
- com.jn.langx.util.id.Xid

所有已实现的接口:

Comparable<Xid>
```
public final class Xid
extends Object
implements Comparable<Xid>
```
A globally unique identifier for objects.

Consists of 12 bytes, divided as follows:

layout
0 1 2 3 4 5 6 7 8 9 10 11

time random value inc

Instances of this class are immutable.

从以下版本开始:

4.4.6

layout
0	1	2	3	4	5	6	7	8	9	10	11
time	random value	inc

构造器概要

构造器
构造器和说明
`Xid()` Create a new object id.
`Xid(byte[] bytes)` Constructs a new instance from the given byte array
`Xid(ByteBuffer buffer)` Constructs a new instance from the given ByteBuffer
`Xid(Date date)` Constructs a new instance using the given date.
`Xid(Date date, int counter)` Constructs a new instances using the given date and counter.
`Xid(int timestamp, int counter)` Creates an Xid using the given time, machine identifier, process identifier, and counter.
`Xid(String hexString)` Constructs a new instance from a 24-byte hexadecimal string representation.

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`static byte[]`	`bytes()`
`int`	`compareTo(Xid other)`
`boolean`	`equals(Object o)`
`static Xid`	`get()` Gets a new object id.
`Date`	`getDate()` Gets the timestamp as a `Date` instance.
`static Xid`	`getSmallestWithDate(Date date)` Gets a new object id with the given date value and all other bits zeroed.
`int`	`getTimestamp()` Gets the timestamp (number of seconds since the Unix epoch).
`int`	`hashCode()`
`static void`	`isTrue(String name, boolean condition)`
`static boolean`	`isValid(String hexString)` Checks if a string could be an `Xid`.
`void`	`putToByteBuffer(ByteBuffer buffer)` Convert to bytes and put those bytes to the provided ByteBuffer.
`static String`	`string()`
`byte[]`	`toByteArray()` Convert to a byte array.
`String`	`toHexString()` Converts this instance into a 20-byte hexadecimal string representation.
`String`	`toString()`

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

- 构造器详细资料
  - Xid
```
public Xid()
```
    Create a new object id.
  - Xid
```
public Xid(Date date)
```
    Constructs a new instance using the given date.
    
    参数:
    
    date - the date
  - Xid
```
public Xid(Date date,
           int counter)
```
    Constructs a new instances using the given date and counter.
    
    参数:
    
    date - the date
    
    counter - the counter
    
    抛出:
    
    IllegalArgumentException - if the high order byte of counter is not zero
  - Xid
```
public Xid(int timestamp,
           int counter)
```
    Creates an Xid using the given time, machine identifier, process identifier, and counter.
    
    参数:
    
    timestamp - the time in seconds
    
    counter - the counter
    
    抛出:
    
    IllegalArgumentException - if the high order byte of counter is not zero
  - Xid
```
public Xid(String hexString)
```
    Constructs a new instance from a 24-byte hexadecimal string representation.
    
    参数:
    
    hexString - the string to convert
    
    抛出:
    
    IllegalArgumentException - if the string is not a valid hex string representation of an Xid
  - Xid
```
public Xid(byte[] bytes)
```
    Constructs a new instance from the given byte array
    
    参数:
    
    bytes - the byte array
    
    抛出:
    
    IllegalArgumentException - if array is null or not of length 12
  - Xid
```
public Xid(ByteBuffer buffer)
```
    Constructs a new instance from the given ByteBuffer
    
    参数:
    
    buffer - the ByteBuffer
    
    抛出:
    
    IllegalArgumentException - if the buffer is null or does not have at least 12 bytes remaining
- 方法详细资料
  - get
```
public static Xid get()
```
    Gets a new object id.
    
    返回:
    
    the new id
  - string
```
public static String string()
```
  - bytes
```
public static byte[] bytes()
```
  - getSmallestWithDate
```
public static Xid getSmallestWithDate(Date date)
```
    Gets a new object id with the given date value and all other bits zeroed.
    The returned object id will compare as less than or equal to any other object id within the same second as the given date, and less than any later date.
    
    参数:
    
    date - the date
    
    返回:
    
    the Xid
  - toByteArray
```
public byte[] toByteArray()
```
    Convert to a byte array. Note that the numbers are stored in big-endian order.
    
    返回:
    
    the byte array
  - putToByteBuffer
```
public void putToByteBuffer(ByteBuffer buffer)
```
    Convert to bytes and put those bytes to the provided ByteBuffer. Note that the numbers are stored in big-endian order.
    
    参数:
    
    buffer - the ByteBuffer
    
    抛出:
    
    IllegalArgumentException - if the buffer is null or does not have at least 12 bytes remaining
  - getTimestamp
```
public int getTimestamp()
```
    Gets the timestamp (number of seconds since the Unix epoch).
    
    返回:
    
    the timestamp
  - getDate
```
public Date getDate()
```
    Gets the timestamp as a Date instance.
    
    返回:
    
    the Date
  - toHexString
```
public String toHexString()
```
    Converts this instance into a 20-byte hexadecimal string representation.
    
    返回:
    
    a string representation of the Xid in hexadecimal format
  - equals
```
public boolean equals(Object o)
```
    覆盖:
    
    equals 在类中 Object
  - hashCode
```
public int hashCode()
```
    覆盖:
    
    hashCode 在类中 Object
  - compareTo
```
public int compareTo(Xid other)
```
    指定者:
    
    compareTo 在接口中 Comparable<Xid>
  - toString
```
public String toString()
```
    覆盖:
    
    toString 在类中 Object
  - isValid
```
public static boolean isValid(String hexString)
```
    Checks if a string could be an Xid.
    
    参数:
    
    hexString - a potential Xid as a String.
    
    返回:
    
    whether the string could be an object id
    
    抛出:
    
    IllegalArgumentException - if hexString is null
  - isTrue
```
public static void isTrue(String name,
                          boolean condition)
```

类 Xid

构造器概要

方法概要

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

构造器详细资料

Xid

Xid

Xid

Xid

Xid

Xid

Xid

方法详细资料

get

string

bytes

getSmallestWithDate

toByteArray

putToByteBuffer

getTimestamp

getDate

toHexString

equals

hashCode

compareTo

toString

isValid

isTrue