Класс 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.
- С момента:
- JDK1.1
- См. также:
- Сериализованная форма
Поля
| Модификатор и тип | Поле и описание |
|---|---|
static int |
ACTIVATOR_ID Номер объекта для известного |
static int |
DGC_ID Номер объекта для известного |
static int |
REGISTRY_ID Номер объекта для известного |
Краткое описание конструкторов
| Конструктор и описание |
|---|
ObjID() Генерирует уникальный идентификатор объекта. |
ObjID(int objNum) Создаёт "известный" идентификатор объекта. |
Краткое описание методов
| Модификатор и тип | Метод и описание |
|---|---|
boolean |
equals(Object obj) Сравнивает указанный объект с этим |
int |
hashCode() Возвращает значение хэш-кода для этого идентификатора объекта, номера объекта. |
static ObjID |
read(ObjectInput in) Конструирует и возвращает новый экземпляр |
String |
toString() Возвращает строковое представление этого идентификатора объекта. |
void |
write(ObjectOutput out) Маршалирует двоичное представление этого |
Методы, унаследованные от класса 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 не будет конфликтовать с любыми ObjIDs, сгенерированными с помощью конструктора без аргументов.
- Параметры:
-
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 - Возвращает:
- значение хэш-кода для этого идентификатора объекта
- См. также:
-
Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)
equals
public boolean equals(Object obj)
Сравнивает указанный объект с этим ObjID на равенство. Этот метод возвращает true тогда и только тогда, когда указанный объект является экземпляром ObjID с тем же номером объекта и идентификатором адресного пространства, что и у этого.
- Переопределяет:
-
equalsв классеObject - Параметры:
-
obj- объект для сравнения с этимObjID - Возвращает:
-
trueесли заданный объект эквивалентен этому, иfalseв противном случае - См. также:
-
Object.hashCode(),HashMap
toString
public String toString()
Возвращает строковое представление этого идентификатора объекта.
© 1993, 2020, 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.