Класс LocateRegistry

java.lang.Object

java.rmi.registry.LocateRegistry

public final class LocateRegistry extends Object

LocateRegistry используется для получения ссылки на начальный реестр удалённых объектов на определённом узле (включая локальный узел) или для создания реестра удалённых объектов, принимающего вызовы на указанном порту.

Обратите внимание, что вызов getRegistry фактически не устанавливает соединение с удалённым узлом. Он лишь создаёт локальную ссылку на удалённый реестр и завершается успешно, даже если на удалённом узле не запущен ни один реестр. Поэтому последующий вызов метода удалённого реестра, возвращённого этим методом, может завершиться ошибкой.

Начиная с:

1.1

См. также:

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

Модификатор и тип	Метод	Описание
`static Registry`	`createRegistry(int port)`	Создаёт и экспортирует экземпляр `Registry` на локальном узле, принимающий запросы на указанном `port`.
`static Registry`	`createRegistry(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)`	Создаёт и экспортирует экземпляр `Registry` на локальном узле, который использует пользовательские фабрики сокетов для взаимодействия с этим экземпляром.
`static Registry`	`getRegistry()`	Возвращает ссылку на удалённый объект `Registry` для локального узла, использующий порт реестра по умолчанию 1099.
`static Registry`	`getRegistry(int port)`	Возвращает ссылку на удалённый объект `Registry` для локального узла, использующий указанный `port`.
`static Registry`	`getRegistry(String host)`	Возвращает ссылку на удалённый объект `Registry` на указанном `host`, использующий порт реестра по умолчанию 1099.
`static Registry`	`getRegistry(String host, int port)`	Возвращает ссылку на удалённый объект `Registry` на указанном `host` и `port`.
`static Registry`	`getRegistry(String host, int port, RMIClientSocketFactory csf)`	Возвращает локально созданную ссылку на удалённый объект `Registry` на указанном `host` и `port`.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело и будет удалено: этот элемент API может быть удалён в будущей версии. Финализация устарела и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения определённого промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо до истечения определённого промежутка реального времени.

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

getRegistry

public static Registry getRegistry() throws RemoteException

Возвращает ссылку на удалённый объект Registry для локального узла, использующий порт реестра по умолчанию 1099.

Возвращает:: ссылку (заглушку) на реестр удалённых объектов
Вызывает исключение:: RemoteException — если не удалось создать ссылку
Начиная с:: 1.1

getRegistry

public static Registry getRegistry(int port) throws RemoteException

Возвращает ссылку на удалённый объект Registry для локального узла, использующий указанный port.

Параметры:: port — порт, на котором реестр принимает запросы
Возвращает:: ссылку (заглушку) на реестр удалённых объектов
Вызывает исключение:: RemoteException — если не удалось создать ссылку
Начиная с:: 1.1

getRegistry

public static Registry getRegistry(String host) throws RemoteException

Возвращает ссылку на удалённый объект Registry на указанном host, использующий порт реестра по умолчанию 1099. Если host — это null, используется локальный узел.

Параметры:: host — узел, на котором находится удалённый реестр
Возвращает:: ссылку (заглушку) на реестр удалённых объектов
Вызывает исключение:: RemoteException — если не удалось создать ссылку
Начиная с:: 1.1

getRegistry

public static Registry getRegistry(String host, int port) throws RemoteException

Возвращает ссылку на удалённый объект Registry на указанном host и port. Если host — это null, используется локальный узел.

Параметры:: host — узел, на котором находится удалённый реестр; port — порт, на котором реестр принимает запросы
Возвращает:: ссылку (заглушку) на реестр удалённых объектов
Вызывает исключение:: RemoteException — если не удалось создать ссылку
Начиная с:: 1.1

getRegistry

public static Registry getRegistry(String host, int port, RMIClientSocketFactory csf) throws RemoteException

Возвращает локально созданную ссылку на удалённый объект Registry на указанном host и port. Для связи с этим удалённым реестром будет использоваться предоставленная RMIClientSocketFactory csf для создания соединений Socket с реестром на удалённом host и port.

Параметры:: host — узел, на котором находится удалённый реестр; port — порт, на котором реестр принимает запросы; csf — клиентская фабрика Socket, используемая для создания соединений с реестром. Если csf равен null, в заглушке реестра будет использоваться клиентская фабрика Socket по умолчанию.
Возвращает:: ссылку (заглушку) на удалённый реестр
Вызывает исключение:: RemoteException — если не удалось создать ссылку
Начиная с:: 1.2

createRegistry

public static Registry createRegistry(int port) throws RemoteException

Создаёт и экспортирует экземпляр Registry на локальном узле, принимающий запросы на указанном port.

Экземпляр Registry экспортируется так, как если бы был вызван статический метод UnicastRemoteObject.exportObject, которому в качестве аргументов переданы экземпляр Registry и указанный port, за исключением того, что экземпляр Registry экспортируется с известным идентификатором объекта — экземпляром ObjID, созданным со значением ObjID.REGISTRY_ID.

Параметры:: port — порт, на котором реестр принимает запросы
Возвращает:: реестр
Вызывает исключение:: RemoteException — если не удалось экспортировать реестр
Начиная с:: 1.1

createRegistry

public static Registry createRegistry(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) throws RemoteException

Создаёт и экспортирует экземпляр Registry на локальном узле, который использует пользовательские фабрики сокетов для взаимодействия с этим экземпляром. Созданный реестр ожидает входящие запросы на указанном port с использованием ServerSocket, созданного предоставленной RMIServerSocketFactory.

Экземпляр Registry экспортируется так, как если бы был вызван статический метод UnicastRemoteObject.exportObject, которому в качестве аргументов переданы экземпляр Registry, указанный port, указанная RMIClientSocketFactory и указанная RMIServerSocketFactory, за исключением того, что экземпляр Registry экспортируется с известным идентификатором объекта — экземпляром ObjID, созданным со значением ObjID.REGISTRY_ID.

Параметры:: port — порт, на котором реестр принимает запросы; csf — клиентская фабрика Socket, используемая для создания соединений с реестром; ssf — серверная фабрика ServerSocket, используемая для приёма соединений с реестром
Возвращает:: реестр
Вызывает исключение:: RemoteException — если не удалось экспортировать реестр
Начиная с:: 1.2

© 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.