Класс 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`.

Методы, объявленные в классе java.lang.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://download.java.net/java/early_access/jdk24/docs/api/java.rmi/java/rmi/registry/LocateRegistry.html