Класс UID

public final class UID
extends Object
implements Serializable

Объект UID представляет собой идентификатор, уникальный во времени относительно узла, на котором он сгенерирован, или один из 2¹⁶ «известных» идентификаторов.

Конструктор UID() может быть использован для генерации идентификатора, уникального во времени относительно узла, на котором он сгенерирован. Конструктор UID(short) может быть использован для создания одного из 2¹⁶ известных идентификаторов.

Экземпляр UID содержит три примитивных значения:

• unique, идентификатор int, уникально идентифицирующий виртуальную машину (VM), в которой был сгенерирован этот UID, относительно её узла и времени, представленного значением time (пример реализации значения unique — идентификатор процесса), или ноль для известного UID
• time, значение long равное времени (как возвращается методом System.currentTimeMillis()), в которое VM, в которой был сгенерирован этот UID, была активна, или ноль для известного UID
• count, значение short для различения UIDs, сгенерированных в одной VM с одинаковым значением time

Независимо сгенерированный экземпляр UID уникален во времени относительно узла, на котором он был сгенерирован, при условии, что перезапуск узла занимает более одной миллисекунды, и время системы никогда не устанавливается назад.

Глобально уникальный идентификатор можно создать, объединив экземпляр UID с уникальным идентификатором узла, например, IP-адресом.

Конструкторы

UID

public UID()

Генерирует UID, уникальный во времени относительно узла, на котором он был сгенерирован.

UID

public UID(short num)

Параметры:

num - номер для известного UID

Методы

hashCode

public int hashCode()

Возвращает хэш-код для этого UID.

Переопределяет:

hashCode в классе Object

Возвращает:

значение хэш-кода для этого UID

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

equals

public boolean equals(Object obj)

Сравнивает заданный объект с этим UID на равенство. Этот метод возвращает true тогда и только тогда, когда заданный объект является экземпляром UID с такими же значениями unique, time, и count, как у этого.

Переопределяет:

equals в классе Object

Параметры:

obj - объект для сравнения с этим UID

Возвращает:

true если заданный объект эквивалентен этому, и false в противном случае

См. также:

Object.hashCode(), HashMap

toString

public String toString()

Возвращает строковое представление этого UID.

Переопределяет:

toString в классе Object

Возвращает:

строковое представление этого UID

write

public void write(DataOutput out)
           throws IOException

Параметры:

out - экземпляр DataOutput для записи в него этого UID

Исключения:

IOException - если происходит ошибка ввода-вывода при выполнении этой операции

read

public static UID read(DataInput in)
                throws IOException

Параметры:

in - экземпляр DataInput для чтения из него UID

Возвращает:

экземпляр UID

Исключения:

IOException - если происходит ошибка ввода-вывода при выполнении этой операции