Spec-Zone.ru › OpenJDK 17

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

java.lang.Object
java.rmi.Naming
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
См. также:
  • 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.
Параметры:
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
Возвращает массив имён, связанных в реестре. Имена — строки в формате URL (без компонента схемы). Массив содержит моментальный снимок имён, присутствующих в реестре на момент вызова.
Параметры:
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

Spec-Zone.ru

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