Класс LocateRegistry

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

public final class LocateRegistry
extends Object

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

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

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

getRegistry

public static Registry getRegistry(int port)
                            throws RemoteException

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

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

getRegistry

public static Registry getRegistry(String host)
                            throws RemoteException

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

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

getRegistry

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

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

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

Параметры:: 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:: 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 - если реестр не мог быть экспортирован
Since:: 1.2