Именование классов

java.lang.Object

java.rmi.Naming

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 для подробностей).

С момента:

1.1

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`static void`	`bind(String name, Remote obj)`	Связывает указанное `name` с удалённым объектом.
`static String[]`	`list(String name)`	Возвращает массив привязанных в реестре имён.
`static Remote`	`lookup(String name)`	Возвращает ссылку, строб, для удалённого объекта, связанного с указанным `name`.
`static void`	`rebind(String name, Remote obj)`	Пересвязывает указанное имя с новым удалённым объектом.
`static void`	`unbind(String name)`	Удаляет привязку для указанного имени, связанного с удалённым объектом.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание методов

lookup

public static Remote lookup(String name) throws NotBoundException, MalformedURLException, RemoteException

Возвращает ссылку, строб, для удалённого объекта, связанного с указанным name.

Параметры:: name - имя в формате URL (без компоненты схемы)
Возвращает:: ссылка на удалённый объект
Исключения:: NotBoundException - если имя не связано в настоящее время; RemoteException - если с реестром не удалось связаться; AccessException - если данная операция не разрешена; MalformedURLException - если имя не является корректно отформатированным URL
С момента:: 1.1

bind

public static void bind(String name, Remote obj) throws AlreadyBoundException, MalformedURLException, RemoteException

Связывает указанное name с удалённым объектом.

Параметры:: name - имя в формате URL (без компоненты схемы); obj - ссылка на удалённый объект (обычно строб)
Исключения:: AlreadyBoundException - если имя уже связано; MalformedURLException - если имя не является корректно отформатированным URL; RemoteException - если с реестром не удалось связаться; AccessException - если данная операция не разрешена (например, при исходящем запросе с нелокального хоста)
С момента:: 1.1

unbind

public static void unbind(String name) throws RemoteException, NotBoundException, MalformedURLException

Удаляет привязку для указанного имени, связанного с удалённым объектом.

Параметры:: name - имя в формате URL (без компоненты схемы)
Исключения:: NotBoundException - если имя не связано в настоящее время; MalformedURLException - если имя не является корректно отформатированным URL; RemoteException - если с реестром не удалось связаться; AccessException - если данная операция не разрешена (например, при исходящем запросе с нелокального хоста)
С момента:: 1.1

rebind

public static void rebind(String name, Remote obj) throws RemoteException, MalformedURLException

Пересвязывает указанное имя с новым удалённым объектом. Любая существующая привязка к имени заменяется.

Параметры:: name - имя в формате URL (без компоненты схемы); obj - новый удалённый объект, который нужно связать с именем
Исключения:: MalformedURLException - если имя не является корректно отформатированным URL; RemoteException - если с реестром не удалось связаться; AccessException - если данная операция не разрешена (например, при исходящем запросе с нелокального хоста)
С момента:: 1.1

list

public static String[] list(String name) throws RemoteException, MalformedURLException

Возвращает массив имён, привязанных в реестре. Имена являются строками в формате URL (без компоненты схемы). Массив содержит моментальный снимок имён, присутствующих в реестре на момент вызова.

Параметры:: name - имя реестра в формате URL (без компоненты схемы)
Возвращает:: массив имён (в соответствующем формате), привязанных в реестре
Исключения:: MalformedURLException - если имя не является корректно отформатированным URL; RemoteException - если с реестром не удалось связаться.
С момента:: 1.1

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.rmi/java/rmi/Naming.html