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

  1. 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.
  2. Dans la zone Nom de fichier, entrez le nom de votre fichier de configuration Blueprint et cliquez ensuite sur Suivant.
  3. 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.
  4. Cliquez sur Terminer. Le fichier de configuration Blueprint s'affiche dans l'éditeur.
  5. 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.
    Par défaut, l'activation est 'eager'.
    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.
    Par défaut, la portée 'singleton' est appliquée pour les gestionnaire de bean de niveau supérieur. L'attribut 'scope' ne peut pas être défini sur un gestionnaire de bean dont le XML est intégré dans le code (inlined), si bien que pour ce type de gestionnaire, la portée considérée est toujours 'prototype'.
    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.
    Par défaut, l'activation est 'eager'.
    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.
    Par défaut, l'attribut availability est réglé sur mandatory (obligatoire).
    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.
    Par défaut, l'activation est 'eager'.
    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.
    Par défaut, l'attribut availability est réglé sur mandatory (obligatoire).
    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.
    Par défaut, l'attribut member-type est réglé sur 'service-object'.
    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.
    Par défaut, l'activation est 'eager'.
    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.

  6. 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.

  7. Cliquez sur Ajouter ou supprimer des espaces de noms Blueprint pour ajouter des espaces de noms au fichier XML Blueprint.
    1. Dans la boîte de dialogue Espaces de noms Blueprint, sélectionnez les espaces de noms à ajouter au fichier Blueprint.
    2. 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.
  8. Enregistrez ce fichier.

    Pour plus d'informations sur les fichiers XML Blueprint OSGi, voir les sous-rubriques suivantes :

Icône indiquant le type de rubrique Rubrique de tâche
Dispositions pour les centres de documentation | Commentaires en retour

Icône d'horodatage Dernière mise à jour: May 29, 2014 10:11

Nom de fichier : tcrtblueprintxml.html