Класс UID

java.lang.Object

java.rmi.server.UID

Все реализуемые интерфейсы:: Serializable

public final class UID extends Object implements Serializable

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

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

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

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

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

Since:

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¹⁶ возможных таких известных id.

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

Параметры:: num - число для известного UID

Подробное описание методов

hashCode

public int hashCode()

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

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

hashCode в классе Object

Возвращает:

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

См. также:

equals

public boolean equals(Object obj)

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

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

equals в классе Object

Параметры:

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

Возвращает:

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

См. также:

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 - если во время выполнения этой операции произошла ошибка ввода/вывода

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.rmi/java/rmi/server/UID.html