Diese README behandelt alle 3 Teile des iX Web Service Tutorials.
Die jeweiligen Abschnitte sind entsprechend gekennzeichnet.

Viel Spass beim iX Web Service Tutorial

Lars Rwekamp

P.S: Sollte es Probleme mit der Installation oder sonstige Fragen zu
     dem Tutorial geben, knnen 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 mssen diese
natrlich in Form einer "Web Service Applikation" in die
Laufzeitumgebung des Java Web Service Development Packs (WSDP)
eingebunden werden.

Die folgenden Zeilen sollen erlutern, 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 knnen.

Als Basis fr das Deployment dient das Tool Apache ANT, das
Bestandteil des WSDP ist. Die zur Verfgung gestellten Build-Scripte
stellen lediglich einfache Lsungen dar, um ein Deployment zu
erreichen.

Natrlich sind deutlich ausgefeiltere und umfangreichere Lsungen
moeglich. An dieser Stelle wurde allerdings bewusst darauf verzichtet,
um die Skripte auch denjenigen nahe zu bringen, die sich bisher noch
nicht mit ANT beschftigt haben.


Das Deployment setzt ein lauffhiges JDK Version 1.2
(oder hher) voraus.

A) DEPLOYMENT

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

Folgende Schritte sind fr 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 hinzufgen, falls dies nicht bereits
   bei der Installation passiert ist.

   Test: einfach ANT in einem beliebigen Verzeichnis
         aufrufen.

   ANMERKUNG fr Interessierte - Nheres 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 Eintrge der Datei "build.properties"
   sollten unverndert bleiben. Nhere 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 mglichen
   Deployment Optionen angezeigt werden.

5. Whlen 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 gewnschte Aufgabe ausfhren und
   dies durch die Meldung BUILD SUCCESSFUL
   besttigen.


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 fr die Web-Anwendung.

   Starten Sie den Tomcat Server des WSDP.

   unter Windos:

   Alternative a)

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

   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 fr alle
   Betriebssysteme ein entsprechendes shutdown.xxx
   zum Herunterfahren des Servers.

   ANMERKUNG fr Interessierte - Nheres 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 Vorgnger. Fr
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
durchgefhrt 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 spteren Verlauf zur Generierung
eines Web Service Clients herangezogen werden kann. Da dem Tool whrend
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
zunchst 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
durchgefhrt wurden. Sie knnen also entweder diese Datei in das Verzeichnis

  classes

kopieren oder aber die oben beschriebene nderung an der generierten wsdl Datei
selbst durchfhren.


TEIL 3:
===============================================================

Der dritte Teil des iX WebService Tutorials beinhaltet vornehmlich
den Bereich der Registrierung und des Auffindens von Web Services
in unternehmensinternen und ffentlichen XML Registries. Fr
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 und 2
beschrieben durchgefhrt werden. Da alle neuen Funktionen wie
gewohnt in die Demo Web Applikation eingebunden wurden, empfehle
ich diese einfach einmal von A bis Z durchzuspielen.

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

Der Zugriff auf die ffentlichen Registries funktioniert leider nur
teilweise. Ich empfehle zunchst einmal mit den IBM Registries zu
beginnen und einen Suchbegriff zu whlen der nicht zu allgemein und
nicht zu speziell ist. So gab es bei einem Test bei den Begriffen
"IBM Software" oder "Software" eine durchaus berschaubare Trefferzahl.

Die Abfragen knnen zum Teil durchaus eine Minute dauern - also ist
Geduld gefragt!

Geht ihre Anfrage ber eine Firewall inkl. Proxy, so muss der entsprechende
Proxy Eintrag bei dem Aufbaue einer Connection mit bergeben werden.
Entsprechende Eintrge sind in der Klasse

    de.ix.wstutorial.registrybrowser.RegistryBrowserServlet

innerhalb der Methode

    getConnectionProperties(...)

bereits vorgefertigt und mssen nur noch von ihnen gefllt werden.

Einige der Registries erwarten zusaetzlich die Angabe von UserId und
Password. Wenn sie entsprechende Daten durch eine Anmeldung an der
jeweiligen Registry erhalten haben, knnen sie diese ebenfalls in
der oben erwhnten Klasse (selbe Methode) eintragen.















