Lerneinheit 3: Blueprint-Konfigurationsdatei erstellen
Die Blueprint-Konfigurationsdatei enthält die Komponentenassemblierung und die Konfigurationsdaten für das Bundle. Die Datei beschreibt, wie die Komponenten in der OSGi-Serviceregistry registriert werden oder wie sie Services aus der OSGi-Serviceregistry abrufen. Diese Informationen werden zur Laufzeit verwendet, um die erforderlichen Komponenten beim Starten des Bundles zu instanziieren und zu konfigurieren. In diesem Lernprogramm definiert die Blueprint-Datei einen Service, den andere Komponenten verwenden können, um auf den Zähler zuzugreifen, der in Lerneinheit 2 definiert wurde.
Informationen zu diesem Vorgang
In dieser Lerneinheit erstellen Sie die Blueprint-Konfigurationsdatei, die die Services definiert und beschreibt, die über CounterServiceBundle bereitgestellt werden.
Gehen Sie wie folgt vor, um die Blueprint-Konfigurationsdatei zu erstellen:
Vorgehensweise
Ergebnisse
<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0">
<bean id="CounterBean" class="com.ibm.ws.eba.counter.CounterImpl" init-method="init"/>
<service id="CounterBeanService" ref="CounterBean"
interface="com.ibm.ws.eba.counter.Counter" />
</blueprint>
Nächste Schritte
- bean
- Das Element bean definiert eine Blueprint-Komponente, die instanziiert wird.
- In diesem Lernprogramm führt das Element bean zur Instanziierung der Komponente Counter, durch Aufrufen des Klassenkonstruktors CounterImpl. Nach Erstellen der Klasse wird die Initialisierungsmethode getCount() aufgerufen.
- class
- Das Attribut class gibt an, welche Implementierungsklasse der Komponente instanziiert wird.
- id
- Das Attribut id gibt die Bean an. Es ist obligatorisch, wenn die Komponente von einer anderen Stelle im Entwurf (zum Beispiel von einer Servicedefinition) referenziert wird.
- init-method
- Die Methode init-method init() wird aufgerufen, wenn die Komponente erstellt wird. Wenn Sie eine Methode nicht während der Bundleinitialisierung aufrufen möchten, entfernen Sie dieses Attribut.
- service
- Das Element service definiert den Export einer Komponente in die OSGi-Service-Registry.
- In diesem Lernprogramm exportiert das Element service die Komponente mit dem Namen Counter als Service mit der über das Attribut "interface" angegebenen Schnittstelle com.ibm.ws.eba.counter.Counter in die OSGi-Service-Registry.
- ref
- Das Attribut ref bezieht sich auf die Komponenten-ID der exportierten Komponente. Diese ID wird im Komponentenelement festgelegt.
- interface
- Das Attribut interface verweist auf die Schnittstelle, die die Komponentenklasse implementiert.
Weitere Informationen zur Blueprint-Konfigurationsdatei finden Sie unter OSGi-Blueprint-XML-Dateien und OSGi-Blueprint-Komponentenmodell (RFC124).
Prüfpunkt für Lerneinheit
Sie haben die Blueprint-Konfigurationsdatei für das Bundle "OSGi-Zähler" erstellt.
- Erstellen einer Datei blueprint.xml.
- Konfigurieren einer Datei blueprint.xml.