Класс 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, a int uniquely identifying the VM, in which this UID was generated, with respect to its host and at the time represented by the time value (an example implementation of the unique value would be a process identifier), or zero for a well-known UID
time, a long равное времени (как возвращается System.currentTimeMillis()), в которое VM, в котором был сгенерирован этот UID, был активен, или ноль для известного UID
count, a short to distinguish UID generated in the same VM with the same time value

Независимо сгенерированный экземпляр 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¹⁶ возможных таких известных идентификаторов.

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

Параметры:: 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, 2023, 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/21/docs/api/java.rmi/java/rmi/server/UID.html