Класс ObjID

java.lang.Object

java.rmi.server.ObjID

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

public final class ObjID extends Object implements Serializable

Объект ObjID используется для идентификации удалённого объекта, экспортированного в среду выполнения RMI. Когда удалённый объект экспортируется, ему присваивается идентификатор объекта неявно или явно, в зависимости от используемого API для экспорта.

Конструктор ObjID() может быть использован для генерации уникального идентификатора объекта. Такой идентификатор ObjID уникален во времени относительно хоста, на котором он был сгенерирован. Конструктор ObjID(int) может быть использован для создания "известного" идентификатора объекта. Сфера действия известного ObjID зависит от среды выполнения RMI, в которую он экспортирован.

Экземпляр класса ObjID содержит номер объекта (типа long) и идентификатор адресного пространства (типа UID). В уникальном ObjID, идентификатор адресного пространства уникален по отношению к данному хосту во времени. В известном ObjID, идентификатор адресного пространства эквивалентен идентификатору, возвращаемому вызовом конструктора UID(short) со значением ноль.

Если системная переменная java.rmi.server.randomIDs определена и равна строке "true" (без учёта регистра), то конструктор ObjID() будет использовать криптографически стойкий генератор псевдослучайных чисел для выбора номера объекта возвращаемого ObjID.

С тех пор как:

1.1

См. также:

Сериализованная форма

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`ACTIVATOR_ID`	Номер объекта для известного `ObjID` активатора.
`static final int`	`DGC_ID`	Номер объекта для известного `ObjID` распределённого сборщика мусора.
`static final int`	`REGISTRY_ID`	Номер объекта для известного `ObjID` реестра.

Краткое описание конструкторов

Конструктор	Описание
`ObjID()`	Генерирует уникальный идентификатор объекта.
`ObjID(int objNum)`	Создаёт "известный" идентификатор объекта.

Краткое описание методов

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

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

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

Подробное описание полей

REGISTRY_ID

public static final int REGISTRY_ID

Номер объекта для известного ObjID реестра.

См. также:

Значения константных полей

ACTIVATOR_ID

public static final int ACTIVATOR_ID

Номер объекта для известного ObjID активатора.

См. также:

Значения константных полей

DGC_ID

public static final int DGC_ID

Номер объекта для известного ObjID распределённого сборщика мусора.

См. также:

Значения константных полей

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

ObjID

public ObjID()

Генерирует уникальный идентификатор объекта.

Если системная переменная java.rmi.server.randomIDs определена и равна строке "true" (без учёта регистра), то этот конструктор будет использовать криптографически стойкий генератор псевдослучайных чисел для выбора номера объекта возвращаемого ObjID.

ObjID

public ObjID(int objNum)

Создаёт "известный" идентификатор объекта.

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

Параметры:: objNum - номер объекта для известного идентификатора объекта

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

write

public void write(ObjectOutput out) throws IOException

Записывает двоичное представление этого ObjID в экземпляр ObjectOutput.

Конкретно, этот метод сначала вызывает метод DataOutput.writeLong(long) данного потока с номером объекта этого идентификатора объекта, а затем записывает его идентификатор адресного пространства, вызвав его метод UID.write(DataOutput) с потоком.

Параметры:: out - экземпляр ObjectOutput для записи этого ObjID
Исключения:: IOException - если произошла ошибка ввода-вывода во время выполнения этой операции

read

public static ObjID read(ObjectInput in) throws IOException

Создаёт и возвращает новый экземпляр ObjID, разархивировав двоичное представление из экземпляра ObjectInput.

Конкретно, этот метод сначала вызывает метод DataInput.readLong() данного потока для чтения номера объекта, затем вызывает UID.read(DataInput) с потоком для чтения идентификатора адресного пространства, а затем создаёт и возвращает новый экземпляр ObjID , содержащий номер объекта и идентификатор адресного пространства, которые были прочитаны из потока.

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

hashCode

public int hashCode()

Возвращает хэш-код для данного идентификатора объекта, номер объекта.

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

hashCode в классе Object

Возвращает:

значение хэш-кода для данного идентификатора объекта

См. также:

equals

public boolean equals(Object obj)

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

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

equals в классе Object

Параметры:

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

Возвращает:

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

См. также:

toString

public String toString()

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

Переопределяет:: toString в классе Object
Возвращает:: строковое представление этого идентификатора объекта

© 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/ObjID.html