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, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスUUID

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

メソッドのサマリー

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

コンストラクタの詳細

UUID

メソッドの詳細

randomUUID

nameUUIDFromBytes

fromString

getLeastSignificantBits

getMostSignificantBits

version

variant

timestamp

clockSequence

node

toString

hashCode

equals

compareTo