Diese README behandelt sowohl den ersten als auch den zweiten
Teil des ix Web Service Tutorials. Die jeweiligen Abschnitte
sind entsprechend gekennzeichnet.

Viel Spass beim iX Web Service Tutorial

Lars Röwekamp

P.S: Sollte es Probleme mit der Installation oder sonstige Fragen zu
     dem Tutorial geben, können Sie mich jederzeit unter

        Lars.Roewekamp@openKnowledge.de

     oder

        webServices@openKnowledge.de

     erreichen.




TEIL 1:
===============================================================

Der erste Teil des iX Web-Service-Tutorials beinhaltet zwar noch
relativ wenig Java-Quellen, trotzdem müssen diese
natürlich in Form einer "Web Service Applikation" in die
Laufzeitumgebung des Java Web Service Development Packs (WSDP)
eingebunden werden.

Die folgenden Zeilen sollen erläutern, wie dies mit relativ
wenig Aufwand erreicht werden kann.

Neben dem reinen Deployment, welches unter A) beschrieben wird,
zeigt B) wie Sie die Web-Applikation testen können.

Als Basis für das Deployment dient das Tool Apache ANT, das
Bestandteil des WSDP ist. Die zur Verfügung gestellten Build-Scripte
stellen lediglich einfache Lösungen dar, um ein Deployment zu
erreichen.

Natürlich sind deutlich ausgefeiltere und umfangreichere Lösungen
moeglich. An dieser Stelle wurde allerdings bewusst darauf verzichtet,
um die Skripte auch denjenigen nahe zu bringen, die sich bisher noch
nicht mit ANT beschäftigt haben.


Das Deployment setzt ein lauffähiges JDK Version 1.2
(oder höher) voraus.

A) DEPLOYMENT

HINWEIS: Für Nutzer eines UNIX basierten Systems ist
es wichtig sicherzustellen, das Schreibrechte für das
webapps-Verzeichnis des (JWSDP_HOME/webapps) WSDP
bestehen!

Folgende Schritte sind für das Deployment notwenig:

1. Installieren des WSDP - folgen Sie dabei den
   Installationsanweisungen des WSDP.

   siehe auch - Windows:

   http://java.sun.com/webservices/downloads/install-windows.html

   siehe auch - UNIX:

   http://java.sun.com/webservices/downloads/install-unix.html


2. Das /bin-Verzeichnis des WSDP - in dem sich die
   Startdatei von ANT befindet - zur PATH Umgebungs-
   variablen hinzufügen, falls dies nicht bereits
   bei der Installation passiert ist.

   Test: einfach ANT in einem beliebigen Verzeichnis
         aufrufen.

   ANMERKUNG für Interessierte - Näheres zu ANT
   finden Sie auch unter:

   http://jakarta.apache.org/ant/


3. Setzen Ihrer speziellen Properties. Gehen sie
   dazu bitte in das /etc-Verzeichnis des iX
   Web-Service-Tutorials und öffnen Sie dort die
   Datei "build.properties".

   Passen Sie den Wert der Property "deploy.path" an
   Ihre Umgebung und Installation an. Das folgende
   Beispiel zeigt eine Einstellung, bei der das WSDP
   auf einem Windows-Rechner im Verzeichnis
   D:/dev/jwsdp-1_0 installiert wurde.

   deploy.path=D:/dev/jwsdp-1_0/webapps

   Alle weiteren Einträge der Datei "build.properties"
   sollten unverändert bleiben. Nähere Informationen
   zu den einzelnen Werten finden sich innerhalb
   der Datei selbst.

4. Wechseln Sie in das iX Web-Service-Tutorial
   Installationsverzeichnis und rufen Sie dort
   das Deployment Tool ANT auf.

   Im folgenden Beispiel wurde das Tutorial auf
   einem Windows Rechner im Verzeichnis

     e:/dev/java/ix/webservice-tutorial

   installiert:

   cd e:/dev/java/ix/webservice-tutorial
   ant

   Im Anschluss sollte eine Liste der möglichen
   Deployment Optionen angezeigt werden.

5. Wählen Sie eine der angebotenen Optionen aus:

   a) Bereinigen bereits vorhandener Deployments:

      rufen Sie ANT mit folgender Option auf:

      ant clean-all

   b) Erzeugen eines "exploded" Web Archives

      rufen Sie ANT mit folgender Option auf:

      ant deploy-war-exploded

   c) Erzeugen eines Web Archives (war-File)

      rufen Sie ANT mit folgender Option auf:

      ant deploy-war-archive

   Nach dem Aufruf der jeweiligen Option sollte
   ANT die gewünschte Aufgabe ausführen und
   dies durch die Meldung BUILD SUCCESSFUL
   bestätigen.


B) TESTEN

   Wenn Sie alle Schritte wie oben beschrieben
   befolgt haben, wurde im /webapps-
   Verzeichnis des WSDP automatisch eine
   Web-Applikation namens ws-tutorial
   angelegt. Dies ist entweder als "exploded"
   Web Archive (also als Verzeichnisstruktur)
   oder in Form einer einzigen WAR Datei
   passiert.

   ws-tutorial ist somit gleichzeitig auch die
   Basis für die Web-Anwendung.

   Starten Sie den Tomcat Server des WSDP.

   unter Windos:

   Alternative a)

   Schritt 1) Start Button in Taskleiste
   Schritt 2) Programme auswählen
   Schritt 3) Java WebService Development Pack auswählen
   Schritt 4) Start Tomcat auswählen

   Alternative b)

   Schritt 1) in das /bin-Verzeichnis des WSDP wechseln
   Schritt 2) startup.bat aufrufen

   unter Unix:

   Schritt 1) in das /bin-Verzeichnis des WSDP wechseln
   Schritt 2) startup.sh aufrufen

   ANMERKUNG: Zu startup.xxx gibt es für alle
   Betriebssysteme ein entsprechendes shutdown.xxx
   zum Herunterfahren des Servers.

   ANMERKUNG für Interessierte - Näheres zu TOMCAT
   finden Sie auch unter:

   http://jakarta.apache.org/tomcat/

   Haben Sie das WSDP im Standardmodus
   installiert (Port 8080), koennen sie
   die Web Applikation mit folgenden
   Aufruf starten:

   http://localhost:8080/ws-tutorial

   Nun brauchen Sie lediglich den Link
   "babelfish" anzuklicken, um zu dem im
   Tutorial beschriebenen Übersetzungsdienst zu gelangen.


TEIL 2:
===============================================================

Der zweite Teil des iX WebService Tutorials beinhaltet schon
deutlich mehr Java und XML Sourcen als sein Vorgänger. Für
das Deployment wurden die aus dem ersten Teil bekannten ANT
Skripte angepasst, so dass es an dieser Stelle keine Probleme
geben sollte.

Auch das Testen der neuen Features kann wie in Teil 1 beschrieben
durchgeführt werden. Da alle neuen Funktionen in die Demo Web
Applikation eingebunden wurden, empfehle ich diese einfach
einmal von A bis Z durchzuspielen.

Zu beachten gibt es bei dem Nachimplementieren des Tutorials lediglich
folgenden Punkt:

Das Generieren des Currency Converter Web Services mit Hilfe des
Tools xrpcc erzeugt als "Abfallprodukt" eine WSDL Datei namens
CurrencyConverter.wsdl, welche im späteren Verlauf zur Generierung
eines Web Service Clients herangezogen werden kann. Da dem Tool während
der Generierung die ENDPOINT URL noch nicht bekannt ist, muss
diese manuell nachgepflegt werden:

...
 <service name="CurrencyConverter">
    <port name="CurrencyConverterPort" binding="tns:CurrencyConverterBinding">
      <soap:address location="http://localhost:8080/ws-tutorial/rpc/currencyConverter/CurrencyConverter"/>
    </port>
 </service>
...

Die Download-Variante des iX WebSevrice Tutorials beinhaltet diese Änderung bereits.
Sollten Sie die einzelnen Schritte des Tutorials nachvollziehen, werden die Änderungen
zunächst durch die oben beschriebene Generierung überschrieben. Daher findet sich
in dem Verzeichnis

  src\xml\rpc\currencyconverter

eine Kopie der Datei CurrencyConverter.wsdl, in der diese Änderungen exemplarisch
durchgeführt wurden. Sie können also entweder diese Datei in das Verzeichnis

  classes

kopieren oder aber die oben beschriebene Änderung an der generierten wsdl Datei
selbst durchführen.











