java.rmi.server

Класс UnicastRemoteObject

java.lang. Объект

java.rmi.server. RemoteObject

java.rmi.server. RemoteServer

java.rmi.server. UnicastRemoteObject

Все Реализованные Интерфейсы:

Сериализуемый, Удаленный

Прямые Известные Подклассы:

ActivationGroup

public class UnicastRemoteObject
extends RemoteServer

Используемый для того, чтобы экспортировать удаленный объект с JRMP и получить тупик, который связывается с удаленным объектом.

Для конструкторов и статичный exportObject методы ниже, тупик для экспортируемого удаленного объекта получаются следующим образом:

• Если удаленный объект экспортируется, используя UnicastRemoteObject.exportObject(Remote) метод, тупиковый класс (обычно предварительно сгенерированный от класса удаленного объекта, используя rmic инструмент), загружается, и экземпляр того тупикового класса создается следующим образом.
  • "Корневой класс" определяется следующим образом: если класс удаленного объекта непосредственно реализует интерфейс, который расширяется Remote, тогда класс удаленного объекта является корневым классом; иначе, корневой класс является наиболее полученным суперклассом класса удаленного объекта, который непосредственно реализует интерфейс, который расширяется Remote.
  • Имя тупикового класса загрузки определяется, связывая двоичное имя корневого класса с суффиксом "_Stub".
  • Тупиковый класс загружается, по имени используя загрузчик класса корневого класса. Тупиковый класс должен расшириться RemoteStub и должен иметь общедоступного конструктора, у которого есть один параметр типа RemoteRef.
  • Наконец, экземпляр тупикового класса создается с a RemoteRef.
• Если соответствующий тупиковый класс не мог бы быть найден, или тупиковый класс не мог бы быть загружен, или проблема происходит, создавая тупиковый экземпляр, a StubNotFoundException бросается.

• Для всех других средств экспорта:
  • Если тупиковый класс удаленного объекта (как определено выше) не мог бы быть загружен или системное свойство java.rmi.server.ignoreStubClasses устанавливается в "true" (нечувствительный к регистру), a Proxy экземпляр создается со следующими свойствами:
    • Класс прокси определяется загрузчиком класса класса удаленного объекта.
    • Прокси реализует все удаленные интерфейсы, реализованные классом удаленного объекта.
    • Обработчик вызова прокси является a RemoteObjectInvocationHandler экземпляр создается с a RemoteRef.
    • Если прокси не мог бы быть создан, a StubNotFoundException будет брошен.

  • Иначе, экземпляр тупикового класса удаленного объекта (столь же описанный выше) используется в качестве тупика.

С тех пор:

JDK1.1

См. Также:

Сериализированная Форма

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

Поля java.rmi.server унаследованный от класса. RemoteObject

касательно

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	UnicastRemoteObject() Создает и экспортирует новый объект UnicastRemoteObject использование анонимного порта.
protected	UnicastRemoteObject(int port) Создает и экспортирует новый объект UnicastRemoteObject использование определенного предоставленного порта.
protected	UnicastRemoteObject(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) Создает и экспортирует новый объект UnicastRemoteObject использование определенного предоставленного порта и фабрик сокета.

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

Методы

Модификатор и Тип	Метод и Описание
Объект	clone() Возвращает клона удаленного объекта, который отличен от оригинала.
static RemoteStub	exportObject(Remote obj) Экспортирует удаленный объект, чтобы сделать доступным, чтобы получить входящие вызовы, используя анонимный порт.
static Remote	exportObject(Remote obj, int port) Экспортирует удаленный объект, чтобы сделать доступным, чтобы получить входящие вызовы, используя определенный предоставленный порт.
static Remote	exportObject(Remote obj, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) Экспортирует удаленный объект, чтобы сделать доступным, чтобы получить входящие вызовы, используя транспорт, определенный данной фабрикой сокета.
static boolean	unexportObject(Remote obj, boolean force) Удаляет удаленный объект, obj, со времени выполнения RMI.

Методы java.rmi.server унаследованный от класса. RemoteServer

getClientHost, getLog, setLog

Методы java.rmi.server унаследованный от класса. RemoteObject

equals, getRef, hashCode, toString, toStub

Методы java.lang унаследованный от класса. Объект

finalize, getClass, notify, notifyAll, wait, wait, wait

Деталь конструктора

UnicastRemoteObject

protected UnicastRemoteObject()
                       throws RemoteException

Создает и экспортирует новый объект UnicastRemoteObject использование анонимного порта.

Броски:

RemoteException - если отказавший экспортировать объект

С тех пор:

JDK1.1

UnicastRemoteObject

protected UnicastRemoteObject(int port)
                       throws RemoteException

Создает и экспортирует новый объект UnicastRemoteObject использование определенного предоставленного порта.

Параметры:

port - номер порта, на котором удаленный объект получает вызовы (если port нуль, анонимный порт выбирается),

Броски:

RemoteException - если отказавший экспортировать объект

С тех пор:

1.2

UnicastRemoteObject

protected UnicastRemoteObject(int port,
                   RMIClientSocketFactory csf,
                   RMIServerSocketFactory ssf)
                       throws RemoteException

Создает и экспортирует новый объект UnicastRemoteObject использование определенного предоставленного порта и фабрик сокета.

Параметры:

port - номер порта, на котором удаленный объект получает вызовы (если port нуль, анонимный порт выбирается),

csf - фабрика сокета клиентской стороны для того, чтобы сделать звонки в удаленный объект

ssf - фабрика сокета серверной стороны для того, чтобы прием в соответствии с удаленными вызовами

Броски:

RemoteException - если отказавший экспортировать объект

С тех пор:

1.2

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

клон

public Object clone()
             throws CloneNotSupportedException

Возвращает клона удаленного объекта, который отличен от оригинала.

Переопределения:

clone в классе Object

Возвраты:

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

Броски:

CloneNotSupportedException - если клон, отказавший из-за RemoteException.

С тех пор:

JDK1.1

См. Также:

Cloneable

exportObject

public static RemoteStub exportObject(Remote obj)
                               throws RemoteException

Экспортирует удаленный объект, чтобы сделать доступным, чтобы получить входящие вызовы, используя анонимный порт.

Параметры:

obj - удаленный объект, который будет экспортирован

Возвраты:

тупик удаленного объекта

Броски:

RemoteException - если экспорт перестал работать

С тех пор:

JDK1.1

exportObject

public static Remote exportObject(Remote obj,
                  int port)
                           throws RemoteException

Экспортирует удаленный объект, чтобы сделать доступным, чтобы получить входящие вызовы, используя определенный предоставленный порт.

Параметры:

obj - удаленный объект, который будет экспортирован

port - порт, чтобы экспортировать объект на

Возвраты:

тупик удаленного объекта

Броски:

RemoteException - если экспорт перестал работать

С тех пор:

1.2

exportObject

public static Remote exportObject(Remote obj,
                  int port,
                  RMIClientSocketFactory csf,
                  RMIServerSocketFactory ssf)
                           throws RemoteException

Экспортирует удаленный объект, чтобы сделать доступным, чтобы получить входящие вызовы, используя транспорт, определенный данной фабрикой сокета.

Параметры:

obj - удаленный объект, который будет экспортирован

port - порт, чтобы экспортировать объект на

csf - фабрика сокета клиентской стороны для того, чтобы сделать звонки в удаленный объект

ssf - фабрика сокета серверной стороны для того, чтобы прием в соответствии с удаленными вызовами

Возвраты:

тупик удаленного объекта

Броски:

RemoteException - если экспорт перестал работать

С тех пор:

1.2

unexportObject

public static boolean unexportObject(Remote obj,
                     boolean force)
                              throws NoSuchObjectException

Удаляет удаленный объект, obj, со времени выполнения RMI. В случае успеха объект больше не может принять входящие вызовы RMI. Если параметр силы является истиной, объект насильственно неэкспортируется, даже если там ожидают, призывает к удаленному объекту, или у удаленного объекта все еще есть происходящие вызовы. Если параметр силы является ложью, объект только неэкспортируется, если нет никакого ожидания, или происходящий призывает к объекту.

Параметры:

obj - удаленный объект, который будет неэкспортирован

force - если это правда, неэкспортирует объект, даже если там ожидают, или происходящий вызывает; если ложь, только неэкспортирует объект, если нет никакого ожидания, или происходящий вызывает

Возвраты:

истина, если работа успешна, ложна иначе

Броски:

NoSuchObjectException - если удаленный объект в настоящий момент не экспортируется

С тех пор:

1.2