Leçon 3: Création du fichier de configuration Blueprint
Le fichier de configuration Blueprint contient les informations d'assemblage et de configuration des composants d'un bundle. Il décrit comment les composants sont enregistrés dans le registre de services OSGi ou comment ils recherchent les services dans ce registre. Ces informations sont utilisées lors de l'exécution pour instancier et configurer les composants requis lors du démarrage du bundle. Dans ce tutoriel, le fichier Blueprint définit un service que d'autres composants peuvent utiliser pour accéder au compteur défini au cours de la leçon 2.
Pourquoi et quand exécuter cette tâche
Dans cette leçon, vous créez le fichier de configuration Blueprint qui définit et décrit les services qui sont fournis par le CounterServiceBundle.
Pour créer le fichier de configuration Blueprint :
Procédure
Résultats
<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>
Que faire ensuite
- bean
- L'élément bean définit le composant Blueprint instancié.
- Dans ce tutoriel, l'élément bean entraîne l'instanciation du composant Counter en appelant le constructeur de classe CounterImpl. Après la création de la classe, la méthode d'initialisation getCount() est appelée.
- classe
- L'attribut class spécifie la classe d'implémentation du composant instanciée.
- id
- L'attribut id identifie le composant. Il est obligatoire si le composant est référencé depuis un autre endroit dans le fichier Blueprint ; par exemple, s'il est référencé dans une définition de service.
- init-method
- init-method init() est appelé lors de la création du composant. Si vous ne souhaitez pas appeler une méthode lors de l'initialisation du bundle, supprimez cet attribut.
- service
- L'élément service définit l'exportation d'un composant dans le registre de service OSGi.
- Dans ce tutoriel, l'élément service exporte le composant avec le nom Counter en service dans le registre de service OSGi avec l'interface com.ibm.ws.eba.counter.Counter, spécifiée par l'attribut d'interface.
- ref
- L'attribut ref se rapporte à l'ID de composant du composant exporté. Cet ID est défini dans l'élément de composant.
- interface
- L'attribut interface se rapporte à l'interface que la classe de composant met en oeuvre.
Pour plus d'informations sur le fichier de configuration Blueprint, voir Fichiers XML Blueprint OSGi et Modèle de composant Blueprint OSGi (RFC124).
Point de contrôle
Vous avez créé le fichier de configuration Blueprint pour le bundle de compteur OSGi.
- Comment créer un fichier blueprint.xml.
- Comment configurer un fichier blueprint.xml.