Класс 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, 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

См. также:

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, 2021, 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://docs.oracle.com/en/java/javase/17/docs/api/java.rmi/java/rmi/server/UID.html