smash-it.de

Der folgende Artikel soll helfen einen BPEL Process mit Netbeans zu erstellen und auf den Glassfish Application Server zu deployen. Doch zunächste beschreibe ich kurz das vorhaben. Der BPEL Prozess nutzt insgesamt drei Web Services (YingService, YangService und MatchService). Der YingService benötigt keinen Parameter und liefert den String "Ying" zurück. Der YangService arbeitet analog zum YingService. Diese beiden Service arbeiten parallel! Der MatchService nimmt zwei Parameter vom Typ String entgegen und konkateniert diese beiden Strings und den String "Fit". Danach wird der zusammengesetzte String vom MatchService zurückgeliefert. Die einzelnen Web Services interessieren den Benutzer des BPEL Prozesses nicht, da dieser nach außen wie ein simpler Web Service (z.B. YingService) wirkt.

Nachdem das Ziel beschrieben ist kann die Arbeit beginnen. Ich habe sehr viele Screenshots verwendet um den Weg möglichst anschaulich zu machen.

Insgesamt werden 4 Projekte angelegt. Beginnen möchte ich mit einem Projekt, dass die einzelnen WebServices (YingService, YangService und MatchService) enthält, die dann im BPEL Prozess verwendet werden.

Dazu legen wir einfach eine neue Web Application an und fügen anschließend die drei WebServices hinzu.

 

 

 

 

 

 

 

 

 

Jeder dieser WebServices hat jeweils eine Methode, die man über Add Operation hinzufügen kann. In dem dazugehörigen Dialog kann man sowohl Parameter als auch Rückgabetyp festlegen. In diesem Beispiel habe ich die Methoden sayYing(), sayYang() und concateStrings(String ying, String yang) genannt. Jede dieser Methoden gibt einen String zurück.

Das wiederholt man einfach noch für die anderen beiden Web Services.

 

 

 

 

Sind alle Web Services angelegt kann man sich daran machen ein BPEL Modul anzulegen. Dazu legt man ein neues Projekt an wählt im Dialog "SOA" und anschließend "BPEL Module".

 

In diesem BPEL Module benötigt man nun noch einen BPEL Prozess, den man über "New" ganz einfach anlegen kann. Ich habe diesen Prozess ConcatProcess.bpel genannt.

 

 

Um diesem neuen BPEL Prozess die zuvor erstellten Web Services aus dem anderen Projekt bekannt zu machen, nutzt man den komfortablen Befehl „Generate and Copy WDSL“ in dem zuvor erstellten Projekt. Als Ziel wählt man ein Verzeichnis in dem BPEL Module. Ich habe dazu ein Verzeichnis "wsdls" angelegt.

 

 

 

 

 

 

 

 

 

 

Die Abbildung links zeigt den momentanen Stand in meinem BPEL Module. Wenn die *Wrapper.wsdls und die *.xsds bei euch noch nicht vorhanden sind, liegt es daran, dass ihr die WebServices noch nicht im Prozess verwendet habt. Diese Dateien werden aber automatische erzeugt und sollten euch nicht verwundern.

Bitte überprüft an dieser Stelle den Code der wsdl Dateien. Denn beim Kopieren wurde ein URL zurückgesetzt, die nun angepasst werden muss.

Der folgende Code zeigt das Problem. Die Adress Location soll mit der aktuellen Service URL ersetzt werden.

 

 

 

 

 

...


      
    
  
...

...


      
    
  
...

Nun öffnet man den ConcatProcess.bpel und geht in den Designer Modus. Doch bevor der Process mit Hilfe des Designers erstellt wird, legt man am besten noch ein WSDL Dokument an, dass den BPEL Prozess nach außen repräsentiert.

Da der ConcatProcess keinen Eingabe-Parameter hat, kann man den Eintrag getrost entfernen.

In diesem Beispiel werden SOAP und der Binding SubType "RPC literal" verwendet.

 

 

 

 

 

 

 

In der Abbildung links sieht man erstmalig den Designer auf dem schon der Prozess zu sehen ist. Man kann nun munter die WSDL Datei auf solche Flächen ziehen, wie sie im  roten Kästchen zu sehen sind. Die drei WebServices (YingService, YangService und MatchService) zieht man auf die rechten graue Fläche und das gerade eben erstellte wsdl Dokument auf die linke graue Fläche.

Die linke Abbildung zeigt die Palette mit BPEL Elementen. Uns sollen nur die Element Invoke, Receive, Reply, Assign  und Flow interessieren.

 

Bitte positioniert die einzelnen Elemente wie links dargestellt in der Oberfläche. Um die Verbindungslinien zwischen den Elementen kümmern wir uns in den nächsten Schritten.

 

 

 

 

 

 

Zuerst macht man einen Doppelklick auf das Receive Element und nimmt die links abgebildeten Einstellungen vor.

 

 

 

 

Als nächstes macht man ein Doppelklick auf eines der Invoke Element im Flow und erstellt einen Partnerlink zum YingService. Dazu erstellt man sowohl Input als auch Output-Variable. Den Vorgang wiederholt man für den YangService.

Nun klickt man auf das oberste Assign Element und ein Mapper öffnet sich. In solch einem Mapper kann man die Variablen zwischen zwei Elementen zuordnen. Da wir im Receive keine Variable erhalten haben, erstellen wir String Literale, den Variablen SayYingIn und SayYangIn zugeordnet werden.

Bei dem nächsten Assign Element sind bereits Variablen vorhanden, sodass die Mapping Pfeile vom linken zum rechten Baum führen (siehe Abbildung links).

 

 

Im letzten Assign ordnet man die Output Variable des MatchService der Gesamt-Prozess-Output Variable zu, die man vorher im Dialog des Reply Elements erstellt.

 

 

 

 

Als nächstes legen wir ein neues Projekt (Composite Application) an, das später den BPEL Prozess benutzt.

 

 

 

 

 

Im nächsten Schritt fügen wir den erstellten Prozess der Composite Application hinzu. 

 

 

 

 

 

Nach dem Hinzufügen des Prozesses sollte die Darstellung der Composite Application in etwas so aussehen.

 

 

 

 

Nun kann es an das Deployment der einzelnen Projekte gehen. Zuerst sollte man den Glassfish Application Server starten. Ich nutze momentan noch den Server in der Version 2. Dieses Tutorial funktioniert aber auch mit der Version 3.

 

 

 

 

 

 

 

Als erstes wird das Projekt mit den drei einzelnen WebServices auf dem Server deployed. Dazu reicht ein rechtsklick auf das Projekt und Deploy. Das Deployment dauert einen Augenblick.

 

 

 

 

 

 

 

 

 

Das erfolgreiche Deployment überprüft man am besten in der Oberfläche des Glassfish Servers. Die erreicht man im Browser über localhost:4848. Die Anmeldedaten sind standardmäßig admin und adminadmin. Links unter Web Services sollten die Web Services zu sehen sein.

 

 

Nun kann man die Composite Application deployen. Diese findet man dann in der Glassfish Oberfläche unter JBI / Dienstgruppen.

 

 

 

Zum Testen der Composite Application erstellt man einfach einen WebService Client. In dem Dialog trägt man als WSDL URL das folgende ein:

http://localhost:9080/ConcatProcessService/ConcatProcessPort?wsdl

Danach sieht man den Client in der Projektstruktur. Wenn man den Baum so weit wie möglich öffnet sieht man die WebService Operation. Zieht man diese Operation mit der Maus in die main Methode sieht man den daraus entstehenden Code. Dieser Code gibt das Ergebnis der WebService Operation per println aus.

 

Ich hoffe dieses Tutorial hat euch geholfen einen BPEL Prozess zu erstellen und zur Ausführung zu bringen. Viel Spaß beim arbeiten mit BPEL!