fb
WSO2 5 Minuten

Arbeiten mit Samples in Integration Studio

Rob Blaauboer
Rob Blaauboer
Integration Consultant & WSO2 Trainer
Blog Sampling in WSO2
Scrollen

In einem früheren Blog haben wir die Samples besprochen, die im Enterprise Integrator enthalten sind. Nun schauen wir uns die Samples an, die Teil der Getting Started Funktionalität von Integration Studio sind. Welche Vorteile haben diese Samples im Vergleich zu den Samples, die im Produkt enthalten sind? Das werden wir in diesem Blog beantworten.

Samples Integration Studio 1

Wie Sie auf dem Screenshot sehen können, gibt es mehrere Samples. Diese ermöglichen die Fehlerbehandlung, das Arbeiten mit Docker, JMS, Unit Testing Message Transformation und so weiter.

Was passiert nun, wenn Sie auf eines der Icons klicken? Betrachten wir ein Hello World als Sample. Warum dieses? Ganz einfach, weil Hello World oft der Startpunkt ist, ein einfaches Sample, um loszulegen.

Samples Integration Studio 2

Starten wir mit dem Hello World Service. Damit wird sofort ein Projekt im Integration Studio erstellt. In diesem Projekt haben wir einen Composite Exporter, um sicherzustellen, dass die Autodatei an den Enterprise Integrator deployed wird. Es gibt eine API namens Hello World API, die aus einer sehr einfachen Payload Factory im Response Mediator besteht. Und es zeigt auch wie man mit diesem Sample arbeiten kann.

Das hat den Vorteil, dass wir uns nicht mit dem Anlegen eines Projektes herumärgern müssen. Nicht, dass das Erstellen eines Projekts so eine große Sache wäre, aber ich kann mir vorstellen, dass es hilfreich sein kann, wenn Sie neu in Integration Studio und/oder Enterprise Service Bus Technologie sind. Im vorherigen Blog über Samples habe ich beschrieben, wie man ein Projekt wie dieses erstellt.

Samples Integration Studio 3

Wie Sie erkennen können, ist die API recht einfach. 

Samples Integration Studio 4

Die Grafikübersicht zeigt den High-Level-Flow. Wenn wir mehr wissen wollen, müssen wir in die Quelltextansicht wechseln.

Samples Integration Studio 5

Wiederum zeigt die Quellansicht eine JSON-Antwort mit dem berühmten Hello World und dann wird die Antwort an den Client zurückgegeben.

Samples Integration Studio 6

Wenn Sie dies auf dem Enterprise Integrator ausführen wollen, müssen Sie zuerst einen solchen installieren. In der Regel ist das die Installation von JDK 8 oder 11, das Setzen von Java_home, das Hinzufügen der Java-Installation zum Pfad und das Entpacken des WSO2-Produkts in ein Verzeichnis. 

Integration Studio für die Einführung von Enterprise Integrator 

Das Integration Studio kann verwendet werden, um eine Version des Enterprise Integrator zu starten. Dieses Setup hat den Vorteil, dass Sie die Konsolenmeldungen in der gleichen Umgebung wie die Entwicklungswerkzeuge haben. 

In den Samples innerhalb von Integration Studio wird auch beschrieben, wie man es in einer solchen Umgebung ausführt. Nach der beschriebenen Installation können Sie über die Schaltfläche „Server hinzufügen“ in der Registerkarte „Erste Schritte“ einen Server zur Konfiguration hinzufügen.

Samples Integration Studio 7

Wählen Sie einfach die Version des Enterprise Integrators aus, klicken Sie auf die Schaltfläche „Weiter“ und geben Sie den Ort an, an dem der Enterprise Integrator installiert ist. Im vorliegenden Fall ist er unter Windows auf dem Desktop in einem Unterverzeichnis installiert. Verweisen Sie auf dieses Verzeichnis und stellen Sie sicher, dass Integration Studio weiß, wo es die Konfigurationen finden kann, die es zum Starten des Produkts benötigt. 

Samples Integration Studio 8

Wenn Sie dies getan haben, können Sie sehen, dass der Server jetzt verfügbar ist. Allerdings befindet sich der Server in einer anderen Registerkarte als die Registerkarten Eigenschaften und Konsole, was ich persönlich unpraktisch finde. Wechseln Sie zur Registerkarte „Server“, klicken Sie mit der linken Maustaste und halten Sie sie gedrückt, um die Registerkarte „Server“ auf die Registerkarten „Eigenschaften“, „Konsole“ und „HTTP-Client“ am unteren Rand des Bildschirms zu ziehen. Wählen Sie mit der rechten Maustaste den Enterprise Integrator-Server und wählen Sie „Starten“. Der Server sollte in die Konsole umschalten, falls dies nicht schon automatisch geschieht, um die Informationen über den Startvorgang zu sehen, die angezeigt werden. WSO2-Produkte geben Protokollinformationen aus, die Ihnen sagen, ob die Installation erfolgreich war oder nicht!

Samples Integration Studio 9

Wenn Sie die Management-URL sehen, die auf der Konsole angezeigt wird, wissen Sie, dass das Produkt jetzt einsatzbereit ist. Wenn Sie den Startvorgang nicht geändert haben, wird auch ein Browser-Fenster zur Management-URL geöffnet, so dass Sie sich beim Produkt anmelden können.

Samples Integration Studio 10

Die Admin-Zugangsdaten ermöglichen es Ihnen, sich als Superuser des Produkts anzumelden. Mithilfe dieser Anmeldeinformationen können Sie fast jeden Aspekt des Produkts manipulieren. Bedenken Sie, dass es sich um eine Standardinstallation handelt, die einen selbstsignierten und standardmäßigen Schlüsselspeicher verwendet, der natürlich geändert werden muss, ebenso wie das Kennwort des Admin-Benutzers, da der Admin die bereits erwähnten Superkräfte hat.

Samples Integration Studio 11

Anschließend müssen wir den Composite-Exporter, bzw. die darunter liegende Autodatei, zum Enterprise Integrator hinzufügen. Das geht u.a. über Hinzufügen und Entfernen, eine kontextabhängige Option, die durch Rechtsklick auf den Enterprise Integrator 6.6.0 verfügbar ist.

Falls alles gut geht, und warum sollte es nicht, sehen Sie jetzt eine Meldung auf der Konsole, dass die API bereitgestellt wurde.

[2021-06-28 13:21:33,889]  INFO {org.wso2.carbon.mediation.dependency.mgt.DependencyTracker} - API : HelloWorld was added to the Synapse configuration successfully - [ Deployed From Artifact Container: MyProjectCompositeExporter ] 
[2021-06-28 13:21:33,890]  INFO {org.apache.synapse.deployers.APIDeployer} - API named 'HelloWorld' has been deployed from file : C:\Users\rob\Desktop\WSO2\wso2ei-6.6.0\tmp\carbonapps\-1234\1624879293853MyProjectCompositeExporter_1.0.0-SNAPSHOT.car\HelloWorld_1.0.0\HelloWorld-1.0.0.xml
[2021-06-28 13:21:33,891]  INFO {org.wso2.carbon.application.deployer.internal.ApplicationManager} - Successfully Deployed Carbon Application : MyProjectCompositeExporter_1.0.0-SNAPSHOT {super-tenant}

Das bedeutet, dass die API jetzt zur Verwendung zur Verfügung steht und wir sie auf verschiedene Arten aufrufen können. Wir können die Soap UI, Postman, Advanced Rest Client, Curl oder sogar einen einfachen Browser verwenden. Der Grund, warum wir einen Browser verwenden können, ist, dass wir ein Get ausführen, das Informationen abruft und keine zu sendende Nutzlast erfordert. Da in dieser API auch keine Parameter definiert sind, wenn wir http://localhost:8280/HelloWorld eintippen

Samples Integration Studio 12

Wir können die Antwort in JSON im Browser sehen. Wenn Sie auf Raw Data und Header klicken, erhalten Sie weitere Informationen über den API-Aufruf.

Fazit

Es gibt mehrere Samples, die in der Integration Studio-Umgebung enthalten sind, die leicht zu verwenden sind und nicht so viel Wissen über Enterprise Integrator und/oder Integration Studio erfordern. Sie sind daher ideal für Einsteiger geeignet. Obwohl das oben gezeigte Beispiel sehr einfach ist, sind die anderen Samples ausführlicher und können Ihnen helfen, das Prinzip zu verstehen und es vielleicht für Ihre Bedürfnisse zu übernehmen.