Informationen zum Beispielcode 'Scribble'

Im Beispielcode 'Scribble' wird die Publish/Subscribe-Nachrichtenübertragung zum Transport von Daten verwendet. Weitere Informationen finden Sie in der IBM Integration Bus-Dokumentation unter Publish/Subscribe.

Scribble-Publisher und Scribble-Subskribenten transportieren Veröffentlichungsnachrichten über den Java Message Service und WebSphere MQ als zugrunde liegender Transportschicht.

Mit dem Beispielcode 'Scribble' wird Folgendes ausgeführt:

1. Wenn Sie die Anwendung 'Scribble-Subskribent' starten, richtet diese eine Subskription für die Themen scribble/coords und scribble/clear ein.
2. Sobald Sie im Fenster 'Scribble-Publisher' eine Zeichnung erstellen, werden die Koordinaten Ihrer Zeichnung von 'Scribble-Publisher' zum Thema scribble/coords für den Nachrichtenfluss 'ScribblePublish' veröffentlicht.
3. Der Nachrichtenfluss überprüft, ob die Nachricht zum Thema scribble/coords veröffentlicht wurde, und wandelt die Koordinaten in der Veröffentlichungsnachricht um.
4. Die Anwendung 'Scribble-Subskribent' empfängt die Nachrichten, die die umgewandelten Koordinaten enthalten, da es Veröffentlichungen zum Thema scribble/coords abonniert, d. h. eine Subskription dafür eingerichtet hat.
5. Wenn Sie in der Anwendung 'Scribble-Publisher' auf Inhalt löschen klicken, wird von dieser Anwendung eine Nachricht zum Thema 'scribble/clear' für den Nachrichtenfluss 'ScribblePublish' veröffentlicht.
6. Die Nachrichtendaten werden vom Nachrichtenfluss nicht umgewandelt, da die Nachricht nicht zum Thema scribble/coords veröffentlicht wurde.
7. Die Anwendung 'Scribble-Subskribent' empfängt die Nachricht jedoch, da sie für Veröffentlichungen zum Thema scribble/clear eine Subskription eingerichtet hat.

In den folgenden Abschnitten werden die Ressourcen für den Beispielcode ausführlicher beschrieben:

• Die Nachrichten
• Der Nachrichtenfluss
• Der ESQL-Code
• Der Nachrichtentransport

Nachrichten

Der Beispielcode 'Scribble' nutzt JMS-Nachrichten von WebSphere MQ.

Allen Nachrichten ist eine standardmäßige Nachrichtenschablone zugeordnet, die folgende Teile enthält:

• Einen WebSphere MQ-Header, der vom Nachrichtenfluss zur Identifizierung des Nachrichtenformats und zur Ermittlung des für die Syntaxanalyse der Nachricht zu verwendenden Parsers herangezogen wird.
• Einen MQRFH2-Header, der das Nachrichtenformat definiert und die Publish/Subscribe-Befehle enthält.
• Einen in XML formatierten Nachrichtenhauptteil, der die folgenden Zeichnungskoordinaten angibt:

  <coords>
     <x1>point</x1>
     <y1>point</y1>
     <x2>point</x2>
     <y2>point</y2>
  </coords>

Der Veröffentlichungsknoten im Nachrichtenfluss veröffentlicht WebSphere MQ-Nachrichten für Anwendungen des Typs 'Scribble-Subskribent'.

Weitere Informationen finden Sie in der IBM Integration Bus-Dokumentation unter WebSphere Broker-JMS-Transport.

Der Nachrichtenfluss

Im folgenden Diagramm ist der Nachrichtenfluss 'ScribblePublish' dargestellt, von dem die Veröffentlichungsnachrichten im Beispielcode 'Scribble' verarbeitet werden.

In der folgenden Tabelle sind die Knotentypen aufgelistet, die im Nachrichtenfluss 'ScribblePublish' verwendet werden.

Weitere Informationen zu den Knoten, die im Nachrichtenfluss 'ScribblePublish' verwendet werden, finden Sie in der IBM Integration Bus-Dokumentation unter Integrierte Knoten.

Der Nachrichtenfluss 'ScribblePublish' wandelt die von der Anwendung 'Scribble-Publisher' veröffentlichten Koordinaten um und veröffentlicht anschließend die neuen Koordinaten für die Anwendung 'Scribble-Subskribent'. Weitere Informationen finden Sie in der IBM Integration Bus-Dokumentation unter Nachrichtenflüsse - Übersicht.

Der Nachrichtenfluss 'ScribblePublish' führt folgende Aktionen aus:

1. Der Knoten SCRIBBLE_PUBLICATION ruft die Veröffentlichungsnachricht aus der Warteschlange SCRIBBLE_PUBLICATION ab.
2. Er filtert die Veröffentlichungsnachricht nach deren Thema:
   • Falls die Nachricht zum Thema scribble/coords veröffentlicht wurde, wird sie über den Knoten 'Invert Coordinates' weitergeleitet.
   • Falls die Nachricht nicht zum Thema scribble/coords veröffentlicht wurde oder das Thema nicht vom Filterknoten identifiziert werden kann, wird die Nachricht direkt an den Veröffentlichungsknoten weitergeleitet. Dieses Szenario gilt für Nachrichten, die zum Thema scribble/clear veröffentlicht wurden.
3. Er wandelt die Koordinaten um, die zum Thema scribble/coords veröffentlicht wurden, sodass in der Anwendung 'Scribble-Subskribent' die umgekehrten Koordinaten angezeigt werden.
4. Er gibt die Nachricht aus. Die Koordinaten werden vom Nachrichtenfluss in einer Nachricht für die Warteschlange SYSTEM.JMS.ND.SUBSCRIBER.QUEUE veröffentlicht.

Der ESQL-Code

Gehen Sie folgendermaßen vor, um den ESQL-Code, der im Nachrichtenfluss 'ScribblePublish' verwendet wird, in der Workbench anzuzeigen: Klicken Sie in der Ansicht 'Anwendungsentwicklung' im IBM Integration Toolkit doppelt auf ScribblePublish.esql, um diese Ressource im ESQL-Editor aufzurufen.

Der ESQL-Code für den Knoten 'Filter On Topic' ist im Modul 'ScribblePublish_Filter' enthalten, und der ESQL-Code für den Knoten 'Invert Coordinates' befindet sich im Modul 'ScribblePublish_Compute'. Weitere Informationen finden Sie in der IBM Integration Bus-Dokumentation unter ESQL-Übersicht.

Die Nachrichtenprotokolle

Die Anwendungen 'Scribble-Publisher' und 'Scribble-Subskribent' veröffentlichen Informationen in JMS-Nachrichten. Beide Anwendungen nutzen den WebSphere MQ-Transport.

WebSphere MQ-Transport

Die Scribble-Anwendungen interagieren mit den lokalen WebSphere MQ-Warteschlangen, die in der folgenden Tabelle aufgeführt sind.

Weitere Informationen zu WebSphere MQ finden Sie in der zugehörigen Produktdokumentation.

Zurück zum Beginn des Beispielprogramms