Spec-Zone.ru › OpenJDK 21

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

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).

Since:
1.1
See Also:
  • Registry
  • LocateRegistry
  • LocateRegistry.createRegistry(int)

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

Модификатор и тип Метод Описание
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.
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
Возвращает массив имён, связанных в реестре. Имена представлены строками в формате URL (без компоненты схемы). Массив содержит моментальный снимок имён, присутствующих в реестре на момент вызова.
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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API