3. Installation des Apache SOAP als SOAP-Entwicklungsumgebung für Java

• Download und Installation von J2SE 1.4.
   
• Download und Installation von Tomcat 4.0.x.
   
• Download und Installation von J2EE 1.3:
  Download von http://java.sun.com/j2ee (z.B. für Windows die Datei "j2sdkee-1_3_1-win.exe", 17 MByte).
  Installation zum Beispiel in das Verzeichnis "C:\Java\j2sdkee".
  Dokumentation zum J2EE finden Sie anschließend unter "C:\Java\j2sdkee\doc\index.html" oder auch unter "http://java.sun.com/j2ee/1.4/docs/tutorial/doc/index.html".
   
• Download und Installation von Apache SOAP:
  Download von http://www.apache.de/dist/ws/soap (z.B. für Windows die Datei "soap-bin-2.3.1.zip", 2 MByte).
  Entpacken zum Beispiel in das Verzeichnis "C:\Java" und eventuell umbenennen des entstandenen Unterverzeichnisses zu "C:\Java\soap".
  Dokumentation zu Apache SOAP finden Sie anschließend unter "C:\Java\soap\docs\index.html" oder auch unter "http://ws.apache.org/soap".
   
• Download und Installation von JavaMail und JAF:
  Download von "javamail-1_3.zip" von http://java.sun.com/products/javamail
  und von "jaf-1_0_2.zip" von http://java.sun.com/products/javabeans/glasgow/jaf.html.
  Entzippen beider .zip-Dateien in ein temporäres Verzeichnis und kopieren der Dateien "mail.jar" und "activation.jar" nach "C:\Java\soap\lib", wo sich auch "soap.jar" befindet.
   
• Einige Tools oder Batchdateien erwarten bestimmte Umgebungsvariablen. Üblich sind zum Beispiel (Pfade bitte anpassen):

  set J2EE_HOME=C:\Java\j2sdkee set JAVA_HOME=C:\Java\j2sdk set SOAP_HOME=C:\Java\soap set CATALINA_HOME=C:\Java\Tomcat set path=%path%;%JAVA_HOME%\bin;%J2EE_HOME%\bin

  Das Einrichten von Umgebungsvariablen im Environment geschieht unter Windows 2000 unter "Start" | "Einstellungen" | "Systemsteuerung" | "System" | "Erweitert" | "Umgebungsvariablen..." und unter Windows XP unter "Start" | "Systemsteuerung" | "Leistung und Wartung" | "System" | "Erweitert" | "Umgebungsvariablen".
   
• Die drei .jar-Dateien "soap.jar", "mail.jar" und "activation.jar" müssen entweder korrekt innerhalb einer "WAR"-Datei installiert werden oder in das richtige "WEB-INF/lib"-Verzeichnis kopiert werden oder in den "CLASSPATH" eingebunden werden, zum Beispiel so (bitte alles in eine Zeile und direkt hintereinander ohne Leerzeichen):

  set CLASSPATH=.;C:\Java\soap\lib\soap.jar;                 C:\Java\soap\lib\mail.jar;                 C:\Java\soap\lib\activation.jar;                 C:\Java\soap;                 %CLASSPATH%

  Im gezeigten CLASSPATH ist auch "C:\Java\soap" aufgenommen worden, damit die Apache-SOAP-Beispiele (unter "C:\Java\soap\samples") ausgeführt werden können. Falls Sie eine Web-Applikation in einem anderen Verzeichnis haben, muss deren "classes"-Pfad (z.B. "C:\MeineWebApp\WEB-INF\classes") eventuell ebenfalls hinzugefügt werden. Bei älteren Tomcat-Versionen (z.B. 3.2.x) müsste außerdem ein JAXP-kompatibler XML-Parser (z.B. Xerces) installiert und im CLASSPATH als erster Bestandteil eingetragen werden.

  Je nach Tomcat-Version sind zusätzliche Maßnahmen erforderlich, damit Tomcat den voreingestellten CLASSPATH übernimmt. Zum Beispiel bei Tomcat 4.0.4 muss eventuell in der Datei "C:\Java\Tomcat\bin\setclasspath.bat" die Zeile
  set CLASSPATH=%JAVA_HOME%\lib\tools.jar
  ersetzt werden durch
  set CLASSPATH=%JAVA_HOME%\lib\tools.jar;%CLASSPATH%
  Eventuell darf dann Tomcat nicht mehr per "Start" | "Programme" | "Apache Tomcat" | "Start" gestartet werden, sondern nur noch über startup.bat:

  cd C:\Java\Tomcat\bin startup.bat

   
• In der Datei "C:\Java\Tomcat\conf\server.xml" muss der SOAP-Context hinzugefügt werden. Zum Beispiel für Tomcat 3.2.x ist der richtige Ort hierfür am Ende der Datei vor der Zeile </ContextManager> und bei Tomcat 4.0.4 hinter der Tomcat-Root-Context-Definition:
  <Context path="" docBase="ROOT" debug="0"/>
  (aber außerhalb des durch "<!-- ... -->" markierten Kommentar-Bereiches).
  Eingefügt werden muss ("docBase"-Pfad eventuell anpassen):

  <Context path="/soap"   docBase="C:/Java/soap/webapps/soap"   reloadable="true" > </Context>

   
• Nach Änderungen in der "server.xml" muss Tomcat heruntergefahren und neu gestartet werden.
   
• Wenn SOAP korrekt eingebunden ist, erscheint die SOAP-Begrüßungsseite, wenn im Webbrowser als URL eingegeben wird:
  http://localhost/soap.
  Beim Anklicken von "Run the admin client" startet der "Apache SOAP Admin".
  Bei "Visit the SOAP RPC router" gibt es eine Fehlermeldung, da noch kein SOAP-Dienst installiert ist.

Diplomarbeiten zum Runterladen: