RegistryLookup-Knoten

Über den RegistryLookup-Knoten (Registry-Suchknoten) greifen Sie auf Servicemetadaten zu, die sich im WebSphere Service Registry and Repository befinden.Der RegistryLookup-Knoten führt über die Filterung bzw. Auswahl des Eigenschaftenabgleichs hinaus keine weitere Filterung oder Auswahl durch.

Dieses Kapitel enthält folgende Abschnitte:

Zweck

Auf die Servicemetadaten im WebSphere Service Registry and Repository können Sie über zwei Knoten zugreifen: über den EndpointLookup-Knoten und den RegistryLookup-Knoten. Diese Knoten können in Nachrichtenverarbeitungsabläufen eingefügt werden, die innerhalb einer SOA-Installation zwischen Servicekonsumenten und Serviceanbietern vermitteln. Diese Knoten sind für den generischen WebSphere Service Registry and Repository-Zugriff vorgesehen.

Der RegistryLookup-Knoten ist im Ablagefach Web-Services der Nachrichtenflussknotenpalette enthalten und wird in der Workbench durch folgendes Symbol dargestellt:

Symbol für RegistryLookup-Knoten

Verarbeitung des RegistryLookup-Knotens

Die Nachrichtenverarbeitungssequenz des RegistryLookup-Knotens sieht wie folgt aus:
  1. Der RegistryLookup-Knoten empfängt eine Nachricht.
  2. Der RegistryLookup-Knoten ruft die Entitäts-Metadateninformationen aus dem WebSphere Service Registry and Repository mit Hilfe der angegebenen Abfragezeichenfolge ab.

    Der RegistryLookup-Knoten kann zur dynamischen Definition einer Abfrage innerhalb einer Nachricht verwendet werden. Sowohl der RegistryLookup- als auch der EndpointLookup-Knoten kann eine innerhalb der 'LocalEnvironment' definierte Abfrage annehmen. Die Annahme einer Abfrage aus der 'LocalEnvironment' überschreibt alle im Knoten eingestellten Eigenschaften. Die Werte sind in diesem Fall Zeichenfolgen. XPath und ESQL werden für die Definition der Benutzereigenschaften in der 'LocalEnvironment' nicht unterstützt. Wenn Sie die 'LocalEnvironment' zur Einstellung der Eigenschaften verwenden, müssen Sie die Eigenschaften nicht bereits bei der Entwicklung definieren, sondern Sie können dies auch während der Laufzeit bzw. während der Nachrichtenverarbeitung tun. Dazu verwenden Sie das Format LocalEnvironment.ServiceRegistryLookupProperties.Name, wobei Sie statt Name die Eigenschaft eingeben, die Sie definieren möchten. Nach wie vor ist es allerdings erforderlich, für die Eigenschaften der Knoten Werte festzulegen, da die Knoten ohne diese Werte nicht implementiert werden können.

  3. Bei einem oder mehreren Übereinstimmungen:
    • Wenn Übereinstimmungsrichtlinie auf Eine gesetzt ist, fügt der RegistryLookup-Knoten nur eine übereinstimmende Metadateninformation zur Nachrichteninstanz hinzu. Wenn mehrere mögliche Übereinstimmungen gefunden werden, ruft der RegistryLookup-Knoten nur eine dieser Übereinstimmungen in beliebiger Auswahl ab.
    • Wenn Übereinstimmungsrichtlinie auf Alle gesetzt ist, fügt der RegistryLookup-Knoten alle übereinstimmenden Metadaten zur Nachrichteninstanz hinzu. Der verbleibende Nachrichteninhalt bleibt dabei unverändert.

    Die Metadateninformationen werden an das Ausgangsterminal weitergegeben. Dort stehen sie ESQL oder dem JavaCompute-Knoten zur Weiterverarbeitung zur Verfügung.

  4. Wenn keine Übereinstimmungen gefunden werden, gibt der RegistryLookup-Knoten die Eingabenachricht an das NoMatch-Terminal weiter.

Beispiel: Der RegistryLookup-Knoten kann zur Auswahl der aktuellen Endpunktadresse aus mehreren Version-Eigenschaften verwendet werden. Falls es sich beim Ziel nicht um einen Web-Service handelt, können Sie mit dem RegistryLookup-Knoten Entitäts-Metadaten abrufen, die unter anderem auch die Endpunktadresse enthalten können. Die Eigenschaft Übereinstimmungsrichtlinie muss in diesem Fall auf Alle gesetzt sein. Mit Hilfe eines Transformationsknotens, beispielsweise eines JavaCompute-, Compute-, XSLTransform- oder Zuordnung-Knotens können Sie die aktuelle Version auswählen, die Endpunktadresse einstellen und einen geeigneten Transport-Header hinzufügen. Die LocalEnvironment-Baumstruktur muss mit der Nachricht weitergeleitet werden.

Den RegistryLookupknoten konfigurieren

Nachdem Sie eine Instanz des RegistryLookup-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.

Konfigurieren Sie denRegistryLookup -Knoten.

  1. Optional: Geben Sie auf der Registerkarte Beschreibung eine Kurzbeschreibung, eine Ausführliche Beschreibung oder beides ein. Sie können den Knoten dort auch umbenennen.
  2. Auf der Registerkarte Grundeinstellung:
    1. Geben Sie für die Entitäten oder Artefakte, die Sie aus dem WebSphere Service Registry and Repository abrufen möchten, die Zeichenfolge-Werte für einen oder mehrere der folgenden Parameter an: Name, Namespace und Version . Einer der drei Parameter muss angegeben werden. Wenn Sie alle drei Eigenschaften leer lassen, erhalten Sie beim Speichern eine Fehlernachricht.
    2. (Optional) Geben Sie den Zeichenfolge-Wert für Schablone ein. Damit definieren Sie den Schablonen- bzw. Artefakttyp, der aus dem WebSphere Service Registry and Repository zurückgegeben werden soll.
    3. (Optional) Klicken Sie auf Hinzufügen, um Benutzereigenschaften hinzuzufügen. Mittels Benutzereigenschaften können Sie in einer Abfrage benutzerdefinierte Eigenschaften festlegen. Mit Benutzereigenschaften sind in diesem Zusammenhang die angepassten Eigenschaften gemeint, die zur Katalogisierung der Entitäten im WebSphere Service Registry and Repository verwendet werden. Geben Sie Werte für die Parameter Eigenschaftsname, Eigenschaftstyp und Eigenschaftswert ein. Der Eigenschaftstyp kann eine Zeichenfolge (Standard) oder ein XPATH- oder ESQL-Ausdruck sein. Der Eigenschaftstyp bezieht sich auf den Typ der unter Eigenschaftswert angegebenen Eigenschaft.
    4. (Optional) Fügen Sie eine Klassifizierung hinzu. Klicken Sie dazu auf Hinzufügen, und geben Sie den Namen der Klassifizierung ein. Die hier definierten Klassifizierungen entsprechen dem Klassifizierungssystem Web Ontology Language (OWL). Jedes Klassifizierungsmerkmal entspricht einer OWL-Klasse und verfügt über einen Uniform Resource Identifier (URI). Durch die Verwendung von Klassifizierungen in der Registry lassen sich Objekte leichter finden. Außerdem erhalten speziell für ein bestimmtes System angepasste Objekte durch Klassifizierungen unter Umständen mehr Bedeutung.
    5. Wählen Sie die Übereinstimmungsrichtlinie aus. Wählen Sie Eine aus, um nur eine Übereinstimmung zurückzugeben. Wählen Sie Alle aus, um alle Übereinstimmungen zurückzugeben.

Terminals und Eigenschaften

In der folgenden Tabelle werden die RegistryLookup-Knotenterminals beschrieben .

Terminal Beispiel
In Das Eingabeterminal, das eine Nachricht zur Verarbeitung durch einen Knoten annimmt
Failure Das Ausgabeterminal, an das die Nachricht geleitet wird, wenn ein Fehler auftritt.
Out Das Ausgabeterminal, an das übereinstimmende Registry-Informationen gesendet werden.
NoMatch Das Terminal, an das die Nachricht gesendet wird, wenn auf Grundlage der angegebenen Werte keine übereinstimmende Entität gefunden wird.

In den folgenden Tabellen werden die Knoteneigenschaften beschrieben. Die Spalte M zeigt an, ob die Eigenschaft obligatorisch ist (markiert mit einem Sternchen, wenn ein Wert eingegeben werden muss, weil kein Standardwert definiert ist). Die Spalte C zeigt an, ob die Eigenschaft konfigurierbar ist (Wert kann geändert werden, wenn der Nachrichtenfluss zur BAR-Datei hinzugefügt wird, um ihn einzusetzen).

In der folgenden Tabelle werden die Beschreibungseigenschaften des RegistryLookup-Knotens beschrieben:

Eigenschaft O K Standard Beispiel
Knotenname Nein Nein Knotentyp Name des Knotens.
Kurzbeschreibung Nein Nein - Kurze Beschreibung des Knotens.
Ausführliche Beschreibung Nein Nein - Text, der den Zweck des Knotens im Nachrichtenfluss beschreibt

In der folgenden Tabelle werden die Grundeinstellungseigenschaften des RegistryLookup-Knotens beschrieben:

Eigenschaft O K Standard Beispiel
Name Nein Ja - Ein Namens-Tupel, das eine WebSphere Service Registry and Repository-Entität eindeutig identifiziert. Einer der drei Parameter muss angegeben werden. Wenn Sie alle drei Eigenschaften leer lassen, erhalten Sie beim Speichern eine Fehlernachricht.
Namespace Nein Ja -
Version Nein Ja -
Schablone Nein Ja - Der Schablonen- bzw. Artefakttyp, der aus dem WebSphere Service Registry and Repository zurückgegeben werden soll.
Benutzereigenschaften Nein Ja - Ermöglicht in einer Abfrage die Definition benutzerdefinierter Eigenschaften.
Klassifizierung Nein Ja - Die Eigenschaft des OWL-Klassifizierungssystems.
Übereinstimmungsrichtlinie Ja Ja Eine Die zurückzugebenden Richtlinien. Wählen Sie Eine aus, wenn nur eine Richtlinie mit den Suchkriterien abgeglichen werden soll, bzw. Alle, wenn alle Richtlinien abgeglichen werden sollen.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac55900_