Über den EndpointLookup-Knoten (Registry-Suchknoten) greifen Sie auf Servicemetadaten zu, die sich im WebSphere Service Registry and Repository befinden.
Dieser generische Knoten ruft Service-Endpunktdaten zu einem WebSphere Service Registry and Repository-Service ab, zum Beispiel WSDL-Daten. Der EndpointLookup-Knoten ist unabhängig von anderem Domänenkontext, und die Unterstützung ist derzeit auf die Abfrage von Endpunkten für Web-Services beschränkt.
Der EndpointLookup-Knoten stellt eine Abfrageschnittstelle bereit, über die Sie einzelne oder alle Endpunkte auswählen und Umgebungsparameter einrichten können, über die Web-Service-Aufrufknoten Anforderungen an die ausgewählten Services übergeben können.
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 EndpointLookup-Knoten unterstützt die Knoten SOAPRequest, SOAPAsyncRequest und HTTPRequest. Außerdem generiert der EndpointLookup-Knoten SOAPRequest-, SOAPAsyncRequest- oder HTTPRequest-Knotenformate.
Der EndpointLookup-Knoten ist im Ablagefach Web-Services der Nachrichtenflussknotenpalette enthalten und wird in der Workbench durch folgendes Symbol dargestellt:
Der EndpointLookup-Knoten kann zur dynamischen Definition einer Abfrage innerhalb einer Nachricht verwendet werden. Sowohl der EndpointLookup- als auch der RegistryLookup-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 von angepassten Eigenschaften 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.
Die Metadateninformationen werden an das Ausgangsterminal weitergegeben. Dort stehen sie ESQL oder dem JavaCompute-Knoten zur Weiterverarbeitung zur Verfügung.
Beispiel: Der einem EndpointLookup-Knoten vorangehende Knoten empfängt eine Nachricht und leitet diese an den EndpointLookup-Knoten weiter. Der EndpointLookup-Knoten verwendet die Informationen in seinen Eigenschaften zur Abfrage des WebSphere Service Registry and Repository. Die Abfrage gibt je nach Einstellung der Eigenschaft Übereinstimmungsrichtlinie (Eine oder Alle) ein oder mehrere Ergebnisse zurück. Die empfangenen Informationen werden der LocalEnvironment-Baumstruktur hinzugefügt und an das Ausgangsterminal weitergeleitet. Falls kein Ergebnis zurückgegeben wird, wird eine Nachricht an das NoMatch-Terminal gesendet.
Der EndpointLookup-Knoten kann in jedem Nachrichtenfluss verwendet werden, der auf Servicemetadaten im WebSphere Service Registry and Repository zugreifen muss.
Sie können Beispiele nur anzeigen, wenn Sie das Information Center verwenden, das im Message Broker Toolkit integriert ist.
Nachdem Sie eine Instanz des EndpointLookup-Knotens in einen Nachrichtenfluss eingereiht haben, können Sie den Knoten konfigurieren; siehe Nachrichtenflussknoten konfigurieren. Die Knoteneigenschaften werden in der Eigenschaftenansicht angezeigt.
Konfigurieren Sie denEndpointLookup -Knoten.
In der folgenden Tabelle werden die EndpointLookup-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 Endpunktinformationen 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 EndpointLookup-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 EndpointLookup-Knotens beschrieben:
| Eigenschaft | O | K | Standard | Beispiel |
|---|---|---|---|---|
| Porttypname | Nein | Ja | - | Ein Namens-Tupel, das einen in WebSphere Service Registry and Repository definierten WSDL-Service-Porttyp eindeutig identifiziert. Einer der drei Parameter muss angegeben werden. Wenn Sie alle drei Eigenschaften leer lassen, erhalten Sie beim Speichern eine Fehlernachricht. |
| Porttypnamespace | Nein | Ja | - | |
| Porttypversion | Nein | Ja | - | |
| Benutzereigenschaften | Nein | Nein | - | Ermöglicht in einer Abfrage die Definition benutzerdefinierter Eigenschaften für den Port. |
| 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. |