Класс LocateRegistry

java.lang.Object

java.rmi.registry.LocateRegistry

public final class LocateRegistry extends Object

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

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

Since:

1.1

See Also:

Registry

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

Модификатор и тип	Метод	Описание
`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.

Returns:: ссылка (заглушка) на удалённый реестр объектов
Throws:: RemoteException - если ссылка не могла быть создана
Since:: 1.1

getRegistry

public static Registry getRegistry(int port) throws RemoteException

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

Parameters:: port - порт, на котором реестр принимает запросы
Returns:: ссылка (заглушка) на удалённый реестр объектов
Throws:: RemoteException - если ссылка не могла быть создана
Since:: 1.1

getRegistry

public static Registry getRegistry(String host) throws RemoteException

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

Parameters:: host - хост удалённого реестра
Returns:: ссылка (заглушка) на удалённый реестр объектов
Throws:: RemoteException - если ссылка не могла быть создана
Since:: 1.1

getRegistry

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

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

Parameters:: host - хост удалённого реестра; port - порт, на котором реестр принимает запросы
Returns:: ссылка (заглушка) на удалённый реестр объектов
Throws:: RemoteException - если ссылка не могла быть создана
Since:: 1.1

getRegistry

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

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

Parameters:: host - хост удалённого реестра; port - порт, на котором реестр принимает запросы; csf - клиентская Socket фабрика, используемая для установления соединений с реестром. Если csf равно null, то будет использована стандартная клиентская Socket фабрика реестра.
Returns:: ссылка (заглушка) на удалённый реестр
Throws:: RemoteException - если ссылка не могла быть создана
Since:: 1.2

createRegistry

public static Registry createRegistry(int port) throws RemoteException

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

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

Parameters:: port - порт, на котором реестр принимает запросы
Returns:: реестр
Throws:: RemoteException - если реестр не удалось экспортировать
Since:: 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.

Parameters:: port - порт, на котором реестр принимает запросы; csf - клиентская Socket фабрика, используемая для подключения к реестру; ssf - серверная ServerSocket фабрика, используемая для принятия подключений к реестру
Returns:: реестр
Throws:: RemoteException - если реестр не удалось экспортировать
Since:: 1.2

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