java.rmi

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

java.lang. Объект

java.rmi. Именование

public final class Naming
extends Object

Naming класс обеспечивает методы для хранения и получения ссылок на удаленные объекты в реестре удаленного объекта. Каждый метод Naming класс берет в качестве одного из его параметров имя, которое является a 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 метод для деталей).

С тех пор:

JDK1.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 унаследованный от класса. Объект

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

Деталь метода

поиск

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

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

Параметры:

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

Возвраты:

ссылка для удаленного объекта

Броски:

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

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

AccessException - если эта работа не разрешается

MalformedURLException - если именем не является соответственно отформатированный URL

С тех пор:

JDK1.1

связать

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

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

Параметры:

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

obj - ссылка для удаленного объекта (обычно тупик)

Броски:

AlreadyBoundException - если имя уже связывается

MalformedURLException - если именем не является соответственно отформатированный URL

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

AccessException - если эта работа не разрешается (происходя из нелокального узла, например)

С тех пор:

JDK1.1

развязать

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

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

Параметры:

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

Броски:

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

MalformedURLException - если именем не является соответственно отформатированный URL

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

AccessException - если эта работа не разрешается (происходя из нелокального узла, например)

С тех пор:

JDK1.1

снова переплести

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

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

Параметры:

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

obj - новый удаленный объект, чтобы связаться с именем

Броски:

MalformedURLException - если именем не является соответственно отформатированный URL

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

AccessException - если эта работа не разрешается (происходя из нелокального узла, например)

С тех пор:

JDK1.1

список

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

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

Параметры:

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

Возвраты:

массив имен (в соответствующем формате) связанный в реестре

Броски:

MalformedURLException - если именем не является соответственно отформатированный URL

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

С тех пор:

JDK1.1