Ulid (dart-boot-common 1.0.0 API)

java.lang.Object
- im.dart.boot.common.extend.Ulid

所有已实现的接口:

Serializable, Comparable<Ulid>
```
public final class Ulid
extends Object
implements Serializable, Comparable<Ulid>
```
A class that represents ULIDs.
ULID is a 128-bit value that has two components:
- Time component: a number of milliseconds since 1970-01-01 (Unix epoch).
- Random component: a sequence of 80 random bits generated by a secure random generator.
ULID has 128-bit compatibility with UUID. Like a UUID, a ULID can also be stored as a 16-byte array.
Instances of this class are immutable.
另请参阅:

ULID Specification, 序列化表格

字段概要

字段
限定符和类型	字段和说明
`static int`	`RANDOM_BYTES` Number of bytes of the random component of a ULID.
`static int`	`RANDOM_CHARS` Number of characters of the random component of a ULID.
`static int`	`TIME_BYTES` Number of bytes of the time component of a ULID.
`static int`	`TIME_CHARS` Number of characters of the time component of a ULID.
`static int`	`ULID_BYTES` Number of bytes of a ULID.
`static int`	`ULID_CHARS` Number of characters of a ULID.

构造器概要

构造器
构造器和说明
`Ulid(long time, byte[] random)` Creates a new ULID.
`Ulid(long mostSignificantBits, long leastSignificantBits)` Creates a new ULID.
`Ulid(Ulid ulid)` Creates a new ULID.

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`int`	`compareTo(Ulid that)` Compares two ULIDs as unsigned 128-bit integers.
`boolean`	`equals(Object other)` Checks if some other ULID is equal to this one.
`static Ulid`	`fast()` Returns a fast new ULID.
`static Ulid`	`from(byte[] bytes)` Converts a byte array into a ULID.
`static Ulid`	`from(String string)` Converts a canonical string into a ULID.
`static Ulid`	`from(UUID uuid)` Converts a UUID into a ULID.
`Instant`	`getInstant()` Returns the instant of creation.
`static Instant`	`getInstant(String string)` Returns the instant of creation.
`long`	`getLeastSignificantBits()` Returns the least significant bits as a number.
`long`	`getMostSignificantBits()` Returns the most significant bits as a number.
`byte[]`	`getRandom()` Returns the random component as a byte array.
`static byte[]`	`getRandom(String string)` Returns the random component as a byte array.
`long`	`getTime()` Returns the time component as a number.
`static long`	`getTime(String string)` Returns the time component as a number.
`int`	`hashCode()` Returns a hash code value for the ULID.
`Ulid`	`increment()` Returns a new ULID by incrementing the random component of the current ULID.
`static boolean`	`isValid(String string)` Checks if the input string is valid.
`byte[]`	`toBytes()` Convert the ULID into a byte array.
`String`	`toLowerCase()` Converts the ULID into a canonical string in lower case.
`Ulid`	`toRfc4122()` Converts the ULID into into another ULID that is compatible with UUIDv4.
`String`	`toString()` Converts the ULID into a canonical string in upper case.
`UUID`	`toUuid()` Convert the ULID into a UUID.

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

- 字段详细资料
  - ULID_CHARS
```
public static final int ULID_CHARS
```
    Number of characters of a ULID.
    
    另请参阅:
    
    常量字段值
  - TIME_CHARS
```
public static final int TIME_CHARS
```
    Number of characters of the time component of a ULID.
    
    另请参阅:
    
    常量字段值
  - RANDOM_CHARS
```
public static final int RANDOM_CHARS
```
    Number of characters of the random component of a ULID.
    
    另请参阅:
    
    常量字段值
  - ULID_BYTES
```
public static final int ULID_BYTES
```
    Number of bytes of a ULID.
    
    另请参阅:
    
    常量字段值
  - TIME_BYTES
```
public static final int TIME_BYTES
```
    Number of bytes of the time component of a ULID.
    
    另请参阅:
    
    常量字段值
  - RANDOM_BYTES
```
public static final int RANDOM_BYTES
```
    Number of bytes of the random component of a ULID.
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - Ulid
```
public Ulid(Ulid ulid)
```
    Creates a new ULID.
    Useful to make copies of ULIDs.
    
    参数:
    
    ulid - a ULID
  - Ulid
```
public Ulid(long mostSignificantBits,
            long leastSignificantBits)
```
    Creates a new ULID.
    If you want to make a copy of a UUID, use from(UUID) instead.
    
    参数:
    
    mostSignificantBits - the first 8 bytes as a long value
    
    leastSignificantBits - the last 8 bytes as a long value
  - Ulid
```
public Ulid(long time,
            byte[] random)
```
    Creates a new ULID.
    Time parameter is the number of milliseconds since 1970-01-01 (Unix epoch). It must be a positive number not larger than 2^48-1.
    Random parameter must be an array of 10 bytes.
    
    参数:
    
    time - the the number of milliseconds since 1970-01-01
    
    random - an array of 10 bytes
    
    抛出:
    
    IllegalArgumentException - if time is negative or larger than 2^48-1
    
    IllegalArgumentException - if random is null or its length is not 10
- 方法详细资料
  - fast
```
public static Ulid fast()
```
    Returns a fast new ULID.
    
    返回:
    
    a ULID
    
    从以下版本开始:
    
    5.1.0
    
    另请参阅:
    
    SplittableRandom}
  - from
```
public static Ulid from(UUID uuid)
```
    Converts a UUID into a ULID.
    
    参数:
    
    uuid - a UUID
    
    返回:
    
    a ULID
  - from
```
public static Ulid from(byte[] bytes)
```
    Converts a byte array into a ULID.
    
    参数:
    
    bytes - an array of 16 bytes
    
    返回:
    
    a ULID
    
    抛出:
    
    IllegalArgumentException - if bytes are null or its length is not 16
  - from
```
public static Ulid from(String string)
```
    Converts a canonical string into a ULID.
    The input string must be 26 characters long and must contain only characters from Crockford's base 32 alphabet.
    The first character of the input string must be between 0 and 7.
    
    参数:
    
    string - a canonical string
    
    返回:
    
    a ULID
    
    抛出:
    
    IllegalArgumentException - if the input string is invalid
    
    另请参阅:
    
    Crockford's Base 32
  - toUuid
```
public UUID toUuid()
```
    Convert the ULID into a UUID.
    A ULID has 128-bit compatibility with a UUID.
    If you need a RFC-4122 UUIDv4 do this: Ulid.toRfc4122().toUuid().
    
    返回:
    
    a UUID.
  - toBytes
```
public byte[] toBytes()
```
    Convert the ULID into a byte array.
    
    返回:
    
    an byte array.
  - toString
```
public String toString()
```
    Converts the ULID into a canonical string in upper case.
    The output string is 26 characters long and contains only characters from Crockford's Base 32 alphabet.
    For lower case string, use the shorthand Ulid#toLowerCase(), instead of Ulid#toString()#toLowerCase().
    
    覆盖:
    
    toString 在类中 Object
    
    返回:
    
    a ULID string
    
    另请参阅:
    
    Crockford's Base 32
  - toLowerCase
```
public String toLowerCase()
```
    Converts the ULID into a canonical string in lower case.
    The output string is 26 characters long and contains only characters from Crockford's Base 32 alphabet.
    It is a shorthand at least twice as fast as Ulid.toString().toLowerCase().
    
    返回:
    
    a string
    
    另请参阅:
    
    Crockford's Base 32
  - toRfc4122
```
public Ulid toRfc4122()
```
    Converts the ULID into into another ULID that is compatible with UUIDv4.
    The bytes of the returned ULID are compliant with the RFC-4122 version 4.
    If you need a RFC-4122 UUIDv4 do this: Ulid.toRfc4122().toUuid().
    Note: If you use this method, you can not get the original ULID, since it changes 6 bits of it to generate a UUIDv4.
    
    返回:
    
    a ULID
    
    另请参阅:
    
    RFC-4122
  - getInstant
```
public Instant getInstant()
```
    Returns the instant of creation.
    The instant of creation is extracted from the time component.
    
    返回:
    
    the Instant of creation
  - getInstant
```
public static Instant getInstant(String string)
```
    Returns the instant of creation.
    The instant of creation is extracted from the time component.
    
    参数:
    
    string - a canonical string
    
    返回:
    
    the Instant of creation
    
    抛出:
    
    IllegalArgumentException - if the input string is invalid
  - getTime
```
public long getTime()
```
    Returns the time component as a number.
    The time component is a number between 0 and 2^48-1. It is equivalent to the count of milliseconds since 1970-01-01 (Unix epoch).
    
    返回:
    
    a number of milliseconds
  - getTime
```
public static long getTime(String string)
```
    Returns the time component as a number.
    The time component is a number between 0 and 2^48-1. It is equivalent to the count of milliseconds since 1970-01-01 (Unix epoch).
    
    参数:
    
    string - a canonical string
    
    返回:
    
    a number of milliseconds
    
    抛出:
    
    IllegalArgumentException - if the input string is invalid
  - getRandom
```
public byte[] getRandom()
```
    Returns the random component as a byte array.
    The random component is an array of 10 bytes (80 bits).
    
    返回:
    
    a byte array
  - getRandom
```
public static byte[] getRandom(String string)
```
    Returns the random component as a byte array.
    The random component is an array of 10 bytes (80 bits).
    
    参数:
    
    string - a canonical string
    
    返回:
    
    a byte array
    
    抛出:
    
    IllegalArgumentException - if the input string is invalid
  - getMostSignificantBits
```
public long getMostSignificantBits()
```
    Returns the most significant bits as a number.
    
    返回:
    
    a number.
  - getLeastSignificantBits
```
public long getLeastSignificantBits()
```
    Returns the least significant bits as a number.
    
    返回:
    
    a number.
  - increment
```
public Ulid increment()
```
    Returns a new ULID by incrementing the random component of the current ULID.
    Since the random component contains 80 bits:
    - (1) This method can generate up to 1208925819614629174706176 (2^80) ULIDs per millisecond;
    - (2) This method can generate monotonic increasing ULIDs 99.999999999999992% ((2^80 - 10^9) / (2^80)) of the time within a single millisecond interval, considering an unrealistic rate of 1,000,000,000 ULIDs per millisecond.
    Due to (1) and (2), it does not throw the error message recommended by the specification. When an overflow occurs in the random 80 bits, the time component is simply incremented to maintain monotonicity.
    返回:
    
    a ULID
  - isValid
```
public static boolean isValid(String string)
```
    Checks if the input string is valid.
    The input string must be 26 characters long and must contain only characters from Crockford's base 32 alphabet.
    The first character of the input string must be between 0 and 7.
    
    参数:
    
    string - a canonical string
    
    返回:
    
    true if the input string is valid
    
    另请参阅:
    
    Crockford's Base 32
  - hashCode
```
public int hashCode()
```
    Returns a hash code value for the ULID.
    
    覆盖:
    
    hashCode 在类中 Object
  - equals
```
public boolean equals(Object other)
```
    Checks if some other ULID is equal to this one.
    
    覆盖:
    
    equals 在类中 Object
  - compareTo
```
public int compareTo(Ulid that)
```
    Compares two ULIDs as unsigned 128-bit integers.
    The first of two ULIDs is greater than the second if the most significant byte in which they differ is greater for the first ULID.
    
    指定者:
    
    compareTo 在接口中 Comparable<Ulid>
    
    参数:
    
    that - a ULID to be compared with
    
    返回:
    
    -1, 0 or 1 as this is less than, equal to, or greater than that

类 Ulid

字段概要

构造器概要

方法概要

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

字段详细资料

ULID_CHARS

TIME_CHARS

RANDOM_CHARS

ULID_BYTES

TIME_BYTES

RANDOM_BYTES

构造器详细资料

Ulid

Ulid

Ulid

方法详细资料

fast

from

from

from

toUuid

toBytes

toString

toLowerCase

toRfc4122

getInstant

getInstant

getTime

getTime

getRandom

getRandom

getMostSignificantBits

getLeastSignificantBits

increment

isValid

hashCode

equals

compareTo