(incubating) | The Free and Open Productivity Suite

Developer's Guide

API

SDK

Tips 'n' Tricks

Miscellaneous

Content for OpenOffice.org version 3.3.
Overview Module Use Devguide Index
Nested Modules Services Singletons Interfaces Structs Exceptions Enums Typedefs Constant Groups

:: com :: sun :: star ::

module registry
Description
Interfaces to access registration databases.
Services
DefaultRegistry implicitly supports a local registry and a read-only system registry for global information. 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.
ImplementationRegistration is the implementation of the interface XImplementationRegistration. This service can be used to install or uninstall components (implementations). Further, it is possible to check if all runtime dependencies (needed services) are available to use a specified component. Guarantees:
NestedRegistry 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.
SimpleRegistry makes it possible to create, open, or close a registry. Further, it is possible to merge a registry under a specified key in the open registry. Guarantees:
Interfaces
XImplementationRegistration offers a registry for implementation objects and provides information about the registered implementations.
XImplementationRegistration2 extends the functionality of XImplementationRegistration. It can be useful to specify a complete Url to a component but register the components name only (library or jar name).
XRegistryKey makes structural information (except regarding tree structures) of a single registry key accessible.
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.
Exceptions
CannotRegisterImplementationException is thrown when an application tries to register a new component (implementation) using the XImplementationRegistration::registerImplementation() method, but the component cannot be registered. The reason for this exception could be:
InvalidRegistryException signals that the registry is invalid or an operation on the registry failed.
InvalidValueException signals that the value of the key is invalid or does not have the appropriate key type.
MergeConflictException is thrown if entries of two registries are contradictory in the context of XSimpleRegistry::mergeKey()e method.
Enums
RegistryKeyType represents all possible types of a key.
RegistryValueType represents all possible types of a key value.
Top of Page

Copyright © 1995, 2010, Oracle and/or its affiliates. All rights reserved. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

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.