:: com :: sun :: star :: configuration :: backend ::

service UpdatableLayer
Description
provides read/write access to a configuration data layer.

A layer contains the configuration setting changes to be performed on a default layer (or schema) to obtain the values of those settings for a given entity and component.

An updatable layer can be read or replaced with another layer.

Since
OpenOffice 1.1.2

Included Services
::com::sun::star::configuration::backend::Layer
Description
handles read access to the contents of the layer.

If the implementation supports ::com::sun::star::util::XTimeStamped , then after executing ::com::sun::star::configuration::backend::XUpdatableLayer::replaceWith() the timestamp will be the one for the replaced contents and if reading after updates is supported the next read will reproduce the replaced data.

Exported Interfaces
::com::sun::star::configuration::backend::XUpdatableLayer
Description
provides write access to the contents of the layer.

Depending of the actual type (simple, i.e pure ::com::sun::star::configuration::backend::XLayer or composite, i.e ::com::sun::star::configuration::backend::XCompositeLayer ) of the current layer and the provided replacement layer, the operation performed by ::com::sun::star::configuration::backend::XUpdatableLayer::replaceWith() , will vary.

For the different current/replacement layer combinations, we have:

Simple/Simple
the provided layer's contents replace the current one's.
Composite/Composite
all layers (main and sub) present in the provided layer are used to replace the corresponding current layer contents. Sublayers present in the current layer but not in the provided one are left untouched. Sublayers present in the provided layer but not in the current one are added to the current layer.
Simple/Composite
the main layer and sublayers of the provided layer are merged into one whose contents replace the current layer.
Composite/Simple
the provided layer is split into a composite one whose contents are then used to replace the current layer as described above.
Not all implementations of ::com::sun::star::configuration::backend::XUpdatableLayer support conversions of the replacement layer. In such a case the sublayers of the provided layer may be ignored or all simple data be merged into the main layer.


 
Top of Page