Most visited

Recently visited

Results for

Added in API level 1
Summary: Ctors | Methods | Inherited Methods | [Expand All]

UUID

public final class UUID
extends Object implements Serializable, Comparable<UUID>

java.lang.Object
   ↳ java.util.UUID

表示不可变的通用唯一标识符（UUID）的类。 一个UUID表示一个128位的值。

这些全局标识符存在不同的变体。 该类的方法用于操纵Leach-Salz变体，尽管构造函数允许创建UUID的任何变体（如下所述）。

变体2（Leach-Salz）UUID的布局如下：最重要的长包括以下无符号字段：

 0xFFFFFFFF00000000 time_low
 0x00000000FFFF0000 time_mid
 0x000000000000F000 version
 0x0000000000000FFF time_hi
The least significant long consists of the following unsigned fields: 
 0xC000000000000000 variant
 0x3FFF000000000000 clock_seq
 0x0000FFFFFFFFFFFF node

variant字段包含一个标识UUID布局的UUID 。 上述位布局仅适用于变量值为2的UUID ，这表示Leach-Salz变体。

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

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

Summary

Public constructors
UUID(long mostSigBits, long leastSigBits)

使用指定的数据构造一个新的 UUID 。

Public methods
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关联的版本号。

Inherited methods
From class java.lang.Object
From interface java.lang.Comparable

Public constructors

UUID

Added in API level 1 
UUID (long mostSigBits, 
                long leastSigBits)

使用指定的数据构造一个新的UUID 。 mostSigBits用于最显著64位UUID和leastSigBits成为的至少显著64位UUID 。

Parameters
mostSigBits long: The most significant bits of the UUID
leastSigBits long: The least significant bits of the UUID

Public methods

clockSequence

Added in API level 1 
int clockSequence ()

与此UUID关联的时钟序列值。

14位时钟序列值由该UUID的时钟序列字段构成。 时钟序列字段用于保证基于时间的UUID中的时间唯一性。

clockSequence值仅在基于时间的UUID中有意义，该UUID具有版本类型1.如果此UUID不是基于时间的UUID，则此方法会抛出UnsupportedOperationException。

Returns
int The clock sequence of this UUID
Throws
UnsupportedOperationException If this UUID is not a version 1 UUID

compareTo

Added in API level 1 
int compareTo (UUID val)

将此UUID与指定的UUID进行比较。

如果第一个UUID中UUID不同的最重要字段更大，则两个UUID中的第一个大于第二个UUID。

Parameters
val UUID: UUID to which this UUID is to be compared
Returns
int -1, 0 or 1 as this UUID is less than, equal to, or greater than val

equals

Added in API level 1 
boolean equals (Object obj)

将此对象与指定的对象进行比较。 结果是true当且仅当参数不是null ，是一个UUID对象，具有相同的变量，并且包含相同的值，比特位，如此UUID 。

Parameters
obj Object: The object to be compared
Returns
boolean true if the objects are the same; false otherwise

fromString

Added in API level 1 
UUID fromString (String name)

创建 UUID如在所描述的字符串标准表示 toString()方法。

Parameters
name String: A string that specifies a UUID
Returns
UUID A UUID with the specified value
Throws
IllegalArgumentException If name does not conform to the string representation as described in toString()

getLeastSignificantBits

Added in API level 1 
long getLeastSignificantBits ()

返回此UUID的128位值的最低有效64位。

Returns
long The least significant 64 bits of this UUID's 128 bit value

getMostSignificantBits

Added in API level 1 
long getMostSignificantBits ()

返回此UUID的128位值的最重要的64位。

Returns
long The most significant 64 bits of this UUID's 128 bit value

hashCode

Added in API level 1 
int hashCode ()

返回此 UUID的哈希码。

Returns
int A hash code value for this UUID

nameUUIDFromBytes

Added in API level 1 
UUID nameUUIDFromBytes (byte[] name)

静态工厂根据指定的字节数组检索类型3（基于名称） UUID 。

Parameters
name byte: A byte array to be used to construct a UUID
Returns
UUID A UUID generated from the specified array

node

Added in API level 1 
long node ()

与此UUID关联的节点值。

48位节点值由该UUID的节点字段构成。 该字段旨在保存生成此UUID的机器的IEEE 802地址，以保证空间唯一性。

该节点值仅在基于时间的UUID中有意义，该UUID具有版本类型1.如果此UUID不是基于时间的UUID，则此方法将引发UnsupportedOperationException。

Returns
long The node value of this UUID
Throws
UnsupportedOperationException If this UUID is not a version 1 UUID

randomUUID

Added in API level 1 
UUID randomUUID ()

静态工厂检索类型4（伪随机生成的）UUID。 UUID是使用密码强的伪随机数发生器生成的。

Returns
UUID A randomly generated UUID

timestamp

Added in API level 1 
long timestamp ()

与此UUID关联的时间戳记值。

60位时间戳值由此UUID的time_low，time_mid和time_hi字段UUID 。 由此产生的时间戳以UTC时间1582年10月15日午夜之后的100纳秒为单位进行测量。

timestamp值仅在基于时间的UUID中有意义，该UUID具有版本类型1.如果此 UUID不是基于时间的UUID，则此方法将引发UnsupportedOperationException。

Returns
long
Throws
UnsupportedOperationException If this UUID is not a version 1 UUID

toString

Added in API level 1 
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"

Returns
String A string representation of this UUID

variant

Added in API level 1 
int variant ()

与此UUID相关联的变体编号。 变体编号描述了UUID的布局。 变体号具有以下含义：

  • 0 Reserved for NCS backward compatibility
  • 2 IETF RFC 4122 (Leach-Salz), used by this class
  • 6 Reserved, Microsoft Corporation backward compatibility
  • 7 Reserved for future definition

Returns
int The variant number of this UUID

version

Added in API level 1 
int version ()

与此UUID关联的版本号。 版本号描述了如何生成这个UUID 。 版本号具有以下含义：

  • 1 Time-based UUID
  • 2 DCE security UUID
  • 3 Name-based UUID
  • 4 Randomly generated UUID

Returns
int The version number of this UUID
Android开发手册

Hooray!