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

Методы

lookup

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

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

Параметры:

name - имя в формате URL (без компоненты схемы)

Возвращает:

ссылку на удалённый объект

Исключения:

NotBoundException - если имя в данный момент не привязано

RemoteException - если реестр не смог связаться

AccessException - если данная операция запрещена

MalformedURLException - если имя не имеет соответствующего формата URL

Since:

JDK1.1

bind

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

Привязывает указанное name к удалённому объекту.

Параметры:

name - имя в формате URL (без компоненты схемы)

obj - ссылка на удалённый объект (обычно заглушка)

Исключения:

AlreadyBoundException - если имя уже привязано

MalformedURLException - если имя не имеет соответствующего формата URL

RemoteException - если реестр не смог связаться

AccessException - если операция запрещена (например, если она исходит с нелокального хоста)

Since:

JDK1.1

unbind

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

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

Параметры:

name - имя в формате URL (без компоненты схемы)

Исключения:

NotBoundException - если имя в данный момент не привязано

MalformedURLException - если имя не имеет соответствующего формата URL

RemoteException - если реестр не смог связаться

AccessException - если операция запрещена (например, если она исходит с нелокального хоста)

Since:

JDK1.1

rebind

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

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

Параметры:

name - имя в формате URL (без компоненты схемы)

obj - новый удалённый объект для ассоциации с именем

Исключения:

MalformedURLException - если имя не имеет соответствующего формата URL

RemoteException - если реестр не смог связаться

AccessException - если операция запрещена (например, если она исходит с нелокального хоста)

Since:

JDK1.1

list

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

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

Параметры:

name - имя реестра в формате URL (без компоненты схемы)

Возвращает:

массив имён (в соответствующем формате), привязанных в реестре

Исключения:

MalformedURLException - если имя не имеет соответствующего формата URL

RemoteException - если реестр не смог связаться.

Since:

JDK1.1