You are viewing a plain text version of this content. The canonical link for it is here.
Posted to soap-dev@xml.apache.org by du...@apache.org on 2001/05/16 17:26:16 UTC
cvs commit: xml-soap/java/webapps/soap/admin index.html
duftler 01/05/16 08:26:15
Modified: java build.xml
java/docs/install tomcat.html
java/webapps/soap/admin index.html
Log:
Added a "buildwar" target to build.xml that will leave a soap.war web
archive in the /soap-2_2/webapps directory.
Added Tomcat docs to include how to deploy web application from web
archive, and updated original Tomcat docs a bit.
Replaced a reference to IBM-SOAP with Apache SOAP.
Revision Changes Path
1.30 +26 -5 xml-soap/java/build.xml
Index: build.xml
===================================================================
RCS file: /home/cvs/xml-soap/java/build.xml,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -r1.29 -r1.30
--- build.xml 2001/05/16 04:04:35 1.29
+++ build.xml 2001/05/16 15:25:59 1.30
@@ -43,7 +43,7 @@
Copyright:
- Copyright (c) 2000 Apache Software Foundation.
+ Copyright (c) 2001 Apache Software Foundation.
==================================================================== -->
@@ -208,7 +208,7 @@
<!-- =================================================================== -->
- <!-- Compiles the JUnit testcases -->
+ <!-- Compiles the JUnit testcases -->
<!-- =================================================================== -->
<path id="test-classpath">
@@ -232,7 +232,7 @@
<!-- =================================================================== -->
- <!-- Runs the JUnit testcases -->
+ <!-- Runs the JUnit testcases -->
<!-- =================================================================== -->
<target name="junit" if="junit.present"
depends="buildTest">
@@ -284,7 +284,7 @@
</target>
<!-- =================================================================== -->
- <!-- Creates the binary distribution -->
+ <!-- Creates the binary distribution -->
<!-- =================================================================== -->
<target name="dist" depends="compile, junit, javadocsIfRequired, samples">
<mkdir dir="${dist.dir}"/>
@@ -310,12 +310,14 @@
<fileset dir="${webapps}"/>
</copy>
+ <antcall target="buildwar"/>
+
<copy file="LICENSE" tofile="${dist.dir}/LICENSE"/>
<copy file="README" tofile="${dist.dir}/README"/>
</target>
<!-- =================================================================== -->
- <!-- Creates the source distribution -->
+ <!-- Creates the source distribution -->
<!-- =================================================================== -->
<target name="srcdist" depends="init">
<copy todir="${dist.dir}/src">
@@ -324,6 +326,25 @@
<copy file="LICENSE" tofile="${dist.dir}/LICENSE"/>
<copy file="${build.file}" tofile="${dist.dir}/${build.file}"/>
+ </target>
+
+ <!-- =================================================================== -->
+ <!-- Packages the Web Application as a Web ARchive. -->
+ <!-- =================================================================== -->
+ <target name="buildwar" depends="compile, samples">
+ <mkdir dir="${dist.dir}/webapps"/>
+
+ <war warfile="${dist.dir}/webapps/${name}.war"
+ webxml="${webapps}/soap/WEB-INF/web.xml">
+ <fileset dir="${webapps}/soap">
+ <include name="*.html"/>
+ <include name="admin/*.*"/>
+ </fileset>
+ <classes dir="${build.dest}"/>
+ <classes dir="${build.dir}">
+ <include name="samples/**/*.class"/>
+ </classes>
+ </war>
</target>
<!-- =================================================================== -->
1.8 +36 -12 xml-soap/java/docs/install/tomcat.html
Index: tomcat.html
===================================================================
RCS file: /home/cvs/xml-soap/java/docs/install/tomcat.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- tomcat.html 2001/05/16 03:58:36 1.7
+++ tomcat.html 2001/05/16 15:26:07 1.8
@@ -10,6 +10,8 @@
<h1 align="center">Apache-SOAP Version 2.2: Installing the Server Side
Under Apache Tomcat v3.2</h1>
+<h2>Getting Tomcat ready:</h2>
+
<p><strong>IMPORTANT</strong>: Tomcat comes with an XML parser (lib/xml.jar)
which has the DOM level 1 interfaces. Even if you put Xerces 1.1.2's
xerces.jar in your classpath, the wrong interfaces are found by
@@ -20,43 +22,65 @@
builds. </p>
<p>If you run startup.bat, then line 105 (or there abouts) of tomcat.bat should look
-like this(line 69 for Tomcat 3.2.1) :</p>
+like this (line 69 for Tomcat 3.2.1) :</p>
<blockquote>
- <pre>set CP=path-to-xerces\xerces.jar;%CLASSPATH%;%CP%</pre>
+ <code>set CP=path-to-xerces\xerces.jar;%CLASSPATH%;%CP%</code>
</blockquote>
<p>If you run startup.sh, add the following after line 113:</p>
<blockquote>
- <pre>CLASSPATH=path-to-xerces/xerces.jar:${CLASSPATH}</pre>
+ <code>CLASSPATH=path-to-xerces/xerces.jar:${CLASSPATH}</code>
</blockquote>
+
+<h2>Deploying Apache-SOAP on Tomcat:</h2>
+
+<p>There are two different ways to actually deploy Apache SOAP on Tomcat:</p>
+
+<h3>Method 1: Deploying the web archive.</h3>
-<p>The easiest way to set up for Tomcat is to add a <Context>
-to conf/server.xml:</p>
+<p>The Apache SOAP distribution includes a web archive at <code>/soap-2_2/webapps/soap.war</code>.
+Simply drop this web archive into Tomcat's webapps directory (i.e. <code>%tomcat_home%/webapps</code>).
+If you deploy Apache SOAP into Tomcat in this manner, you will not need to have anything from the
+<code>/soap-2_2</code> directory on your server's classpath (the relevant items are included in the web
+archive).</p>
-<pre><Context path="/soap" docBase="path-to-apache-soap/webapps/soap"
+<p>Keep in mind that if you want to replace the deployed Apache SOAP web application with a
+later version that you will probably have to shut the server down, remove the expanded
+<code>%tomcat_home%/webapps/soap</code> directory, and replace the
+<code>%tomcat_home%/webapps/soap.war</code> file with the newer one.</p>
+
+<h3>Method 2: Creating a new <Context> in Tomcat's server.xml file.</h3>
+
+<p>Simply add a new <code><Context></code> element into
+<code>%tomcat_home%/conf/server.xml</code>:</p>
+
+<code><Context path="/soap" docBase="path-to-apache-soap/webapps/soap"
debug="1" reloadable="true">
-</Context></pre>
+</Context></code>
<p>Now, make sure you have the jar files from the lib directory
-of this distribution on your classpath and start up tomcat. Also
+of this distribution on your classpath and start up tomcat. Also,
you will want to have on the classpath any of your code that you
-want to deploy as services.</p>
+want to deploy as services (e.g. <code>/soap-2_2</code> if you want to deploy
+any of the included samples).</p>
+
+<h2>Accessing the Apache SOAP context:</h2>
<p>You should be able to deploy services by pointing a browser to</p>
<blockquote>
- <pre><a href="http://hostname:port/soap">http://hostname:port/soap</a></pre>
+ <code><a href="http://hostname:port/soap">http://hostname:port/soap</a></code>
</blockquote>
<p>where hostname is the host on which Tomcat is running and port
is the port. See the User's Guide for details on the
-aministration tool. The SOAP end-point for invoking services on
+administration tool. The SOAP end-point for invoking services on
this server is:</p>
<blockquote>
- <pre><a href="http://hostname:port/soap/servlet/rpcrouter">http://hostname:port/soap/servlet/rpcrouter</a></pre>
+ <code><a href="http://hostname:port/soap/servlet/rpcrouter">http://hostname:port/soap/servlet/rpcrouter</a></code>
</blockquote>
<p>Happy SOAP-ing!</p>
1.2 +1 -1 xml-soap/java/webapps/soap/admin/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/xml-soap/java/webapps/soap/admin/index.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- index.html 2000/08/10 02:25:58 1.1
+++ index.html 2001/05/16 15:26:12 1.2
@@ -1,6 +1,6 @@
<html>
<head>
- <title>IBM-SOAP Admin Tool</title>
+ <title>Apache SOAP Admin Tool</title>
<script language="JavaScript" type="text/javascript">
<!-- Hide from non-scripting browsers