Как получить объекты OpenOffice.org
Объект – это программный артефакт, имеющий методы, которые можно вызывать. Объекты делают что-то с OpenOffice.org. Рассмотрим способы их получения.
Новые объекты
Вообще новые объекты – или объекты, нужные для начального доступа, – создаются менеджерами сервисов OpenOffice.org. В примере FirstLoadComponent (он будет рассмотрен ниже) удаленный менеджер сервисов создает удаленный объект Desktop, управляющий окнами приложений и загружающий документы в OpenOffice.org.
Object desktop = xRemoteServiceManager.createInstanceWithContext("com.sun.star.frame.Desktop",xRemoteContext); |
Объекты документов
Объекты документов представлены файлами, открытыми в OpenOffice.org. Они создаются объектом Desktop, использующим для этого метод loadComponentFromURL().
Объекты, предоставляющие другие объекты
Объекты могут предоставлять другие объекты двумя основными способами.
-
Атрибуты, спроектированные как неотъемлемая часть другого объекта, могут быть получены get-методами. Например, метод getSheets() необходим для каждого документа Calc, getText() для каждого документа Writer и т.д. После загрузки документа эти методы могут использоваться для получения листов (Sheets) и текста (Text) соответствующих документов. Объекто-специфические get-методы – важная техника получения объектов.
-
Атрибуты, не являющиеся неотъемлемой частью архитектуры других объектов, доступны через набор стандартных методов. В OpenOffice.org API эти атрибуты называются свойствами, для обращения к ним используются общие методы, такие, как getPropertyValue(String propertyName), Иногда такие не-неотъемлемые атрибуты представляются как объекты и, таким образом, метод getPropertyValue() может быть еще одним источником объектов. Например, стили страниц (для электронных таблиц) имеют свойства RightPageHeaderContent и LeftPageHeaderContent, содержащие объекты колонтитулов страниц.
Наборы объектов
Объекты могут быть членами набора однообразных объектов. Чтобы обратиться к объекту-члену набора, следует знать, как производится доступ к элементу набора. OpenOffice.org API предоставляет четыре способы получения элемента из набора. Первые три – объекты с методами обращения к элементу по имени, индексу или перечислению. Четвертый путь – последовательность элементов, не имеющая методов доступа, а используемая как массив.
Выбор способа получения элемента определяется проектировщиком применительно к данной конкретной ситуации.
|
OpenOffice.org
