Класс 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.