Blueprint-Ressourcenreferenzen [Einstellungen]

Blueprint-Komponenten können auf Ressourcenreferenzen von WebSphere Application Server zugreifen. Jede Referenz wird in einer Blueprint-XML-Datei deklariert und kann mit einem JCA-Authentifizierungsalias (Java™ Platform, Enterprise Edition (Java EE) Connector Architecture) gesichert werden. Jedes Bundle in einer OSGi-Anwendung kann eine beliebige Anzahl an Ressourcenreferenzdeklarationen in ihren verschiedenen Blueprint-XML-Dateien enthalten.

Zum Aufrufen dieser Anzeigen in der Administrationskonsole klicken Sie auf einen der folgenden Pfade:

Anwendungen > Anwendungstypen > Geschäftsanwendungen > Anwendungsname > [Implementierte Assets] Hinzufügen > Asset hinzufügen > Asset-Name > Assistentenschritt: Blueprint-Ressourcenreferenzen binden
Anwendungen > Anwendungstypen > Geschäftsanwendungen > Anwendungsname > Name_der_Kompositionseinheit > [Weitere Eigenschaften] Blueprint-Ressourcenreferenzen

Der Assistentenschritt Blueprint-Ressourcen binden und die Eigenschaft Blueprint-Ressourcenreferenzen werden nur dann angezeigt, wenn das Bundle Blueprint-Ressourcenreferenzdeklarationen enthält.

Wenn Sie Ressourcenreferenzen sichern, können diese Ressourcenreferenzen nur an JCA-Authentifizierungsaliase gebunden werden, die in jedem Server oder Cluster vorhanden sind, in dem die OSGi-Anwendung implementiert wird. Eine OSGi-Anwendung kann in mehreren Servern und Clustern derselben Sicherheitsdomäne implementiert werden. Deshalb muss jeder JCA-Authentifizierungsalias entweder in der Sicherheitsdomäne der Zielserver und Zielcluster oder in der globalen Sicherheitsdomäne vorhanden sein.

Sie müssen die Ressourcenreferenzen in der Blueprint-XML-Datei deklarieren. Beispiel:

<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0" 
  xmlns:rr="http://www.ibm.com/appserver/schemas/8.0/blueprint/resourcereference">
  <!-- Weitere Blueprint-Deklarationen... -->
  
  <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>

Diese Deklaration enthält die Ressourcenreferenz-ID (z. B. resourceRef), den Servicefilter (z. B. jdbc/Account), den Authentifizierungstyp (z. B. Container) und die Einstellung für gemeinsame Nutzung (z. B. Shareable).

Die Bindungen der Blueprint-Ressourcenreferenzen an Authentifizierungsaliase für jedes Bundle sind in einer Datei mit dem Namen ibm-eba-bnd.xml im Verzeichnis META-INF des Bundles gespeichert. Wenn eine OSGi-Anwendung diese Dateien enthält, wenn sie als Asset implementiert wird, enthalten diese Dateien die Standardauthentifizierungsaliaswerte, die bei der Bindung der Ressourcenreferenzen verwendet werden. Beispiel:

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

Allgemeine Eigenschaften

Verbundbundle-ID

Diese ID wird nur angezeigt, wenn das EBA-Asset Verbundbundles verwendet. Jedes Verbundbundle wird anhand einer Zeichenfolge identifiziert, die das folgende Format hat: Composite bundle archive (CBA)'symbolischer.Name.des.Verbundbundles_Version.des.Verbundbundles'. Bundles, die zu einem Verbundbundle gehören, werden unter der ID des Verbundbundles aufgelistet.

Symbolischer Name des Verbundbundles: Der nicht lokalisierbare Name für dieses Verbundbundle.
Version des Verbundbundles: Die Version dieses Verbundbundles.

Der symbolische Name bildet zusammen mit der Version eine eindeutige Kennung eines Verbundbundles.

Bundle-ID

Jedes Bundle wird über eine Zeichenfolge identifiziert, die den symbolischen Name des Bundles und die Bundleversion enthält. Bundles, die zu einem Verbundbundle gehören, werden unter der ID des Verbundbundles aufgelistet.

Symbolischer Name des Bundles

Der nicht lokalisierbare Name für dieses Bundle.

Bundleversion

Die Version dieses Bundles.

Der symbolische Name des Bundles bildet zusammen mit der Bundleversion die eindeutige Kennung eines Bundles.

Ressourcenreferenz-ID

Die im Blueprint deklarierte ID der Ressourcenreferenz.

Ressourcenreferenzschnittstelle

Die Schnittstelle für diese Ressourcenreferenz.

Ihre Blueprint-Anwendung kann jeden der folgenden Ressourcentypen verwenden:

JMS-Warteschlangenziele für Standard-Messaging
JMS-Topicziele für Standard-Messaging
Datenquelle
Generische JMS-Verbindungsfactory
Mailsitzung
J2C-Verbindungsfactory
JMS-Warteschlangenverbindungsfactory für den JMS-Provider von WebSphere MQ
JMS-Warteschlangenziel für WebSphere MQ
JMS-Topicverbindungsfactory für WebSphere MQ
JMS-Topicziel für WebSphere MQ
Einheitliche JMS-Verbindungsfactory für WebSphere MQ
URL-Konfiguration

Servicefilter für Ressourcenreferenz

Der Name des Servicefilters, der das Zuordnungsziel der Ressourcenreferenz ist, z. B. jdbc/AccountDS2.

Ressourcenreferenzauthentifizierung

Die Ressourcenreferenz wird entweder durch die Anwendung oder durch den Container authentifiziert.

Gemeinsame Nutzung der Ressourcenreferenz

Die Ressourcenreferenz ist entweder gemeinsam nutzbar oder nicht gemeinsam nutzbar.

Authentifizierungsalias

Der Authentifizierungsalias, sofern vorhanden, der für die Sicherung der Ressourcenreferenz verwendet wird.

Für jede Referenz können Sie optional einen Authentifizierungsalias in der Liste auswählen. Standardauthentifizierungsaliase (aus Dateien mit dem Namen ibm-eba-bnd.xml) werden nur angeboten, wenn sie in jedem Zielserver bzw. -cluster vorhanden sind.

Mit (online) gekennzeichnete Links setzen einen Internet-Zugang voraus. Jeder Link startet eine Suche nach diesem Artikel im online verfügbaren Information Center. Wählen Sie in der angezeigten Liste der Suchergebnisse den Artikel aus, der sich am besten für Ihre Konfiguration eignet.

Nach Aktualisierungen für diesen Artikel suchen (online)

Dateiname: OSGi_BLA_BlueprintResourceRefs.html