Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class Naming extends Object
Naming
class обеспечивает методы для хранения и получения ссылок на удаленные объекты в реестре удаленного объекта. Каждый метод Naming
class берет в качестве одного из его параметров имя, которое является a java.lang.String
в формате URL (без компонента схемы) формы: //host:port/name
где host
узел (удаленный или локальный), где реестр располагается, port
номер порта, на котором реестр принимает вызовы, и где name
простая строка, неинтерпретируемая реестром. Оба host
и port
являются дополнительными. Если host
опускается, значения по умолчанию узла к локальному узлу. Если port
опускается, тогда значения по умолчанию порта к 1099, "известный" порт что реестр RMI, rmiregistry
, использование.
Привязка имени для удаленного объекта связывает или регистрирует имя для удаленного объекта, который может использоваться в более позднее время, чтобы искать тот удаленный объект. Удаленный объект может быть связан с именем, используя Naming
class bind
или rebind
методы.
Как только удаленный объект регистрируется (связанный) с реестром RMI на локальном узле, вызывающими сторонами на удаленном (или локальный), узел может поиск удаленный объект по имени, получить его ссылку, и затем вызвать удаленные методы на объект. Реестр может быть совместно использован всеми серверами, работающими на узле, или отдельный серверный процесс может создать и использовать свой собственный реестр при желании (см. java.rmi.registry.LocateRegistry.createRegistry
метод для деталей).
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)
Уничтожает привязку для указанного имени, которое связывается с удаленным объектом.
|
public static Remote lookup(String name) throws NotBoundException, MalformedURLException, RemoteException
name
.name
- имя в формате URL (без компонента схемы)NotBoundException
- если имя в настоящий момент не связываетсяRemoteException
- если с реестром нельзя было бы связатьсяAccessException
- если эта работа не разрешаетсяMalformedURLException
- если именем не является соответственно отформатированный URLpublic static void bind(String name, Remote obj) throws AlreadyBoundException, MalformedURLException, RemoteException
name
к удаленному объекту.name
- имя в формате URL (без компонента схемы)obj
- ссылка для удаленного объекта (обычно тупик)AlreadyBoundException
- если имя уже связываетсяMalformedURLException
- если именем не является соответственно отформатированный URLRemoteException
- если с реестром нельзя было бы связатьсяAccessException
- если эта работа не разрешается (происходя из нелокального узла, например)public static void unbind(String name) throws RemoteException, NotBoundException, MalformedURLException
name
- имя в формате URL (без компонента схемы)NotBoundException
- если имя в настоящий момент не связываетсяMalformedURLException
- если именем не является соответственно отформатированный URLRemoteException
- если с реестром нельзя было бы связатьсяAccessException
- если эта работа не разрешается (происходя из нелокального узла, например)public static void rebind(String name, Remote obj) throws RemoteException, MalformedURLException
name
- имя в формате URL (без компонента схемы)obj
- новый удаленный объект, чтобы связаться с именемMalformedURLException
- если именем не является соответственно отформатированный URLRemoteException
- если с реестром нельзя было бы связатьсяAccessException
- если эта работа не разрешается (происходя из нелокального узла, например)public static String[] list(String name) throws RemoteException, MalformedURLException
name
- имя реестра в формате URL (без компонента схемы)MalformedURLException
- если именем не является соответственно отформатированный URLRemoteException
- если с реестром нельзя было бы связаться.
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92