java.rmi.registry

Интерфейсный Реестр

Все Суперинтерфейсы:

Удаленный

public interface Registry
extends Remote

Registry удаленный интерфейс к простому реестру удаленного объекта, который обеспечивает методы для хранения и получения ссылок удаленного объекта, связанных с произвольными названиями строк. bind, unbind, и rebind методы используются, чтобы изменить привязку имени в реестре, и lookup и list методы используются, чтобы запросить текущую привязку имени.

В его типичном использовании, a Registry включения клиент RMI, загружающийся: это предоставляет простое средство клиенту получить начальную ссылку на удаленный объект. Поэтому, реализация удаленного объекта реестра обычно экспортируется с известным адресом, такой как с известным ObjID и номер порта TCP (значение по умолчанию 1099).

LocateRegistry класс обеспечивает программируемый API для того, чтобы он создал ссылку начальной загрузки на a Registry в удаленном адресе (см. помехи getRegistry методы) и для создания и экспорта a Registry в текущем VM на определенном локальном адресе (см. помехи createRegistry методы).

A Registry реализация может хотеть ограничивать доступ к некоторым или всем его методам (например, методы, которые видоизменяют привязку реестра, могут быть ограничены вызовам, происходящим из локального узла). Если a Registry метод хочет лишать доступа для данного вызова, его реализация может бросить AccessException, который (потому что это расширяется RemoteException) будет обернут в a ServerException когда поймано удаленным клиентом.

Имена используются для привязки в a Registry чистые строки, не проанализированные. Служба, которая хранит ее удаленную ссылку в a Registry может хотеть использовать имя пакета в качестве префикса в привязке имени, чтобы уменьшить вероятность коллизий имени в реестре.

С тех пор:

JDK1.1

См. Также:

LocateRegistry

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static int	REGISTRY_PORT Стандартный порт для реестра.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	bind(String name, Remote obj) Связывает удаленную ссылку на указанное name в этом реестре.
Строка[]	list() Возвращает массив имен, связанных в этом реестре.
Удаленный	lookup(String name) Возвращает удаленную ссылку, связанную с указанным name в этом реестре.
void	rebind(String name, Remote obj) Заменяет привязку для указанного name в этом реестре с предоставленной удаленной ссылкой.
void	unbind(String name) Удаляет привязку для указанного name в этом реестре.

Полевая Деталь

REGISTRY_PORT

static final int REGISTRY_PORT

Стандартный порт для реестра.

См. Также:

Постоянные Значения полей

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

поиск

Remote lookup(String name)
              throws RemoteException,
                     NotBoundException,
                     AccessException

Возвращает удаленную ссылку, связанную с указанным name в этом реестре.

Параметры:

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

Возвраты:

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

Броски:

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

RemoteException - если удаленная передача с реестром перестала работать; если исключение является a ServerException содержа AccessException, тогда реестр лишает, что доступ вызывающей стороны выполняет эту работу

AccessException - если этот реестр локален, и он лишает, что доступ вызывающей стороны выполняет эту работу

NullPointerException - если name null

связать

void bind(String name,
        Remote obj)
          throws RemoteException,
                 AlreadyBoundException,
                 AccessException

Связывает удаленную ссылку на указанное name в этом реестре.

Параметры:

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

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

Броски:

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

RemoteException - если удаленная передача с реестром перестала работать; если исключение является a ServerException содержа AccessException, тогда реестр лишает, что доступ вызывающей стороны выполняет эту работу (происходя из нелокального узла, например)

AccessException - если этот реестр локален, и он лишает, что доступ вызывающей стороны выполняет эту работу

NullPointerException - если name null, или если obj null

развязать

void unbind(String name)
            throws RemoteException,
                   NotBoundException,
                   AccessException

Удаляет привязку для указанного name в этом реестре.

Параметры:

name - имя привязки, чтобы удалить

Броски:

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

RemoteException - если удаленная передача с реестром перестала работать; если исключение является a ServerException содержа AccessException, тогда реестр лишает, что доступ вызывающей стороны выполняет эту работу (происходя из нелокального узла, например)

AccessException - если этот реестр локален, и он лишает, что доступ вызывающей стороны выполняет эту работу

NullPointerException - если name null

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

void rebind(String name,
          Remote obj)
            throws RemoteException,
                   AccessException

Заменяет привязку для указанного name в этом реестре с предоставленной удаленной ссылкой. Если есть существующая привязка для указанного name, это отбрасывается.

Параметры:

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

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

Броски:

RemoteException - если удаленная передача с реестром перестала работать; если исключение является a ServerException содержа AccessException, тогда реестр лишает, что доступ вызывающей стороны выполняет эту работу (происходя из нелокального узла, например)

AccessException - если этот реестр локален, и он лишает, что доступ вызывающей стороны выполняет эту работу

NullPointerException - если name null, или если obj null

список

String[] list()
              throws RemoteException,
                     AccessException

Возвращает массив имен, связанных в этом реестре. Массив будет содержать снимок имен, связанных в этом реестре во время данного вызова этого метода.

Возвраты:

массив имен связывается в этом реестре

Броски:

RemoteException - если удаленная передача с реестром перестала работать; если исключение является a ServerException содержа AccessException, тогда реестр лишает, что доступ вызывающей стороны выполняет эту работу

AccessException - если этот реестр локален, и он лишает, что доступ вызывающей стороны выполняет эту работу