UUID (Java Platform SE 8 )

java.lang.Object
- java.util.UUID

All Implemented Interfaces:

Serializable ， Comparable < UUID >
```
public final class UUID
extends Object
implements Serializable, Comparable<UUID>
```
一个表示不可变的通用唯一标识符（UUID）的类。 UUID表示128位值。
这些全局标识符存在不同的变体。该类的方法是用于操纵Leach-Salz变体，尽管构造函数允许创建UUID的任何变体（如下所述）。

变体2（Leach-Salz）UUID的布局如下：最重要的长度包括以下无符号字段：
```
  0xFFFFFFFF00000000 time_low
 0x00000000FFFF0000 time_mid
 0x000000000000F000 version
 0x0000000000000FFF time_hi 
```
最不重要的长度包括以下无符号字段：
```
  0xC000000000000000 variant
 0x3FFF000000000000 clock_seq
 0x0000FFFFFFFFFFFF node 
```
变量字段包含一个标识UUID的布局的UUID 。上述的位布局仅用于有效UUID为2的变体值，其指示里奇- SALZ变体。

版本字段保存描述此类型的值UUID 。 UUID有四种不同的基本类型：基于时间，DCE安全性，基于名称和随机生成的UUID。这些类型的版本值分别为1，2，3和4。

有关包括用于创建UUID的更多信息，请参见RFC 4122: A Universally Unique IDentifier (UUID) URN Namespace第4.2节“创建基于时间的UUID的算法”。
从以下版本开始：

1.5

另请参见：

Serialized Form

构造方法摘要

构造方法
Constructor and Description
`UUID(long mostSigBits, long leastSigBits)` 构造一个新 `UUID`使用指定的数据。

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`int`	`clockSequence()` 与该UUID相关联的时钟序列值。
`int`	`compareTo(UUID val)` 将此UUID与指定的UUID进行比较。
`boolean`	`equals(Object obj)` 将此对象与指定的对象进行比较。
`static UUID`	`fromString(String name)` 创建 `UUID`如在所描述的字符串标准表示 `toString()`方法。
`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`的版本号。

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- 构造方法详细信息
  - UUID
```
public UUID(long mostSigBits,
            long leastSigBits)
```
    构造一个新UUID使用指定的数据。 mostSigBits被用于最显著64位UUID和leastSigBits成为的至少显著64位UUID 。
    
    参数
    
    mostSigBits -的最显著位 UUID
    
    leastSigBits -的的最低显著位 UUID
- 方法详细信息
  - randomUUID
```
public static UUID randomUUID()
```
    静态工厂检索一个类型4（伪随机生成）的UUID。 UUID是使用加密强伪随机数生成器生成的。
    
    结果
    
    随机生成 UUID
  - nameUUIDFromBytes
```
public static UUID nameUUIDFromBytes(byte[] name)
```
    静态工厂根据指定的字节数组检索类型3（基于名称） UUID 。
    
    参数
    
    name -的字节数组被用于构造 UUID
    
    结果
    
    A UUID从指定的数组生成
  - fromString
```
public static UUID fromString(String name)
```
    创建 UUID如在所描述的字符串标准表示 toString()方法。
    
    参数
    
    name - 一个指定UUID的 UUID
    
    结果
    
    A UUID具有指定的值
    
    异常
    
    IllegalArgumentException -如果在描述的名称不符合字符串表示 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 。版本号描述这怎么UUID产生。版本号具有以下含义：
    - 1个基于时间的UUID
    - 2 DCE安全UUID
    - 3基于名称的UUID
    - 4随机生成的UUID
    结果
    
    该版本号为 UUID
  - variant
```
public int variant()
```
    与此UUID的变式号。变体号描述的布局UUID 。变式号码具有以下含义：
    - 0保留用于NCS向后兼容
    - 2 IETF RFC 4122 （Leach-Salz），由这个类使用
    - 6保留，Microsoft Corporation向后兼容
    - 7保留供将来定义
    结果
    
    这个 UUID的变体号
  - timestamp
```
public long timestamp()
```
    与此UUID相关联的时间戳值。
    60位时间戳值是由这个UUID的time_low，time_mid和time_hi字段UUID 。所产生的时间戳记是从1582年10月15日UTC 15分钟以100纳秒为单位测量的。
    
    时间戳值仅在具有版本类型为1的基于时间的UUID中有意义。如果此UUID不是基于时间的UUID，则此方法将引发UnsupportedOperationException。
    
    结果
    
    这个UUID的 UUID 。
    
    异常
    
    UnsupportedOperationException - 如果此UUID不是版本1 UUID
  - clockSequence
```
public int clockSequence()
```
    与该UUID相关联的时钟序列值。
    14位时钟序列值由该UUID的时钟序列字段构成。时钟序列字段用于保证基于时间的UUID中的时间唯一性。
    
    clockSequence值仅在具有版本类型1的基于时间的UUID中有意义。如果此UUID不是基于时间的UUID，则此方法将抛出UnsupportedOperationException。
    
    结果
    
    这个 UUID的时钟顺序
    
    异常
    
    UnsupportedOperationException - 如果这个UUID不是版本1的UUID
  - node
```
public long node()
```
    与此UUID相关联的节点值。
    48位节点值由该UUID的节点字段构成。该字段旨在保存生成此UUID的机器的IEEE 802地址，以保证空间唯一性。
    
    节点值仅在具有版本类型1的基于时间的UUID中有意义。如果此UUID不是基于时间的UUID，则此方法将抛出UnsupportedOperationException。
    
    结果
    
    该节点值为 UUID
    
    异常
    
    UnsupportedOperationException - 如果此UUID不是版本1 UUID
  - toString
```
public String toString()
```
    返回代表这个UUID的String对象。
    UUID字符串表示形式由此BNF描述：
    UUID = <time_low> "-" <time_mid> "-" <time_high_and_version> "-" <variant_and_sequence> "-" <node> time_low = 4*<hexOctet> time_mid = 2*<hexOctet> time_high_and_version = 2*<hexOctet> variant_and_sequence = 2*<hexOctet> node = 6*<hexOctet> hexOctet = <hexDigit><hexDigit> hexDigit = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "a" | "b" | "c" | "d" | "e" | "f" | "A" | "B" | "C" | "D" | "E" | "F"
    重写：
    
    toString在 Object
    
    结果
    
    这个 UUID字符串表示 UUID
  - hashCode
```
public int hashCode()
```
    返回此 UUID的哈希码。
    
    重写：
    
    hashCode在类 Object
    
    结果
    
    这个 UUID哈希码值
    
    另请参见：
    
    Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)
  - equals
```
public boolean equals(Object obj)
```
    将此对象与指定的对象进行比较。结果是true如果且仅当参数不是null ，是一个UUID对象，具有相同的变体，并且包含相同的值，位为位，就像这样UUID 。
    
    重写：
    
    equals在 Object
    
    参数
    
    obj - 要比较的对象
    
    结果
    
    true如果对象是一样的; false否则
    
    另请参见：
    
    Object.hashCode() ， HashMap
  - compareTo
```
public int compareTo(UUID val)
```
    将此UUID与指定的UUID进行比较。
    如果UUID不同的最重要字段对于第一个UUID而言较大，则两个UUID中的第一个大于第二个UUID。
    
    Specified by:
    
    compareTo在接口 Comparable<UUID>
    
    参数
    
    val - UUID要对这 UUID进行比较
    
    结果
    
    -1，0或1，因为这个 UUID小于，等于或大于 val

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class UUID

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

UUID

方法详细信息

randomUUID

nameUUIDFromBytes

fromString

getLeastSignificantBits

getMostSignificantBits

version

variant

timestamp

clockSequence

node

toString

hashCode

equals

compareTo