Класс UnicastRemoteObject

Устаревшее: Статические заглушки. Поддержка статически сгенерированных заглушек устарела. Это включает API в этом классе, который требует использования статических заглушек, а также поддержку во время выполнения для загрузки статических заглушек. Предпочтительнее генерировать заглушки динамически, используя один из способов экспорта объектов, не имеющих устаревшего статуса, перечисленных ниже.

Существует восемь способов экспорта удаленных объектов:

1. Наследование от класса UnicastRemoteObject и вызов конструктора UnicastRemoteObject().
2. Наследование от класса UnicastRemoteObject и вызов конструктора UnicastRemoteObject(port).
3. Наследование от класса UnicastRemoteObject и вызов конструктора UnicastRemoteObject(port, csf, ssf).
4. Вызов метода exportObject(Remote). Устаревший.
5. Вызов метода exportObject(Remote, port).
6. Вызов метода exportObject(Remote, port, csf, ssf).
7. Вызов метода exportObject(Remote, port, filter).
8. Вызов метода exportObject(Remote, port, csf, ssf, filter).

Четвёртый метод, exportObject(Remote), всегда использует статически сгенерированные заглушки и устарел.

Остальные методы используют следующий подход: если свойство java.rmi.server.ignoreStubClasses имеет значение true (регистронезависимо) или если статическая заглушка не найдена, заглушки генерируются динамически с использованием объектов Proxy. В противном случае используются статические заглушки.

Значение свойства java.rmi.server.ignoreStubClasses по умолчанию равно false.

Статически сгенерированные заглушки обычно предварительно генерируются из класса удалённого объекта. Загружается статическая заглушка, и создаётся экземпляр этого класса заглушки, как описано ниже.

• «Корневой класс» определяется следующим образом: если класс удалённого объекта напрямую реализует интерфейс, который расширяет Remote, то класс удалённого объекта является корневым классом; в противном случае корневой класс — это наиболее производный суперкласс класса удалённого объекта, который напрямую реализует интерфейс, расширяющий Remote.
• Имя класса заглушки, подлежащего загрузке, определяется путём конкатенации бинарного имени корневого класса с суффиксом _Stub.
• Класс заглушки загружается по имени с использованием загрузчика классов корневого класса. Класс заглушки должен быть общедоступным, он должен расширять RemoteStub, он должен находиться в пакете, экспортированном по крайней мере для модуля java.rmi, и он должен иметь общедоступный конструктор, имеющий один параметр типа RemoteRef.
• Наконец, экземпляр класса заглушки создаётся с помощью RemoteRef.
• Если соответствующий класс заглушки не найден, или класс заглушки не загружен, или при создании экземпляра заглушки возникает проблема, генерируется исключение StubNotFoundException.

Динамические заглушки генерируются путём создания экземпляра Proxy со следующими характеристиками:

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

Удалённые объекты, которые экспортированы, получают вызовы методов от заглушек, как описано в спецификации RMI. Операция и параметры каждого вызова разамаршелизуются с помощью настраиваемого ObjectInputStream. Если предоставлен ObjectInputFilter и он не является null при экспорте объекта, он используется для фильтрации параметров при разамаршелизации из потока. Фильтр используется для всех вызовов и всех параметров независимо от вызываемого метода или значений параметров. Если фильтр не предоставлен или является null для экспортированного объекта, то используется фильтр по умолчанию ObjectInputStream, если таковой имеется. Фильтр по умолчанию настроен с помощью ObjectInputFilter.Config.setSerialFilter. Если фильтр отклоняет любой из параметров, исключение InvalidClassException, брошенное ObjectInputStream, сообщается как причина UnmarshalException.