Beispielcode für benutzerdefinierte Erweiterungen wird Ihnen
wie folgt angezeigt:
- Verwenden Sie das im WebSphere Message
Broker Toolkit enthaltene Beispiel. Informationen hierzu finden Sie unter User-defined Extension.
Informationen zu Beispielen können nur bei Verwendung des in das WebSphere Message
Broker Toolkit integrierten bzw. online verfügbaren Information Center angezeigt werden. Muster können nur ausgeführt werden, wenn das im
WebSphere Message
Broker Toolkit integrierte Information Center verwendet wird.
- Verwenden Sie Beispielcode, der mit WebSphere Message
Broker installiert wird. Informationen zur Verwendung von Beispielcode finden Sie in diesem Abschnitt.
Der Beispielcode besteht aus einem Beispielparser und folgenden Beispielknoten:
| Knoten |
Beschreibung |
| Switch |
Ein Knoten, der sowohl in C- als auch in Java-Versionen implementiert ist und der eine Eingabenachricht je nach Nachrichteninhalt an eines der Ausgabeterminals weiterleitet. |
| Transform |
Ein Knoten, der sowohl in C- als auch in Java-Versionen implementiert ist und eine einfache Nachrichtenumsetzung ausführt. |
Jeder Musterknoten besteht aus den Quellendateien und einigen Dateien, die zum
Testen der einzelnen Knoten verwendet werden können. Für den Musterparser sind nur Quellendateien
vorhanden. Ausführliche Informationen zu den Musterdateien und deren Speicherort finden Sie unter Musterknotendateien und Musterparserdateien.
So implementieren Sie die bereitgestellten Beispiele
aus dem mit
WebSphere Message
Broker installierten Beispielcode:
- Kompilieren Sie die Beispielcodes. Informationen zum Kompilieren eines Java-Knotens finden Sie unter Benutzerdefinierten Java-Knoten kompilieren. Informationen zum Kompilieren eines C-Knotens oder -Parsers finden Sie unter Benutzerdefinierte C-Erweiterung kompilieren.
- Installieren Sie die benutzerdefinierte Erweiterung in einer Brokerdomäne. Anweisungen zu diesem Schritt finden Sie im Abschnitt
Laufzeitdateien für benutzerdefinierte Erweiterung auf einem Broker installieren.
- Kopieren und extrahieren Sie die Datei SampleNodesProject.zip
wie folgt:
- Kopieren Sie von einem Computer mit installiertem WebSphere Message
Broker die
Datei SampleNodesProject.zip auf einem Computer
mit installierter WebSphere Message
Broker Toolkit. Die .zip-Datei
befindet sich im Unterverzeichnis sample. Beispiel: Unter Windows finden Sie die Datei SampleNodesProject.zip im
Verzeichnis Installationsverzeichnis\sample\extensions\nodes\com.ibm.samples.nodes.
Dabei ist Installationsverzeichnis das
Ausgangsverzeichnis der WebSphere Message
Broker-Installation.
- Extrahieren Sie auf dem Computer mit installierter WebSphere Message
Broker Toolkit die Datei SampleNodesProject.zip und kopieren Sie die extrahierten Dateien in ein Verzeichnis, in dem die
WebSphere Message
Broker Toolkit darauf zugreifen kann. Weitere Informationen zu den Positionen, in die die Dateien kopiert werden sollen, finden Sie im Abschnitt Benutzerdefinierte Erweiterung für aktuelle und frühere Versionen von WebSphere Message Broker installieren.
- Öffnen Sie das WebSphere Message
Broker Toolkit und wechseln Sie zur
Ansicht 'Brokeranwendungsentwicklung'. Die Kategorie 'Sample nodes' (Musterknoten) wird nun in der Palette angezeigt, und die Musterknoten werden darunter angezeigt. Eine Dokumentation zu den
Musterknoten finden Sie im Hilfesystem unter 'Samples' (Muster).
- Fügen Sie die Musterknoten in einen Nachrichtenfluss ein (siehe Nachrichtenflussknoten hinzufügen).
- Implementieren Sie den Nachrichtenfluss. Informationen hierzu finden Sie im Abschnitt Implementieren.
- Sie können für den Switch- und den Transform-Knoten eine Nachricht in die Eingabewarteschlange
des Nachrichtenflusses stellen und die Ergebnisse beobachten. Gehen Sie dazu wie folgt vor:
- Stellen Sie sicher, dass der Nachrichtenfluss, der den Beispielknoten enthält, erfolgreich implementiert wurde (siehe Abschnitt
Ergebnisse der Implementierung überprüfen).
- Reihen Sie die Beispieleingabenachrichten (enthalten in .xml-Dateien) mithilfe der Funktion zum Einreihen von Nachrichten in die im Eingabeknoten des Nachrichtenflusses benannte Eingabewarteschlange ein (siehe Abschnitt Debug: Testnachricht in Eingabewarteschlange einreihen).
Die Vorgänge in Ihrem Nachrichtenfluss können auch unter Verwendung eines Traceknotens oder des Fluss-Debuggers beobachtet werden.