Класс LocateRegistry

java.lang.Object
- java.rmi.registry.LocateRegistry

public final class LocateRegistry
extends Object

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

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

Since:: JDK1.1
См. также:: 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.

Возвращает:: ссылка (заглушка) на реестр удалённых объектов
Исключения:: RemoteException - если ссылка не могла быть создана
Since:: JDK1.1

getRegistry

public static Registry getRegistry(int port)
                            throws RemoteException

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

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

getRegistry

public static Registry getRegistry(String host)
                            throws RemoteException

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

Параметры:: host - узел для удалённого реестра
Возвращает:: ссылка (заглушка) на реестр удалённых объектов
Исключения:: RemoteException - если ссылка не могла быть создана
Since:: JDK1.1

getRegistry

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

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

Параметры:: host - узел для удалённого реестра; port - порт, на котором реестр принимает запросы
Возвращает:: ссылка (заглушка) на реестр удалённых объектов
Исключения:: RemoteException - если ссылка не могла быть создана
Since:: JDK1.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 - если ссылка не могла быть создана
Since:: 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 - если реестр не удалось экспортировать
Since:: JDK1.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 - если реестр не удалось экспортировать
Since:: 1.2

© 1993, 2020, 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.