java.util
클래스 UUID

java.lang.Object 
  java.util.UUID

모든 구현된 인터페이스:

Serializable, Comparable <UUID >

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

불변의 UUID (유니버설 고유 식별)를 나타내는 클래스입니다. 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 기본적인 형태에는 시간 베이스, DCE 시큐러티, 이름 베이스 및 랜덤에 생성된 UUID 4 개가 있습니다. 이러한 형태는 version 치 1, 2, 3 및 4를 각각 보관 유지합니다.

상세 (UUID 작성에 사용하는 알고리즘등)는 Internet-Draft 「UUIDs and GUIDs」, 또는 ISO/IEC 11578:1996 표준 body 정의를 참조하십시오.

도입된 버전 :

1.5

관련 항목:

직렬화 된 형식

생성자 개요

UUID (long mostSigBits, long leastSigBits)
지정된 데이터를 사용해, 새로운 UUID를 구축합니다.

메서드 개요

int	clockSequence () 이 UUID에 관련한 클락 순서치 14 비트의 클락 순서치는 이 UUID 클락 identification sequence field으로부터 구축됩니다.
int	compareTo (UUID val) 이 UUID가 지정된 UUID와 비교합니다.
boolean	equals (Object obj) 이 객체가 지정된 객체와 비교합니다.
static UUID	fromString (String name) 캐릭터 라인 표준 표현으로부터 UUID를 작성합니다.
long	getLeastSignificantBits () 이 UUID 128 비트치의 최하정도 64 비트를 리턴합니다.
long	getMostSignificantBits () 이 UUID 128 비트치의 최상정도 64 비트를 리턴합니다.
int	hashCode () UUID 해시 코드를 리턴합니다.
static UUID	nameUUIDFromBytes (byte[] name) 지정된 바이트 배열에 근거하는 타입 3 (이름 베이스) UUID 취득용의 String 팩토리
long	node () 이 UUID에 관련한 노드치 48 비트의 노드치는 이 UUID 노드 필드로부터 구축됩니다.
static UUID	randomUUID () 타입 4 (의사 랜덤 생성) UUID 취득용의 String 팩토리 UUID 생성에는 암호용으로 강화된 사 난수 제네레이터가 사용됩니다.
long	timestamp () 이 UUID에 관련한 타임 스탬프치 60 비트의 타임 스탬프값이 이 UUID time_low, time_mid 및 time_hi 필드로부터 구축됩니다.
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 - @param leastSigBits

메서드의 상세

randomUUID

public static UUID  randomUUID()

타입 4 (의사 랜덤 생성) UUID 취득용의 String 팩토리 UUID 생성에는 암호용으로 강화된 사 난수 제네레이터가 사용됩니다.

반환값:

랜덤에 생성된 UUID

nameUUIDFromBytes

public static UUID  nameUUIDFromBytes(byte[] name)

지정된 바이트 배열에 근거하는 타입 3 (이름 베이스) UUID 취득용의 String 팩토리

파라미터:

name - UUID 구축에 사용하는 바이트 배열

반환값:

지정된 배열로부터 생성된 UUID

fromString

public static UUID  fromString(String  name)

캐릭터 라인 표준 표현으로부터 UUID를 작성합니다. 자세한 내용은 toString() 메서드를 참조하십시오.

파라미터:

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 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을 Throw 합니다.

예외:

UnsupportedOperationException - 이 UUID가 버전 1 UUID가 아닌 경우

clockSequence

public int clockSequence()

이 UUID에 관련한 클락 순서치

14 비트의 클락 순서치는 이 UUID 클락 identification sequence field로부터 구축됩니다. 클락 identification sequence field는 시간 베이스 UUID 일시적인 일의성을 보증하기 위해서 사용됩니다.

clockSequence 치는 시간 베이스의 UUID (버전 타입 1)에서만 유의성이 있습니다. 이 UUID가 시간 베이스의 UUID가 아닌 경우, 이 메서드는 UnsupportedOperationException을 Throw 합니다.

반환값:

이 UUID 클락 순서

예외:

UnsupportedOperationException - 이 UUID가 버전 1 UUID가 아닌 경우

node

public long node()

이 UUID에 관련한 노드치

48 비트의 노드치는 이 UUID 노드 필드로부터 구축됩니다. 이 필드는 공간의 일의성을 보증하기 위해, 이 UUID를 생성한 머신의 IEEE 802 주소를 보관 유지하는 것을 목적으로 하고 있습니다.

노드치는 시간 베이스의 UUID (버전 타입 1)에서만 유의성이 있습니다. 이 UUID가 시간 베이스의 UUID가 아닌 경우, 이 메서드는 UnsupportedOperationException을 Throw 합니다.

반환값:

이 UUID 노드치

예외:

UnsupportedOperationException - 이 UUID가 버전 1 UUID가 아닌 경우

toString

public String  toString()

이 UUID를 나타내는 String 객체를 리턴합니다.

UUID 캐릭터 라인 표현은 다음의 BNF 로 기술되는 대로입니다.

  UUID                   =  "-"  "-"
                            "-"
                            "-"
                           
  time_low               = 4*
  time_mid               = 2*
  time_high_and_version  = 2*
  variant_and_sequence   = 2*
  node                   = 6*
  hexOctet               = 
  hexDigit               =
        "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9"
        | "a" | "b" | "c" | "d" | "e" | "f"
        | "A" | "B" | "C" | "D" | "E" | "F"
 

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 UUID 캐릭터 라인 표현

hashCode

public int hashCode()

UUID 해시 코드를 리턴합니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

이 UUID에 사용하는 해시 코드값

관련 항목:

Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object  obj)

이 객체가 지정된 객체와 비교합니다. 결과가 true가 되는 것은 인수가 null는 아니고, UUID 객체이며, 이 UUID와 같은 형식, 같은 값, 빗트포빗트를 보관 유지하는 경우만입니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

obj - 비교 대상의 객체

반환값:

객체가 같은 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Object.hashCode(), Hashtable

compareTo

public int compareTo(UUID  val)

이 UUID가 지정된 UUID와 비교합니다.

UUID가 다른 최상정도 필드가 최초의 UUID 보다 큰 경우, 2개의 UUID 중 최초의 것이 2번째의 것에 계속됩니다.

정의:

인터페이스 Comparable <UUID > 내의 compareTo

파라미터:

val - 이 UUID와 비교하는 UUID

반환값:

이 UUID 값이 val 보다 작은 경우는 -1, 동일한 경우는 0, 큰 경우는 1