25714.3 Beschreibung von Metatyp-Informationen in XML
14.3.2 Zuordnung zu ManagedService und ManagedServiceFactory
Bislang haben Sie gesehen, wie Sie die Metatyp-Information von Kon-
figurationen in Form von Object-Class-Definitionen angeben. Wenn
Sie den Metatype-Service zusammen mit dem Config Admin Service
nutzen, müssen Sie diese Metatype-Informationen zusätzlich den ent-
sprechenden Managed Services (bzw. den Managed Service Factories)
zuordnen. Um eine entsprechende Zuordnung zu treffen, müssen Sie
das
Designate-Element verwenden, das u.a. über die in Tabelle 14–4
aufgeführten Attribute verfügt.
Die zugehörige Object-Class-Definition referenzieren Sie mit dem
Object-Unterelement. Im folgenden Beispiel wird dem Managed Service
mit der PID
org.osgibook.translation.TranslationService die Object-
Class-Definition mit der ID
org.osgibook.translation. TranslationService
zugeordnet:
<Designate pid="org.osgibook.translation.TranslationService">
<Object
ocdref="org.osgibook.translation.TranslationService"/>
</Designate>
14.3.3 Lokalisierung
Um die Namen und die Beschreibungen von Object-Classes und deren
Attribute in Management Agents in unterschiedlichen Sprachen anzu-
zeigen, können verschiedene Werte innerhalb einer Metatype-Defini-
tion lokalisiert werden. Dies betrifft die Werte der XML-Attribute
name, description und icon einer Object-Class-Definition sowie die
Werte der XML-Attribute
name, description und label der Attribute-
Definition.
Verwendung von
Properties
Wenn Sie einen der Werte lokalisieren möchten, tragen Sie in der
XML-Datei nicht den eigentlichen Wert ein, sondern nur den Namen
einer Property. Diese Property müssen Sie dann in einer oder mehrerer
l10n-Dateien mit den entsprechenden, übersetzten Werten versehen.
Um dem Metatype Service anzuzeigen, dass es sich bei dem Wert eines
Attributs nicht um den tatsächlichen Wert, sondern um ein zu loka-
lisierendes Property handelt, geben Sie vor dem Namen des Propertys
ein
%-Zeichen ein:
Name Optional Beschreibung
pid nein Die PID eines Managed Service
factoryPid ja Die PID einer Managed Service Factory
bundle ja Die Location des Bundles, das die PID implementiert
Tab. 14–4
XML-Attribute
des Designate-Elements