Création de fichiers XML 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.
Procédure
- Cliquez avec le bouton droit de la souris sur le projet de bundle et sélectionnez Nouveau > Fichier Blueprint. L'assistant Nouveau fichier Blueprint s'affiche.
- Dans la zone Nom de fichier, entrez le nom de votre fichier de configuration Blueprint et cliquez ensuite sur Suivant.
- Dans la page Ajouter ou supprimer des espaces de noms Blueprint de l'assistant, sélectionnez les espaces de noms à ajouter à votre fichier Blueprint. Vous pouvez ajouter des espaces de noms pour les extensions Blueprint, JPA, la référence de ressource et les transactions.En savoir plus sur les espaces de noms Blueprint :
Tableau 1. Description des espaces de noms Blueprint Schéma URL Description Extension Blueprint http://aries.apache.org/blueprint/xmlns/blueprint-ext/v1.0.0 Extensions IBM® Blueprint
Extensions du modèle de programmation OSGi Blueprint, telles que l'injection de champ.
Sécurité Blueprint http://www.ibm.com/appserver/schemas/blueprint/security/v1.0.0 Sécurité IBM Blueprint
La sécurité des beans peut être définie de telle sorte que leurs méthodes ne soient accessibles que par les utilisateurs dotés d'un rôle particulier.
Informations supplémentaires : Sécurité Blueprint et applications OSGi
JPA http://aries.apache.org/xmlns/jpa/v1.0.0 Support JPA pour Blueprint
Fournit l'intégration de l'API JPA (Java™ Persistence API) dans Blueprint. Des unités de persistance et des contextes de persistance peuvent être injectés dans des beans gérés par Blueprint.
Référence de ressource http://www.ibm.com/appserver/schemas/8.0/blueprint/resourcereference Support de la référence de ressource Blueprint
Fournit des objets qui sont déclarés dans WebSphere Application Server JNDI, comme des sources de données et des fabriques de connexion, à injecter dans des beans gérés Blueprint.
Transactions http://aries.apache.org/xmlns/transactions/v1.0.0 Support des transactions Blueprint
Permet au développeur de déclarer des exigences transactionnelles pour des beans gérés par Blueprint.
Remarque : Pour ajouter d'autres espaces de noms ne figurant pas dans cette liste, passez à la vue Source et indiquez l'espace de noms. - Cliquez sur Terminer. Le fichier de configuration Blueprint s'affiche dans l'éditeur.
- Cliquez sur Ajouter pour ajouter les informations d'assemblage et de configuration des composants à votre fichier de configuration Blueprint.
- Bean
- L'élément bean définit le composant Blueprint qui est instancié. Cliquez sur OK pour ajouter des arguments et des propriétés au bean.
- En savoir plus sur les attributs Bean :
- 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.
- Classe
- L'attribut class spécifie quelle classe d'implémentation du component est instanciée.
- Activation
- Cet attribut facultatif définit le mode d'activation du gestionnaire. Deux modes d'activation sont pris en charge :
- eager
- Le gestionnaire est activé durant l'initialisation du conteneur Blueprint.
- lazy
- Le gestionnaire est activé sur demande.
- Portée
- Selon la portée spécifiée, un gestionnaire de bean peut créer des instances d'objets simples ou multiples.
La spécification du conteneur Blueprint définit deux portées principales :
- singleton
- Le gestionnaire de bean crée une seule instance du bean et renvoie cette instance chaque fois qu'il lui est demandé de fournir un objet.
- prototype
- Le gestionnaire de bean crée une nouvelle instance du bean chaque fois qu'il lui est demandé de fournir un objet.
- Dépend de
- Spécifie une liste d'ID de gestionnaire. Les gestionnaires figurant dans cette liste sont activés en premier, avant que le présent gestionnaire ne soit lui-même activé. Un gestionnaire peut avoir des dépendances explicites et implicites. L'attribut dependsOn définit les dépendances explicites. Les dépendances implicites sont définies par les références aux autres gestionnaires, dans la définition du présent gestionnaire.
- Référence de la fabrique
- Spécifie l'ID d'un bean ou d'un gestionnaire de référence agissant comme une fabrique. L'objet spécifié doit avoir une méthode de fabrique, laquelle est spécifiée par l'attribut Méthode de la fabrique (factory-method).
- Méthode destroy
- Spécifie une méthode à appeler lorsque le conteneur Blueprint détruit l'instance d'objet.
- Méthode de la fabrique
- Spécifie le nom de la méthode de fabrique statique.
- Méthode d'initialisation
- La méthode d'initialisation est appelée lors de la création du composant. Supprimez cet attribut si vous ne voulez pas invoquer de méthode durant l'initialisation du bundle.
- Référence
- L'élément reference spécifie les services figurant dans le registre de services. Cliquez sur OK pour ajouter des éléments à la référence.
- En savoir plus sur les attributs Reference :
- 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.
- Interface
- L'attribut interface fait référence à l'interface implémentée par la classe de composant.
- Activation
- Cet attribut facultatif définit le mode d'activation du gestionnaire. Deux modes d'activation sont pris en charge :
- eager
- Le gestionnaire est activé durant l'initialisation du conteneur Blueprint.
- lazy
- Le gestionnaire est activé sur demande.
- Disponibilité
- Détermine si le gestionnaire de référence de service impose qu'au moins un service répondant aux critères de sélection existe avant que l'initialisation du conteneur Blueprint ne se poursuive. L'attribut availability possède deux valeurs :
- optional
- L'existence de services répondant aux critères n'est pas obligatoire.
- mandatory
- Au moins un service répondant aux critères doit exister.
- Filtre
- Spécifie l'expression de filtre qui détermine la sélection des services.
- Délai d'attente
- Indique la durée, en millisecondes, pendant laquelle un proxy peut attendre qu'un service d'arrière-plan devienne disponible.
- Nom de composant
- Spécifie le composant recherché par le filtre.
- Dépend de
- Spécifie une liste d'ID de gestionnaire. Les gestionnaires figurant dans cette liste sont activés en premier, avant que le présent gestionnaire ne soit lui-même activé. Un gestionnaire peut avoir des dépendances explicites et implicites. L'attribut dependsOn définit les dépendances explicites. Les dépendances implicites sont définies par les références aux autres gestionnaires, dans la définition du présent gestionnaire.
- Liste de références
- L'élément reference-list permet à l'élément reference de trouver plusieurs services concordants. Cliquez sur OK pour ajouter des éléments à la liste de références.
- En savoir plus sur les attributs Liste de références :
- 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.
- Interface
- L'attribut interface fait référence à l'interface implémentée par la classe de composant.
- Activation
- Cet attribut facultatif définit le mode d'activation du gestionnaire. Deux modes d'activation sont pris en charge :
- eager
- Le gestionnaire est activé durant l'initialisation du conteneur Blueprint.
- lazy
- Le gestionnaire est activé sur demande.
- Disponibilité
- Détermine si le gestionnaire de référence de service impose qu'au moins un service répondant aux critères de sélection existe avant que l'initialisation du conteneur Blueprint ne se poursuive. L'attribut availability possède deux valeurs :
- optional
- L'existence de services répondant aux critères n'est pas obligatoire.
- mandatory
- Au moins un service répondant aux critères doit exister.
- Filtre
- Spécifie l'expression de filtre qui détermine la sélection des services.
- Type de membre
- Spécifie le type des membres fournis par le gestionnaire de liste de références. L'attribut member-type admet les valeurs suivantes :
- service-object
- Injecte une liste d'objets proxy de service.
- service-reference
- Injecte une liste d'objets référence de service.
- Nom de composant
- Spécifie le composant recherché par le filtre.
- Dépend de
- Spécifie une liste d'ID de gestionnaire. Les gestionnaires figurant dans cette liste sont activés en premier, avant que le présent gestionnaire ne soit lui-même activé. Un gestionnaire peut avoir des dépendances explicites et implicites. L'attribut dependsOn définit les dépendances explicites. Les dépendances implicites sont définies par les références aux autres gestionnaires, dans la définition du présent gestionnaire.
- Service
- L'élément service définit l'exportation d'un composant vers le registre de services OSGi. Cliquez sur OK pour ajouter des éléments au service.
- En savoir plus sur les attributs Service :
- 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.
- Interface
- L'attribut interface fait référence à l'interface implémentée par la classe de composant.
- Activation
- Cet attribut facultatif définit le mode d'activation du gestionnaire. Deux modes d'activation sont pris en charge :
- eager
- Le gestionnaire est activé durant l'initialisation du conteneur Blueprint.
- lazy
- Le gestionnaire est activé sur demande.
- Exportation automatique
- Le paramètre Exportation automatique est spécifié par l'attribut 'auto-export', pour lequel il existe quatre options possibles :
- disabled
- Il s'agit de la valeur par défaut si l'attribut 'auto-export' n'est pas spécifié. La liste des interfaces doit être spécifiée à l'aide de l'attribut interface ou des sous-éléments interfaces.
- interfaces
- Inscrit le service dans le registre en utilisant toutes les interfaces publiques implémentées par sa classe et ses éventuelles superclasses.
- class-hierarchy
- Inscrit le service dans le registre en utilisant sa classe et ses éventuelles superclasses.
- all-classes
- Combine les options 'interfaces' et 'class-hierarchy'.
- Classement
- Vous pouvez utiliser l'attribut ranking pour exposer le service avec un classement spécifique.
- Reference
- L'attribut ref pointe sur l'attribut 'id' du composant exporté. Cet id est défini dans l'élément du composant.
- Dépend de
- Spécifie une liste d'ID de gestionnaire. Les gestionnaires figurant dans cette liste sont activés en premier, avant que le présent gestionnaire ne soit lui-même activé. Un gestionnaire peut avoir des dépendances explicites et implicites. L'attribut dependsOn définit les dépendances explicites. Les dépendances implicites sont définies par les références aux autres gestionnaires, dans la définition du présent gestionnaire.
- Convertisseurs de type
- L'élément type-converters assure la conversion de valeurs entre types de données différents. Cliquez sur OK pour ajouter des éléments au convertisseur de type.
Pour plus d'informations sur le fichier de configuration Blueprint, consultez les rubriques d'aide Fichiers XML Blueprint OSGi et Spécification de conteneur Blueprint OSGi.
- Cliquez sur Ouvrir le descripteur de liaisons WebSphere BluePrint pour créer un fichier de configuration Blueprint OSGi qui contient les références de ressource à la liaison d'alias d'authentification pour un bundle.
Si une application OSGi contient un fichier de liaisons OSGi Blueprint lorsqu'elle est déployée en tant qu'actif, les alias d'authentification contenus dans ce fichier sont utilisés par défaut pour lier les références de ressource.
Pour plus d'informations sur le fichier de liaison Blueprint, voir Création de fichiers XML de liaison Blueprint.
- Cliquez sur Ajouter ou supprimer des espaces de noms Blueprint pour ajouter des espaces de noms au fichier XML Blueprint.
- Dans la boîte de dialogue Espaces de noms Blueprint, sélectionnez les espaces de noms à ajouter au fichier Blueprint.
- Cliquez sur Terminer.
Ces éléments sont activés en fonction des espaces de noms Blueprint que vous ajoutez au fichier XML Blueprint.
- Contexte
- L'élément bpjpa:context étend la spécification Blueprint Apache Aries des beans JPA utilisés avec les transactions Blueprint. Cet élément est ajouté lorsque vous ajoutez l'espace de noms Support JPA. Cliquez sur Ajouter pour ajouter des attributs à l'élément.
- Marque de réservation de propriétés
- L'élément bpext:property-placeholder ajoute des extensions à la spécification Blueprint Apache Aries. Cet élément est ajouté lorsque vous ajoutez l'espace de noms IBM Blueprint Extension. Cliquez sur Ajouter pour ajouter des attributs à l'élément.
- Référence de ressource
- L'élément bpresref:resource-reference injecte des références de ressource, comme des sources de données, dans des beans ou des services. Cet élément est ajouté lorsque vous ajoutez l'espace de noms Support des références de ressource. Cliquez sur Ajouter pour ajouter des attributs à l'élément.
- Transaction
- L'élément tx:transaction étend la spécification Blueprint Apache Aries en ajoutant des propriétés de transaction au fichier Blueprint. Cet élément est ajouté lorsque vous ajoutez l'espace de noms Support de transaction. Cliquez sur Ajouter pour ajouter des attributs à l'élément.
- Enregistrez ce fichier.
Pour plus d'informations sur les fichiers XML Blueprint OSGi, voir les sous-rubriques suivantes :
- Fichiers XML Blueprint OSGi
Les fichiers XML Blueprint définissent et décrivent les divers composants d'une application. - Création de fichiers XML de liaison Blueprint
Le fichier XML de liaison Blueprint, ibm-eba-bnd.xml, contient les références de ressource à la liaison d'alias d'authentification pour un bundle. Si une application OSGi contient un fichier de liaisons OSGi Blueprint lorsqu'elle est déployée en tant qu'actif, les alias d'authentification contenus dans ce fichier sont utilisés par défaut pour lier les références de ressource.