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

interface XSingleLayerStratum
Base Interfaces
::com::sun::star::uno::XInterface
  |  
  +--XSingleLayerStratum
::com::sun::star::uno::XInterface
(referenced interface's summary:)
base interface of all UNO interfaces
Description
Handles access to a stratum consisting of a single layer in a configuration data repository

The interface provides timestamp-checking capabilities for efficient caching.

See also
::com::sun::star::util::XTimeStamped
See also
::com::sun::star::configuration::backend::XSchemaSupplier
See also
::com::sun::star::configuration::backend::XMultiLayerStratum
Since
OpenOffice 1.1.2

Methods' Summary
getLayer retrieves the layer data for a component, if newer than indicated.  
getUpdatableLayer retrieves a writable representation of the layer for a component.  
Methods' Details
getLayer
::com::sun::star::configuration::backend::XLayer
getLayer( [in] string  aComponent,
[in] string  aTimestamp )
raises( ::com::sun::star::configuration::backend::BackendAccessException,
::com::sun::star::lang::IllegalArgumentException );

Description
retrieves the layer data for a component, if newer than indicated.

A timestamp can be provided, which is used to indicate a point in time. The layer should be returned only if is modified since that time.

Parameter aComponent
The name of the component to access.
Parameter aTimestamp
a timestamp for the layer.

An empty timestamp indicates, that the layer should be retrieved irrespective of its modification time.

The format and meaning of a timestamp depends on the implementation. Timestamps can be obtained using ::com::sun::star::util::XTimeStamped::getTimestamp() .

Returns
a ::com::sun::star::configuration::backend::Layer object providing access to the layer data, NULL if the layer is newer than indicated by the timestamp.
Throws
com::sun::star::lang::IllegalArgumentException if the component identifier is invalid or if the timestamp is invalid.
Throws
com::sun::star::configuration::backend::BackendAccessException if an error occurs while accessing the data.
See also
::com::sun::star::util::XTimeStamped
getUpdatableLayer
::com::sun::star::configuration::backend::XUpdatableLayer
getUpdatableLayer( [in] string  aComponent )
raises( ::com::sun::star::configuration::backend::BackendAccessException,
::com::sun::star::lang::NoSupportException,
::com::sun::star::lang::IllegalArgumentException );

Description
retrieves a writable representation of the layer for a component.
Parameter aComponent
The name of the component to access.
Returns
an ::com::sun::star::configuration::backend::UpdatableLayer object providing write access to the layer
Throws
com::sun::star::lang::IllegalArgumentException if the component identifier is invalid.
Throws
com::sun::star::lang::NoSupportException if the implementation does not support updates.
Throws
com::sun::star::configuration::backend::BackendAccessException if an error occurs while accessing the data.
Top of Page