Класс UID

java.lang.Object
- java.rmi.server.UID

Все реализованные интерфейсы:: Serializable

public final class UID
extends Object
implements Serializable

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

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

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

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

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

С:: 1.1
См. также:: Сериализованная форма

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

Конструктор	Описание
`UID()`	Генерирует `UID`, уникальный во времени относительно хоста, на котором он был сгенерирован.
`UID(short num)`	Создаёт «известный» `UID`.

Методы

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Сравнивает указанный объект с этим `UID` на равенство.
`int`	`hashCode()`	Возвращает хэш-код для этого `UID`.
`static UID`	`read(DataInput in)`	Конструирует и возвращает новый экземпляр `UID`, распаковывая двоичное представление из экземпляра `DataInput`.
`String`	`toString()`	Возвращает строковое представление этого `UID`.
`void`	`write(DataOutput out)`	Сериализует двоичное представление этого `UID` в экземпляр `DataOutput`.

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

UID

public UID()

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

UID

public UID(short num)

Создаёт «известный» UID . Существует 2¹⁶ возможных таких известных идентификаторов.

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

Параметры:: 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

Сериализует двоичное представление этого UID в экземпляр DataOutput.

Конкретно, этот метод сначала вызывает метод DataOutput.writeInt(int) данного потока с значением UID этого unique, затем вызывает метод DataOutput.writeLong(long) потока со значением UID этого time, а затем вызывает метод DataOutput.writeShort(int) потока со значением UID этого count.

Параметры:: out - экземпляр DataOutput , в который необходимо записать этот UID
Исключения:: IOException - если при выполнении этой операции происходит ошибка ввода-вывода

read

public static UID read(DataInput in)
                throws IOException

Конструирует и возвращает новый экземпляр UID, распаковывая двоичное представление из экземпляра DataInput.

Конкретно, этот метод сначала вызывает метод DataInput.readInt() данного потока для чтения значения unique, затем вызывает метод DataInput.readLong() потока для чтения значения time, затем вызывает метод DataInput.readShort() потока для чтения значения count, и затем создаёт и возвращает новый экземпляр UID , содержащий значения unique, time, и count, которые были прочитаны из потока.

Параметры:: in - экземпляр DataInput , из которого необходимо прочитать UID
Возвращает:: распакованный экземпляр UID
Исключения:: IOException - если при выполнении этой операции происходит ошибка ввода-вывода