Références Blueprint à des ressources [Paramètres]

Les composants Blueprint peuvent accéder aux références de ressources WebSphere Application Server. Chaque référence est déclarée dans un fichier XML Blueprint et peut être sécurisée à l'aide d'un alias d'authentification Java Platform, Enterprise Edition (Java EE) Connector Architecture (JCA). Chaque bundle d'une application OSGi peut contenir n'importe quel nombre de déclarations de références de ressources dans ses divers fichiers Blueprint XML.

Pour afficher ce panneau dans la console d'administration, cliquez sur l'un des chemins suivants :

Applications > Types d'application > Applications de niveau métier > nom_application > [Actifs déployés] Ajouter > Ajouter un actif > nom_actif > Etape de l'assistant : Lier des références de ressources Blueprint
Applications > Types d'application > Applications de niveau métier > nom_application > nom_unité_composition > [Propriétés supplémentaires] Références Blueprint à des ressources

L'étape de l'assistant Lier des références de ressources Blueprint et la propriété Références Blueprint à des ressources ne sont visibles que si le bundle inclut des déclarations de référence de ressource Blueprint.

Lorsque vous sécurisez des références de ressources, ces dernières ne peuvent être liées qu'à des alias d'authentification JCA existants sur chaque serveur ou cluster où l'application est déployée. Une application OSGi peut être déployée sur plusieurs serveurs et clusters du même domaine de sécurité. Par conséquent, chaque alias d'authentification JCA doit exister dans le domaine de sécurité des serveurs et des clusters cible ou dans le domaine de sécurité global.

Vous devez déclarer les références de ressources dans le fichier XML Blueprint. Par exemple :

<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0" 
  xmlns:rr="http://www.ibm.com/appserver/schemas/8.0/blueprint/resourcereference">
  <!-- Other Blueprint declarations ... -->
  
  <rr:resource-reference id="resourceRef" 
          interface="javax.sql.DataSource"
          filter="(osgi.jndi.service.name=jdbc/Account)">
    <rr:res-auth>Container</rr:res-auth>
    <rr:res-sharing-scope>Shareable</rr:res-sharing-scope>
  </rr:resource-reference>
</blueprint>

Cette déclaration inclut l'ID de référence de ressources (par exemple resourceRef), le filtre des services (par exemple jdbc/Account), le type d'authentification (par exemple Container) et le paramètre de partage (par exemple Shareable).

Les liaisons entre les références de ressources Blueprint et l'alias d'authentification de chaque bundle sont stockées dans un fichier ibm-eba-bnd.xml situé dans le répertoire META-INF de ce bundle. Si une application OSGi déployée sur un actif contient l'un de ces fichiers, ces derniers fournissent les valeurs par défaut de l'alias d'authentification utilisées lors de la liaison des références de ressources. Par exemple :

<eba-bnd>
  <resource-ref>
    <jndi-name>jdbc/Acount</jndi-name>
    <authentication-alias>Alias1</authentication-alias>
    <interface>javax.sql.DataSource</interface>
    <authentication>Container</authentication>
    <sharing-scope>Shareable</sharing-scope>
    <id>resourceRef</id>
  </resource-ref>
</eba-bnd>

Propriétés générales

Identificateur du bundle composite

Cet identificateur s'affiche uniquement si l'actif EBA utilise des bundles composites. Chaque bundle composite est identifié par une chaîne ayant le format suivant : Composite bundle archive (CBA)'composite.bundle.symbolic.name_composite.bundle.version'. Les bundles faisant partie d'un bundle composite sont répertoriés sous l'identificateur du bundle composite.

Nom symbolique du bundle composite: Nom non localisable de ce bundle composite.
Version du bundle composite: Version de ce bundle composite.

Le nom symbolique, ainsi que la version, identifie un bundle composite de manière unique.

Identificateur de bundle

Chaque bundle est identifié par une chaîne qui contient le nom symbolique du bundle et la version du bundle. Les bundles faisant partie d'un bundle composite sont répertoriés sous l'identificateur du bundle composite.

Nom symbolique du bundle

Nom non localisable de ce bundle.

Version du bundle

La version de ce bundle.

Le nom symbolique, ainsi que la version, identifie un bundle de manière unique.

ID de la référence de ressource

ID de la référence de ressource, qui est déclaré dans le fichier Blueprint.

Interface de la référence de ressource

L'interface de cette référence de ressource.

Votre application Blueprint peut utiliser n'importe lequel des types de ressource suivants :

Destinations des files d'attente JMS de la messagerie par défaut
Destinations de la rubrique JMS de la messagerie par défaut
Source de données
Fabrique de connexions JMS générique
Session JavaMail
Fabrique de connexions J2C
Fabrique de connexions de file d'attente JMS pour le fournisseur JMS de WebSphere MQ
Destination de file d'attente JMS pour WebSphere MQ
Fabrique de connexions de rubrique JMS pour WebSphere MQ
Destination de rubrique JMS pour WebSphere MQ
Fabrique de connexions JMS unifiée pour WebSphere MQ
Configuration URL

Filtre de la référence de ressource

Le nom du filtre de services qui est la cible de mappage de la référence. Par exemple, jdbc/AccountDS2.

Authentification de la référence de ressource

La référence est authentifiée soit par l'application, soit par le conteneur.

Partage de la référence de ressource

La référence de ressource est partageable ou non partageable.

Alias d'authentification

L'éventuel alias d'authentification servant à sécuriser la référence de ressource.

Pour chaque référence, vous pouvez sélectionner un alias d'authentification dans la liste. Les alias d'authentification par défaut (dans les fichiers ibm-eba-bnd.xml) sont fournis à condition qu'ils existent sur chaque serveur ou cluster cible.

Les liens marqués (en ligne) requièrent un accès à Internet. Chaque lien permet de lancer une recherche dans la rubrique du centre de documentation en ligne. Lorsque les résultats s'affichent, sélectionnez la rubrique correspondant le mieux à votre configuration.

Vérifiez la présence de mises à jour dans cette rubrique (en ligne)

Nom du fichier : OSGi_BLA_BlueprintResourceRefs.html