Класс 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.
• Класс заглушки загружается по имени с помощью загрузчика классов корневого класса. Класс заглушки должен быть public, он должен наследоваться от RemoteStub, он должен находиться в пакете, который экспортирован, как минимум, в модуль java.rmi, и должен иметь public конструктор, который принимает один параметр типа RemoteRef.
• Наконец, создаётся экземпляр класса заглушки с помощью RemoteRef.
• Если соответствующий класс заглушки не найден, или класс заглушки не может быть загружен, или при создании экземпляра заглушки возникает проблема, будет брошено исключение StubNotFoundException.

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

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

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