Overview | Module | Use | Devguide | Index

Included Services | Exported Interfaces | Properties' Summary | Properties' Details

:: com :: sun :: star :: registry ::
service NestedRegistry
Description supports a shared view on two different registries. The registry files will be opened in two different modes, registry1 will be opened with read/write rights and registry2 will be opened read-only. In the context of this service, the functions`open` ,`close` , and`destroy` from XSimpleRegistry are not supported and throw an exception if they are used. Functions of XSimpleRegistry : getURL returns the name of registry1. isValid checks if registry1 is valid. If the interface is not NULL then registry1 should always be valid. isReadOnly checks if registry1 has write protection. mergeKey merges all information from the specified registry in registry1. getRootKey returns a virtual rootkey of both registries. Functions of XRegistryKey : openKey returns a virtual key which is specified in registy1 or registry2. deleteKey deletes the key only if it is present in registry1. setLongValue, setAsciiValue, setStringValue, setBinaryValue sets the value at the specified key in registry1. getLongValue, getAsciiValue, getStringValue, getBinaryValue returns the value at the specified key in registry1, or if the value is not present in registry1, it will return the value of registry2. openKeys returns a sequence of all subkeys in both registries. getKeyNames returns a sequence with the names of all subkeys in both registries. Note: all write functions only work on registry1. How to initialize the registries: Use a sequence of XSimpleRegistry with two elements. The first element must be the registry which is opened with read/write rights and the second element must be the read-only one. Two different ways are possible: use XMultiServiceFactory::createInstanceWithArguments() to create an instance of this service where the value of the any parameter must be the sequence with the two open registries. use the initialize function of the ::com::sun::star::lang::XInitialization interface where the value of the any parameter must be the sequence with the two open registries. Guarantees: -thread safe

Exported Interfaces
XSimpleRegistry | allows access to a registry (a persistent data source). The data is stored in a hierarchical key structure beginning with a root key. Each key can store a value and can have multiple subkeys.
::com::sun::star::lang::XInitialization | initializes an object directly after its creation.

Top of Page

Copyright © 2003 Sun Microsystems, Inc.