UUID (Java Platform SE 7)

java.lang.Object
- java.util.UUID

すべての実装されたインタフェース:

Serializable, Comparable<UUID>
```
public final class UUID
extends Object
implements Serializable, Comparable<UUID>
```
不変の UUID (universally unique identifier) を表すクラスです。UUID は、128 ビット値を表します。
これらのグローバル識別子には、さまざまな形式が存在します。コンストラクタを使用すれば任意の形式の UUID を作成できますが、このクラスのメソッドは Leach-Salz 形式の操作用メソッドです。
形式 2 (Leach-Salz) UUID のレイアウトは、次のとおりです。最上位の long は、次の符号なしフィールドで構成されます。
```
 0xFFFFFFFF00000000 time_low
 0x00000000FFFF0000 time_mid
 0x000000000000F000 version
 0x0000000000000FFF time_hi
 
```
最下位の long は、次の符号なしフィールドで構成されます。
```
 0xC000000000000000 variant
 0x3FFF000000000000 clock_seq
 0x0000FFFFFFFFFFFF node
 
```
variant フィールドには、UUID のレイアウトを識別する値が含まれます。前述のビットレイアウトは、Leach-Salz 形式を示す形式値 2 を保持する UUID でのみ有効です。
version フィールドには、この UUID の型を示す値が含まれます。UUID には 4 種類の基本タイプがあります。時間ベース UUID、DCE セキュリティー UUID、名前ベース UUID、およびランダム生成 UUID です。これらの型は、version 値 1、2、3、および 4 をそれぞれ保持します。
UUID の作成に使用されるアルゴリズムなどの詳細については、「RFC 4122: A Universally Unique IDentifier (UUID) URN Namespace」のセクション 4.2「Algorithms for Creating a Time-Based UUID」を参照してください。
導入されたバージョン:

1.5

関連項目:
直列化された形式

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明

UUID(long mostSigBits, long leastSigBits)
指定されたデータを使用して、新しい UUID を構築します。

コンストラクタ
コンストラクタと説明
`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` 取得用の Static ファクトリです。
`long`	`node()` この UUID に関連したノード値
`static UUID`	`randomUUID()` タイプ 4 (擬似ランダム生成) UUID を取得するための static ファクトリ。
`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を構築します。UUID の最上位 64 ビットには mostSigBits が使用されます。leastSigBits は、UUID の最下位 64 ビットになります。
    
    パラメータ:
    mostSigBits - UUID の最上位ビット
    leastSigBits - UUID の最下位ビット
- メソッドの詳細
  - randomUUID
```
public static UUID randomUUID()
```
    タイプ 4 (擬似ランダム生成) UUID を取得するための static ファクトリ。この UUID は、暗号強度の高い擬似乱数ジェネレータを使って生成されます。
    
    戻り値:
    ランダムに生成された UUID
  - nameUUIDFromBytes
```
public static UUID nameUUIDFromBytes(byte[] name)
```
    指定されたバイト配列に基づく、タイプ 3 (名前ベース) UUID 取得用の Static ファクトリです。
    
    パラメータ:
    name - UUID の構築に使用するバイト配列
    
    戻り値:
    指定された配列から生成された UUID
  - fromString
```
public static UUID fromString(String name)
```
    toString() メソッドに説明されているように、文字列標準表現から UUID を作成します。
    
    パラメータ:
    name - UUID を指定する文字列
    
    戻り値:
    指定値を使用した 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 の生成方法を示します。各バージョン番号の意味を、次に示します。
    - 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 フィールドから構築されます。結果として得られるタイムスタンプは、1582 年 10 月 15 日 UTC の深夜零時から 100 ナノ秒単位で計測された値になります。
    タイムスタンプ値は、時間ベースの UUID (バージョンタイプ 1) でのみ有意性があります。この UUID が時間ベースの UUID ではない場合、このメソッドは UnsupportedOperationException をスローします。
    
    例外:
    
    UnsupportedOperationException - この UUID がバージョン 1 UUID ではない場合
  - clockSequence
```
public int clockSequence()
```
    この UUID に関連したクロックシーケンス値
    14 ビットのクロックシーケンス値は、この UUID のクロックシーケンスフィールドから構築されます。クロックシーケンスフィールドは、時間ベース UUID の一時的な一意性を保証するために使用されます。
    clockSequence 値は、時間ベースの UUID (バージョンタイプ 1) でのみ有意性があります。この UUID が時間ベースの UUID ではない場合、このメソッドは UnsupportedOperationException をスローします。
    
    戻り値:
    この UUID のクロックシーケンス
    
    例外:
    
    UnsupportedOperationException - この UUID がバージョン 1 UUID ではない場合
  - node
```
public long node()
```
    この UUID に関連したノード値
    48 ビットのノード値は、この UUID のノードフィールドから構築されます。このフィールドは、空間の一意性を保証するため、この UUID を生成したマシンの IEEE 802 アドレスを保持することを目的としています。
    ノード値は、時間ベースの UUID (バージョンタイプ 1) でのみ有意性があります。この 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 の文字列表現
  - 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 と比較します。
    2 つの UUID で異なっている最上位フィールドが、最初の UUID の方が大きい場合、最初の UUID が 2 番目のものより大きいと見なされます。
    
    定義:
    
    compareTo、インタフェース: Comparable<UUID>
    
    パラメータ:
    val - この UUID と比較する UUID
    
    戻り値:
    この UUID が val より小さい場合は -1、等しい場合は 0、大きい場合は 1

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス UUID

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

コンストラクタの詳細

UUID

メソッドの詳細

randomUUID

nameUUIDFromBytes

fromString

getLeastSignificantBits

getMostSignificantBits

version

variant

timestamp

clockSequence

node

toString

hashCode

equals

compareTo