Именование классов
public final class Naming extends Object
Naming предоставляет методы для хранения и получения ссылок на удалённые объекты в реестре удалённых объектов. Каждый метод класса Naming принимает в качестве одного из аргументов имя, которое является строкой в формате URL (без компонента схемы) вида:
//host:port/name
где host — хост (удалённый или локальный), на котором расположен реестр, port — номер порта, на котором реестр принимает вызовы, а name — простая строка, не интерпретируемая реестром. host и port являются необязательными. Если host опущен, хост по умолчанию — локальный хост. Если port опущен, порт по умолчанию равен 1099, «известному» порту, используемому реестром RMI, rmiregistry.
Связывание имени с удалённым объектом — это ассоциация или регистрация имени для удалённого объекта, которое можно использовать в дальнейшем для поиска этого удалённого объекта. Удалённый объект можно связать с именем, используя методы класса Naming — bind или rebind.
После регистрации (связывания) удалённого объекта с реестром RMI на локальном хосте, вызывающие стороны на удалённом (или локальном) хосте могут искать удалённый объект по имени, получить его ссылку и затем вызывать удалённые методы на объекте. Реестр может быть общим для всех серверов, работающих на одном хосте, или отдельный серверный процесс может создавать и использовать свой собственный реестр, если это необходимо (см. метод java.rmi.registry.LocateRegistry.createRegistry для подробностей).
- Since:
- 1.1
- См. также:
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
static void |
bind |
Связывает указанное name с удалённым объектом. |
static String[] |
list |
Возвращает массив имён, связанных в реестре. |
static Remote |
lookup |
Возвращает ссылку, заместитель, для удалённого объекта, связанного с указанным name. |
static void |
rebind |
Пересвязывает указанное имя с новым удалённым объектом. |
static void |
unbind |
Удаляет связывание для указанного имени, связанного с удалённым объектом. |
Подробное описание методов
lookup
public static Remote lookup(String name) throws NotBoundException, MalformedURLException, RemoteException
name.- Параметры:
-
name- имя в формате URL (без компонента схемы) - Возвращает:
- ссылку на удалённый объект
- Исключения:
-
NotBoundException- если имя не связано в данный момент -
RemoteException- если с реестром не удалось связаться -
AccessException- если данная операция запрещена -
MalformedURLException- если имя не является строкой с правильным форматом URL - Since:
- 1.1
bind
public static void bind(String name, Remote obj) throws AlreadyBoundException, MalformedURLException, RemoteException
name с удалённым объектом.- Параметры:
-
name- имя в формате URL (без компонента схемы) -
obj- ссылка на удалённый объект (обычно заместитель) - Исключения:
-
AlreadyBoundException- если имя уже связано -
MalformedURLException- если имя не является строкой с правильным форматом URL -
RemoteException- если с реестром не удалось связаться -
AccessException- если данная операция запрещена (если она исходит с нелокального хоста, например) - Since:
- 1.1
unbind
public static void unbind(String name) throws RemoteException, NotBoundException, MalformedURLException
- Параметры:
-
name- имя в формате URL (без компонента схемы) - Исключения:
-
NotBoundException- если имя не связано в данный момент -
MalformedURLException- если имя не является строкой с правильным форматом URL -
RemoteException- если с реестром не удалось связаться -
AccessException- если данная операция запрещена (если она исходит с нелокального хоста, например) - Since:
- 1.1
rebind
public static void rebind(String name, Remote obj) throws RemoteException, MalformedURLException
- Параметры:
-
name- имя в формате URL (без компонента схемы) -
obj- новый удалённый объект, который нужно связать с именем - Исключения:
-
MalformedURLException- если имя не является строкой с правильным форматом URL -
RemoteException- если с реестром не удалось связаться -
AccessException- если данная операция запрещена (если она исходит с нелокального хоста, например) - Since:
- 1.1
list
public static String[] list(String name) throws RemoteException, MalformedURLException
- Параметры:
-
name- имя реестра в формате URL (без компонента схемы) - Возвращает:
- массив имён (в соответствующем формате), связанных в реестре
- Исключения:
-
MalformedURLException- если имя не является строкой с правильным форматом URL -
RemoteException- если с реестром не удалось связаться. - Since:
- 1.1
© 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/Naming.html