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

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.

Привязка имени к удалённому объекту означает связывание имени с удалённым объектом или регистрацию этого имени, чтобы позднее по нему можно было найти удалённый объект. Удалённый объект можно связать с именем с помощью методов bind или rebind класса Naming.

После регистрации (привязки) удалённого объекта в реестре 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)`	Удаляет привязку указанного имени к удалённому объекту.

Методы, объявленные в классе 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://docs.oracle.com/en/java/javase/25/docs/api/java.rmi/java/rmi/Naming.html