| |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | ||||||||
java.util
类 UUID
java.lang.Objectjava.util.UUID
- 所有已实现的接口：
- Serializable, Comparable<UUID>
public final class UUID
- extends Object
- implements Serializable, Comparable<UUID>
表示通用惟一标识符 (UUID) 的类。 UUID 表示一个 128 位的值。
这些全局标识符具有不同的变体。此类的方法用于操作 Leach-Salz 变体，不过构造方法允许创建任何 UUID 变体（将在下面进行描述）。
变体 2 (Leach-Salz) UUID 的布局如下： long 型数据的最高有效位由以下无符号字段组成：
0xFFFFFFFF00000000 time_low 0x00000000FFFF0000 time_mid 0x000000000000F000 version 0x0000000000000FFF time_hilong 型数据的最低有效位由以下无符号字段组成：
0xC000000000000000 variant 0x3FFF000000000000 clock_seq 0x0000FFFFFFFFFFFF node
variant 字段包含一个表示 UUID 布局的值。以上描述的位布局仅在 UUID 的 variant 值为 2（表示 Leach-Salz 变体）时才有效。
version 字段保存描述此 UUID 类型的值。有 4 种不同的基本 UUID 类型：基于时间的 UUID、DCE 安全 UUID、基于名称的 UUID 和随机生成的 UUID。 这些类型的 version 值分别为 1、2、3 和 4。
有关用于创建 UUID 的算法的更多信息，请参阅互联网草案 UUIDs and GUIDs 或 ISO/IEC 11578:1996 处的标准组织定义。
- 从以下版本开始：
- 1.5
- 另请参见：
- 序列化表格
| 构造方法摘要 | |
|---|---|
UUID(long mostSigBits, long leastSigBits)使用指定的数据构造新的 UUID。 | |
| 方法摘要 | |
|---|---|
int | clockSequence()与此 UUID 相关联的时钟序列值。 |
int | compareTo(UUID val)将此 UUID 与指定的 UUID 比较。 |
boolean | equals(Object obj)将此对象与指定对象比较。 |
static UUID | fromString(String name)根据 toString() 方法中描述的字符串标准表示形式创建 UUID。 |
long | getLeastSignificantBits()返回此 UUID 的 128 位值中的最低有效 64 位。 |
long | getMostSignificantBits()返回此 UUID 的 128 位值中的最高有效 64 位。 |
int | hashCode()返回此 UUID 的哈希码。 |
static UUID | nameUUIDFromBytes(byte[] name)根据指定的字节数组检索类型 3（基于名称的）UUID 的静态工厂。 |
long | node()与此 UUID 相关的节点值。 |
static UUID | randomUUID()检索类型 4（伪随机生成的）UUID 的静态工厂。 |
long | timestamp()与此 UUID 相关联的时间戳值。 |
String | toString()返回表示此 UUID 的 String 对象。 |
int | variant()与此 UUID 相关联的变体号。 |
int | version()与此 UUID 相关联的版本号。 |
| 从类 java.lang.Object 继承的方法 |
|---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
| 构造方法详细信息 |
|---|
UUID
public UUID(long mostSigBits,
long leastSigBits)- 使用指定的数据构造新的 UUID。mostSigBits 用于 UUID 的最高有效 64 位，而 leastSigBits 将成为 UUID 的最低有效 64 位。
- 参数：
mostSigBits-leastSigBits-
| 方法详细信息 |
|---|
randomUUID
public static UUID randomUUID()
- 检索类型 4（伪随机生成的）UUID 的静态工厂。 使用加密的强伪随机数生成器生成该
UUID。 - 返回：
- 随机生成的 UUID。
nameUUIDFromBytes
public static UUID nameUUIDFromBytes(byte[] name)
- 根据指定的字节数组检索类型 3（基于名称的）UUID 的静态工厂。
- 参数：
name，用于构造- UUID 的字节数组的名称。- 返回：
- 从指定数组生成的 UUID。
fromString
public static UUID fromString(String name)
- 根据
toString()方法中描述的字符串标准表示形式创建 UUID。 - 参数：
name，指定- UUID 的字符串。- 返回：
- 具有指定值的 UUID。
- 抛出：
IllegalArgumentException- 如果 name 与toString()中描述的字符串表示形式不符。
getLeastSignificantBits
public long getLeastSignificantBits()
- 返回此 UUID 的 128 位值中的最低有效 64 位。
- 返回：
- 此 UUID 的 128 位值中的最低有效 64 位。
getMostSignificantBits
public long getMostSignificantBits()
- 返回此 UUID 的 128 位值中的最高有效 64 位。
- 返回：
- 此 UUID 的 128 位值中最高有效 64 位。
version
public int version()
- 与此 UUID 相关联的版本号。版本号描述此 UUID 是如何生成的。 版本号具有以下含意：
- 1 基于时间的 UUID
- 2 DCE 安全 UUID
- 3 基于名称的 UUID
- 4 随机生成的 UUID
- 返回：
- 此 UUID 的版本号。
variant
public int variant()
- 与此 UUID 相关联的变体号。变体号描述 UUID 的布局。 变体号具有以下含意：
- 0 为 NCS 向后兼容保留
- 2 Leach-Salz 变体（由此类使用）
- 6 保留，Microsoft Corporation 向后兼容
- 7 保留供以后定义使用
- 返回：
- 此 UUID 的变体号。