|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.util
类 UUID
java.lang.Object java.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 的变体号。