
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
mglich. 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: Nutzer eines Unix basierten Systems mssen
sicherstellen, dass Schreibrechte fr das 
webapps-Verzeichnis des WSDP (JWSDP_HOME/webapps)
bestehen! 

Folgende Schritte sind fr das Deployment notwenig: 

1. Installieren des WSDP - folgen Sie dabei den 
   Installationsanweisungen des WSDP.
   
   Fr Windows siehe auch:
   
   http://java.sun.com/webservices/downloads/install-windows.html
   
   Fr Unix siehe auch: 
   
   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 
   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 Windows: 
   
   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.  
    


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.
     
     
     