(incubating) | The Free and Open Productivity Suite

Developer's Guide

API

SDK

Tips 'n' Tricks

Miscellaneous

Content for OpenOffice.org version 3.3.

:: com :: sun :: star :: embed ::

service StorageFactory
Description
The StorageFactory is a service that allows to create a storage based on either stream or URL.

Exported Interfaces - Summary
::com::sun::star::lang::XSingleServiceFactory

A storage can be created through this interface. (details)

Exported Interfaces - Details
::com::sun::star::lang::XSingleServiceFactory
Description
A storage can be created through this interface.

In case XSingleServiceFactory::createInstance call is used the result storage will be open in readwrite mode based on an arbitrary medium.

In case XSingleServiceFactory::createInstanceWithArguments call is used a sequence of the following parameters can be used:

parameter 1
specifies source of the object, it can be a string containing URL, an ::com::sun::star::io::XStream implementation or ::com::sun::star::io::XInputStream; in case of ::com::sun::star::io::XStream implementation the ::com::sun::star::io::XSeekable interface must be supported.
parameter 2
specifies mode the storage should be open in, can take values from ElementModes constant set.
parameter 3
this paramenter represents com::sun::star::uno::Any containing a sequence of ::com::sun::star::beans::PropertyValue.
The parameter can contain entries from com::sun::star::document::MediaDescryptor to transport some document info during the storage initialization, it can be for example ::com::sun::star::task::XInteractionHandler implementation, password for the storage and repair package flag.
Additionaly the parameter might contain property with the name "StorageFormat" that can take values from StorageFormats. If the property is not provided a storage of package format is created.

The parameters are optional, that means that sequence can be empty or contain only first parameter, or first and second one. In case no parameters are provided the call works the same way as ::com::sun::star::lang::XSingleServiceFactory::createInstance. In case only first parameter is provided, the storage is opened in readonly mode.

The opened root storage can support read access in addition to specified one.


 
Top of Page

Apache OpenOffice is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.

Copyright & License
Apache and the Apache feather logos are trademarks of The Apache Software Foundation. OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.