Класс 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 - клиентская фабрика сокетов, используемая для подключения к регистру; ssf - серверная фабрика сокетов, используемая для принятия подключений к регистру
Возвращает:: регистр
Выбрасывает:: RemoteException - если регистр не мог быть экспортирован
С момента:: 1.2

© 1993, 2023, 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/21/docs/api/java.rmi/java/rmi/registry/LocateRegistry.html