Именование классов
public final class Naming extends Object
Naming предоставляет методы для хранения и получения ссылок на удаленные объекты в реестре удаленных объектов. Каждый метод класса Naming принимает в качестве одного из аргументов имя, которое является java.lang.String в формате 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
- See Also:
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
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.- Parameters:
-
name- имя в формате URL (без компоненты схемы) - Returns:
- ссылка на удалённый объект
- Throws:
-
NotBoundException- если имя в данный момент не связано -
RemoteException- если с реестром не удалось связаться -
AccessException- если данная операция не разрешена -
MalformedURLException- если имя не соответствует формату URL - Since:
- 1.1
bind
public static void bind(String name, Remote obj) throws AlreadyBoundException, MalformedURLException, RemoteException
name с удалённым объектом.- Parameters:
-
name- имя в формате URL (без компоненты схемы) -
obj- ссылка на удалённый объект (обычно стаб) - Throws:
-
AlreadyBoundException- если имя уже связано -
MalformedURLException- если имя не соответствует формату URL -
RemoteException- если с реестром не удалось связаться -
AccessException- если данная операция не разрешена (например, если запрос исходит с нелокального хоста) - Since:
- 1.1
unbind
public static void unbind(String name) throws RemoteException, NotBoundException, MalformedURLException
- Parameters:
-
name- имя в формате URL (без компоненты схемы) - Throws:
-
NotBoundException- если имя в данный момент не связано -
MalformedURLException- если имя не соответствует формату URL -
RemoteException- если с реестром не удалось связаться -
AccessException- если данная операция не разрешена (например, если запрос исходит с нелокального хоста) - Since:
- 1.1
rebind
public static void rebind(String name, Remote obj) throws RemoteException, MalformedURLException
- Parameters:
-
name- имя в формате URL (без компоненты схемы) -
obj- новый удалённый объект, который следует ассоциировать с именем - Throws:
-
MalformedURLException- если имя не соответствует формату URL -
RemoteException- если с реестром не удалось связаться -
AccessException- если данная операция не разрешена (например, если запрос исходит с нелокального хоста) - Since:
- 1.1
list
public static String[] list(String name) throws RemoteException, MalformedURLException
- Parameters:
-
name- имя реестра в формате URL (без компоненты схемы) - Returns:
- массив имён (в соответствующем формате), связанных в реестре
- Throws:
-
MalformedURLException- если имя не соответствует формату URL -
RemoteException- если с реестром не удалось связаться. - Since:
- 1.1
© 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/Naming.html