Класс LocateRegistry

java.lang.Object

java.rmi.registry.LocateRegistry

public final class LocateRegistry extends Object

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

Обратите внимание, что вызов 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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.rmi/java/rmi/registry/LocateRegistry.html