UUID (Java Platform SE 8)

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`を構築します。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`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をスローします。
    
    戻り値:
    
    このUUIDのタイムスタンプ。
    
    例外:
    
    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, 2014, 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