duftler     01/05/23 10:41:09

  Modified:    targets/soap/faq index.html
  Added:       targets/soap/faq faq_chawke.html
  Removed:     targets/soap/faq faq_chawke.txt
  Log:
  Switched Jonathan's FAQ from txt to html.
  
  Revision  Changes    Path
  1.2       +1 -1      xml-site/targets/soap/faq/index.html
  
  Index: index.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/soap/faq/index.html,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- index.html        2001/05/23 15:31:54     1.1
  +++ index.html        2001/05/23 17:41:02     1.2
  @@ -58,7 +58,7 @@
   by XMethods.
   </li>
   <li class="faqA">
  -<em><a href="faq_chawke.txt">Jonathan Chawke's SOAP FAQ</a></em> which will 
eventually be merged with
  +<em><a href="faq_chawke.html">Jonathan Chawke's SOAP FAQ</a></em> which will 
eventually be merged with
   this FAQ and hosted on the Apache SOAP web-site.
   </li>
   <li class="faqA">
  
  
  
  1.1                  xml-site/targets/soap/faq/faq_chawke.html
  
  Index: faq_chawke.html
  ===================================================================
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"  
"http://www.w3.org/TR/REC-html40/loose.dtd";>
  <HTML><HEAD><META HTTP-EQUIV="Content-Type" CONTENT="text/html; 
charset=windows-1252">
  <style type="text/css"><!--
  H1 { font-family : Arial, Helvetica; font-size : 14pt }
  H2 { font-family : Arial, Helvetica; font-style: italic; font-size : 12pt }
  H3 { font-family : Arial, Helvetica; font-size : 10pt }
  CODE {  font-family : Courier New, Courier; font-size : 9pt; color : #0000ff }
  PRE {  font-family : Courier New, Courier; font-size : 9pt; color : #0000ff } 
 -->    </style>
  <TITLE>Apache-SOAP User's FAQ</TITLE>
  <META NAME="subject" CONTENT="Apache-SOAP User's FAQ">
  </HEAD>
  <BODY LINK="#0000ff" VLINK="#800080">
  <H1>Apache-SOAP User's FAQ</H1>
  This FAQ is based on the questions and answers that appear on the <a 
href="http://xml.apache.org/soap/mail.html";>Apache-SOAP User's Mailing 
List</a>.<br> It is currently maintained by <A HREF="mailto:[EMAIL 
PROTECTED]">Jonathan Chawke</A>.
  <H1><A NAME="toc">Table of Contents</A></H1><OL><LI><H2>Hot 
Topics</H2>1.1&nbsp;&nbsp;<A HREF="#Q1_1">Help! I'm getting this error: 
"Element must contain a:'faultcode' element"</A><br>
  1.2&nbsp;&nbsp;<A HREF="#Q1_2">Help! I'm getting this error: "Unable to 
resolve namespace URI for 'xsd'".</A><br>
  1.3&nbsp;&nbsp;<A HREF="#Q1_3">Help! I'm getting this error: "Unable to 
resolve target object.." when I try to invoke a method on my SOAP 
service.</A><br>
  1.4&nbsp;&nbsp;<A HREF="#Q1_4">Help! I got this error message: "Fault String 
= org.w3c.dom.Node: method getNamespaceURI() java/lang/String; not 
found"</A><br>
  1.5&nbsp;&nbsp;<A HREF="#Q1_5">Help! The Samples won't work. Every time I run 
a sample client I get this response: 
    "Fault String = java.lang.NoSuchMethodError"</A><br>
  <br></LI><LI><H2>General</H2>2.1&nbsp;&nbsp;<A HREF="#Q2_1">Where can I get 
help on SOAP issue XYZ?</A><br>
  2.2&nbsp;&nbsp;<A HREF="#Q2_2">Where can I find mailing list archives for the 
soap-user mailing list?</A><br>
  2.3&nbsp;&nbsp;<A HREF="#Q2_3">I'm just getting started with SOAP. Where can 
I find a tutorial on SOAP programming?</A><br>
  2.4&nbsp;&nbsp;<A HREF="#Q2_4">Are there any good books on SOAP?</A><br>
  2.5&nbsp;&nbsp;<A HREF="#Q2_5">What other SOAP implementations are 
available?</A><br>
  2.6&nbsp;&nbsp;<A HREF="#Q2_6">How do I tell my Apache SOAP client to use a 
proxy server?</A><br>
  2.7&nbsp;&nbsp;<A HREF="#Q2_7">How do I perform Proxy Authentication with my 
Apache SOAP client?</A><br>
  2.8&nbsp;&nbsp;<A HREF="#Q2_8">How do I use TcpTunnel and 
TcpTunnelGUI?</A><br>
  2.9&nbsp;&nbsp;<A HREF="#Q2_9">How do I use SOAP over SSL?</A><br>
  2.10&nbsp;&nbsp;<A HREF="#Q2_10">How do I use SOAP over SMTP?</A><br>
  2.11&nbsp;&nbsp;<A HREF="#Q2_11">What products are available that will let me 
use ASP or Perl as SOAP client?</A><br>
  2.12&nbsp;&nbsp;<A HREF="#Q2_12">I'd like to write a SOAP client as a Java 
applet. Are there any 'tiny' SOAP client libraries I could use?</A><br>
  2.13&nbsp;&nbsp;<A HREF="#Q2_13">Where do I find nightly builds of the POP3 
and SMTP beans?</A><br>
  2.14&nbsp;&nbsp;<A HREF="#Q2_14">Can a SOAP server maintain session between 
multiple client invocations?</A><br>
  2.15&nbsp;&nbsp;<A HREF="#Q2_15">How do I use a String array as a parameter 
to a SOAP service?</A><br>
  2.16&nbsp;&nbsp;<A HREF="#Q2_16">Is there a way to generate SOAP 
stub/skeleton from deployment descriptor?</A><br>
  2.17&nbsp;&nbsp;<A HREF="#Q2_17">Is there a way to generate SOAP deployment 
descriptor from IDL?</A><br>
  2.18&nbsp;&nbsp;<A HREF="#Q2_18">Is there any way of specifying a timeout for 
a SOAP method invocation?</A><br>
  2.20&nbsp;&nbsp;<A HREF="#Q2_20">What is the best way to send a large file 
(>10Mb) with a soap request?</A><br>
  2.21&nbsp;&nbsp;<A HREF="#Q2_21">Help! I got the following error message: 
"SOAP Service Manager: Unable to read 'DeployedServices.ds': assuming fresh 
start"</A><br>
  2.22&nbsp;&nbsp;<A HREF="#Q2_22">How can I generate a WSDL file for my SOAP 
service?</A><br>
  2.23&nbsp;&nbsp;<A HREF="#Q2_23">Is there a tool that can validate 
WSDL?</A><br>
  2.25&nbsp;&nbsp;<A HREF="#Q2_25">Is it possible to pass parameters to the 
constructor in a SOAP application ?</A><br>
  2.26&nbsp;&nbsp;<A HREF="#Q2_26">How do I write a SOAP service that maintains 
state across a session?</A><br>
  2.27&nbsp;&nbsp;<A HREF="#Q2_27">Where can I find the WSDL specification 
document?</A><br>
  <br></LI><LI><H2>Installation</H2>3.0&nbsp;&nbsp;<A HREF="#Q3_0">Can I 
install Apache-SOAP 2.1 on Tomcat 4.0 beta?</A><br>
  3.1&nbsp;&nbsp;<A HREF="#Q3_1">How do I install Apache-SOAP on Tomcat?</A><br>
  3.2&nbsp;&nbsp;<A HREF="#Q3_2">How do I install Apache-SOAP on Bea WebLogic 
6.0?</A><br>
  3.3&nbsp;&nbsp;<A HREF="#Q3_3">How do I install Apache-SOAP on Resin?</A><br>
  3.4&nbsp;&nbsp;<A HREF="#Q3_4">How do I install Apache-SOAP on IBM 
WebSphere?</A><br>
  3.5&nbsp;&nbsp;<A HREF="#Q3_5">How do I install Apache-SOAP on 
Bluestone?</A><br>
  3.6&nbsp;&nbsp;<A HREF="#Q3_6">How do I install Apache-SOAP on Orion?</A><br>
  3.7&nbsp;&nbsp;<A HREF="#Q3_7">How do I install Apache-SOAP on 
Apache-JServ?</A><br>
  3.8&nbsp;&nbsp;<A HREF="#Q3_8">How do I install Apache-SOAP on 
iPlanet?</A><br>
  3.10&nbsp;&nbsp;<A HREF="#Q3_10">How do I install Apache-SOAP on Unify's 
ServletExec?</A><br>
  <br></LI><LI><H2>Troubleshooting</H2>4.2&nbsp;&nbsp;<A HREF="#Q4_2">Help! 
Visual Age can't compile SOAP - it says I'm missing package 
com.ibm.xmi.job.*</A><br>
  4.7&nbsp;&nbsp;<A HREF="#Q4_7">Help! I'm using Tomcat+SOAP on Linux. When I 
try to access the SOAP admin page, Tomcat crashes and I see this message: 
"HotSpot Virtual Machine Error, Unexpected Signal 11"</A><br>
  <br></LI><LI><H2>SOAP and .NET</H2>5.3&nbsp;&nbsp;<A HREF="#Q5_3">Help! My 
Apache SOAP Client cannot connect to a .NET service - the server says it 
expects 'text/xml' and doesn't understand "text/xml; charset=utf-8".</A><br>
  </OL>
  
  <HR NOSHADE><H2>Questions and Answers</H2>
  <OL>
  
  <p><H2><u>1.&nbsp;&nbsp;Hot Topics</u></H2>
  1.1&nbsp;&nbsp;<STRONG><A NAME="Q1_1">Help! I'm getting this error: "Element 
must contain a:'faultcode' element"</A></STRONG><BR>
   This is probably due to a bug in some newer releases of Xerces (e.g. 1.3.1). 
Try using Xerces 1.2.3 or 1.3.0 instead (on both the client AND the server)- 
have a look on <A 
HREF="http://xml.apache.org/dist/xerces-j/";>http://xml.apache.org/dist/xerces-j/</A>.
 You should also make sure that it is the FIRST entry in your classpath.<p>
  1.2&nbsp;&nbsp;<STRONG><A NAME="Q1_2">Help! I'm getting this error: "Unable 
to resolve namespace URI for 'xsd'".</A></STRONG><BR>
   Ensure that:<BR>(a) You are using Xerces 1.2.3 or 1.3.0 (but NOT 1.3.1) - on 
both the client and the server (if both are using Apache-SOAP).<BR>(b) 
xerces.jar is the FIRST entry in your CLASSPATH as described in the Apache-SOAP 
installation instructions.<BR>(c) There is ONLY ONE version of xerces.jar in 
your CLASSPATH.<p>
  1.3&nbsp;&nbsp;<STRONG><A NAME="Q1_3">Help! I'm getting this error: "Unable 
to resolve target object.." when I try to invoke a method on my SOAP 
service.</A></STRONG><BR>
   This is a classpath problem. Ensure that your SOAP service class is included 
in the classpath. For example if your class is called HelloServer and it is in 
directory /foo/ then make sure that /foo/ is in your Tomcat classpath when it 
launches.<p>
  1.4&nbsp;&nbsp;<STRONG><A NAME="Q1_4">Help! I got this error message: "Fault 
String = org.w3c.dom.Node: method getNamespaceURI() java/lang/String; not 
found"</A></STRONG><BR>
   The most likely cause of this problem is a DOM level 1/level 2 issue. 
<BR>SOAP uses DOM level 2 and you may have DOM level 1 classes (i.e. another 
XML parser library) included earlier in the classpath. People often find 
another XML parser hiding in JAVA_HOME\jre\lib\ext.<BR>Ensure that:<BR>(a) You 
are using Xerces 1.2.3 or 1.3.0 (but NOT 1.3.1).<BR>(b) xerces.jar is the FIRST 
entry in your CLASSPATH as described in the Apache-SOAP installation 
instructions.<BR>(c) There is ONLY ONE version of xerces.jar in your 
CLASSPATH.<p>
  1.5&nbsp;&nbsp;<STRONG><A NAME="Q1_5">Help! The Samples won't work. Every 
time I run a sample client I get this response: 
    "Fault String = java.lang.NoSuchMethodError"</A></STRONG><BR>
   Ensure that:<BR>(a) You have deployed the sample service you want to use. 
<BR>(b) Xerces.jar is the very first entry in your classpath (set this in 
tomcat.bat or tomcat.sh as per the SOAP installation instructions).<BR>(c) 
There are no other XML parsers in your classpath. Some people have experienced 
this problem due to an early version of the JAXP package hiding in 
JAVA_HOME/jre/lib/ext.<BR>(d) The sample classes are in the server's 
CLASSPATH.<p>
  
  
  <p><H2><u>2.&nbsp;&nbsp;General</u></H2>
  2.1&nbsp;&nbsp;<STRONG><A NAME="Q2_1">Where can I get help on SOAP issue 
XYZ?</A></STRONG><BR>
   Try subscribing to the soap user mailing list on <A 
HREF="http://xml.apache.org/soap/mail.html";>http://xml.apache.org/soap/mail.html</A>
  or searching the mailing list archives (see "Where can I find mailing list 
archives for the soap-user mailing list?" for more information).<p>
  2.2&nbsp;&nbsp;<STRONG><A NAME="Q2_2">Where can I find mailing list archives 
for the soap-user mailing list?</A></STRONG><BR>
   Try: <A 
HREF="http://marc.theaimsgroup.com/?l=soap-user&r=1&w=2";>http://marc.theaimsgroup.com/?l=soap-user&r=1&w=2</A>
  or: <A 
HREF="http://archive.covalent.net/";>http://archive.covalent.net/</A>.<p>
  2.3&nbsp;&nbsp;<STRONG><A NAME="Q2_3">I'm just getting started with SOAP. 
Where can I find a tutorial on SOAP programming?</A></STRONG><BR>
   Try these links: <A 
HREF="<BR>http://www-106.ibm.com/developerworks/library/ws-peer2/";><BR>http://www-106.ibm.com/developerworks/library/ws-peer2/</A>
  <A 
HREF="http://www.perfectxml.com/articles/xml/hellosoap.asp";>http://www.perfectxml.com/articles/xml/hellosoap.asp</A>
  <A 
HREF="<BR>http://www.javapro.com/upload/free/features/javapro/2001/04apr01/prs0104/prs0104-1.asp<BR>http://www.soaplite.com/#LINKS<BR>http://soap.manilasites.com/<BR>http://www.xmethods.com/gettingstarted/apache.html";><BR>http://www.javapro.com/upload/free/features/javapro/2001/04apr01/prs0104/prs0104-1.asp<BR>http://www.soaplite.com/#LINKS<BR>http://soap.manilasites.com/<BR>http://www.xmethods.com/gettingstarted/apache.html</A>
 <p>
  2.4&nbsp;&nbsp;<STRONG><A NAME="Q2_4">Are there any good books on 
SOAP?</A></STRONG><BR>
   See <A 
HREF="http://www.soaprpc.com/books/";>http://www.soaprpc.com/books/</A>.<p>
  2.5&nbsp;&nbsp;<STRONG><A NAME="Q2_5">What other SOAP implementations are 
available?</A></STRONG><BR>
   A good list of SOAP implementations is available here: <A 
HREF="http://directory.google.com/Top/Computers/Programming/Internet/Web_Services/SOAP/Implementations/";>http://directory.google.com/Top/Computers/Programming/Internet/Web_Services/SOAP/Implementations/</A>
  <BR>and here: <A 
HREF="http://www.soap-wrc.com/webservices/default.asp";>http://www.soap-wrc.com/webservices/default.asp</A>.<p>
  2.6&nbsp;&nbsp;<STRONG><A NAME="Q2_6">How do I tell my Apache SOAP client to 
use a proxy server?</A></STRONG><BR>
   Here is some sample code to do this:<BR>SOAPHTTPConnection connection = new 
SOAPHTTPConnection();<BR>connection.setProxyHost("proxy");<BR>connection.setProxyPort(8080);<p>
  2.7&nbsp;&nbsp;<STRONG><A NAME="Q2_7">How do I perform Proxy Authentication 
with my Apache SOAP client?</A></STRONG><BR>
   See the sample code in the weather service client - it shows how to do proxy 
authentication. Here is some sample code too:<BR>SOAPHTTPConnection connection 
= new 
SOAPHTTPConnection();<BR>connection.setProxyHost("proxy");<BR>connection.setProxyPort(8080);<BR>setProxyUserName("username");<BR>setProxyPassword("password");<p>
  2.8&nbsp;&nbsp;<STRONG><A NAME="Q2_8">How do I use TcpTunnel and 
TcpTunnelGUI?</A></STRONG><BR>
   For a short answer see <A 
HREF="http://marc.theaimsgroup.com/?l=soap-user&m=98628744413873&w=2";>http://marc.theaimsgroup.com/?l=soap-user&m=98628744413873&w=2</A>.
 There is also a great article on IBM's developerWorks site: <A 
HREF="http://www-106.ibm.com/developerworks/webservices/library/ws-peer3/?dwzone=ws";>http://www-106.ibm.com/developerworks/webservices/library/ws-peer3/?dwzone=ws</A>.<p>
  2.9&nbsp;&nbsp;<STRONG><A NAME="Q2_9">How do I use SOAP over 
SSL?</A></STRONG><BR>
   See the Apache-SOAP SSL FAQ: <A 
HREF="http://xml.apache.org/websrc/cvsweb.cgi/xml-soap/java/docs/install/FAQ_Tomcat_SOAP_SSL.html";>http://xml.apache.org/websrc/cvsweb.cgi/xml-soap/java/docs/install/FAQ_Tomcat_SOAP_SSL.html</A>
 <p>
  2.10&nbsp;&nbsp;<STRONG><A NAME="Q2_10">How do I use SOAP over 
SMTP?</A></STRONG><BR>
   See the Apache-SMTP FAQ available in the soap user mail archives: <A 
HREF="http://marc.theaimsgroup.com/?l=soap-user&m=98692249417026&q=p3";>http://marc.theaimsgroup.com/?l=soap-user&m=98692249417026&q=p3</A>
 <p>
  2.11&nbsp;&nbsp;<STRONG><A NAME="Q2_11">What products are available that will 
let me use ASP or Perl as SOAP client?</A></STRONG><BR>
   See <A 
HREF="http://www.soap-wrc.com/webservices/default.asp";>http://www.soap-wrc.com/webservices/default.asp</A>
  and also <A 
HREF="http://www.soaprpc.com/software";>http://www.soaprpc.com/software</A>  for 
lists of SOAP libs/packages. A popular Perl implementation is SOAP::Lite - 
available at <A HREF="http://www.soaplite.com/";>http://www.soaplite.com/</A>.<p>
  2.12&nbsp;&nbsp;<STRONG><A NAME="Q2_12">I'd like to write a SOAP client as a 
Java applet. Are there any 'tiny' SOAP client libraries I could 
use?</A></STRONG><BR>
   Consider using SoapRMI for your client. It is 183KB (including full XML 
parser) and is available here: <A 
HREF="http://www.extreme.indiana.edu/soap/rmi/download/";>http://www.extreme.indiana.edu/soap/rmi/download/</A>.
 For more details about design see: <A 
HREF="http://www.extreme.indiana.edu/soap/";>http://www.extreme.indiana.edu/soap/</A>.<p>
  2.13&nbsp;&nbsp;<STRONG><A NAME="Q2_13">Where do I find nightly builds of the 
POP3 and SMTP beans?</A></STRONG><BR>
   You'll find them here: <A 
HREF="http://www.alphaworks.ibm.com/ab.nsf/";>http://www.alphaworks.ibm.com/ab.nsf/</A>.<p>
  2.14&nbsp;&nbsp;<STRONG><A NAME="Q2_14">Can a SOAP server maintain session 
between multiple client invocations?</A></STRONG><BR>
   It does now! Client-side cookie support was added to Apache SOAP by Sanjiva 
with the addition of the setMaintainSession function to the 
SOAPHTTPConnectionclass:<BR> shc = new SOAPHTTPConnection ();<BR> 
shc.setMaintainSession( true ); // NEW FUNCTION!!<BR> call.setSOAPTransport( 
shc );<BR>Check out the latest code from CVS and have a look atthe AddressBook2 
sample for more details(you'll need to at least get the latest Call.java and 
SOAPHTTOConnection.java from CVS). <BR>Note that session timeouts can be 
configured in the servlet container. In the case of Tomcat this is configured 
in the SOAP entry in web.xml.<p>
  2.15&nbsp;&nbsp;<STRONG><A NAME="Q2_15">How do I use a String array as a 
parameter to a SOAP service?</A></STRONG><BR>
   <xsd:complexType name="ArrayOfString"> <BR> <xsd:complexContent> <BR> 
<xsd:restriction base="SOAP-ENC:Array"> <BR> <xsd:attribute 
ref="SOAP-ENC:arrayType"<BR>wsdl:arrayType="xsd:string[]" /><BR> 
</xsd:restriction> <BR> </xsd:complexContent> <BR></xsd:complexType><BR>NOTE: 
IBM's WSTK doesn't currently support arrays.<p>
  2.16&nbsp;&nbsp;<STRONG><A NAME="Q2_16">Is there a way to generate SOAP 
stub/skeleton from deployment descriptor?</A></STRONG><BR>
   Yes you can use the IBM alphawork WSTK toolkit: <A 
HREF="http://www.alphaworks.ibm.com/tech/webservicestoolkit";>http://www.alphaworks.ibm.com/tech/webservicestoolkit</A>.<p>
  2.17&nbsp;&nbsp;<STRONG><A NAME="Q2_17">Is there a way to generate SOAP 
deployment descriptor from IDL?</A></STRONG><BR>
   It could make more sense to transform IDL to WSDL otherwise you will lose 
information regarding the syntax of method calls if you use<BR>directly the 
SOAP deployment descriptor.<p>
  2.18&nbsp;&nbsp;<STRONG><A NAME="Q2_18">Is there any way of specifying a 
timeout for a SOAP method invocation?</A></STRONG><BR>
   In Apache-SOAP version 2.1 you can set a timeout on the client side by 
using:<BR>SOAPHTTPConnection shc;<BR>shc = new 
SOAPHTTPConnection();<BR>shc.setTimeout(5000); //<-- 5 seconds<BR>Call call = 
new Call();<BR><BR>call.setSOAPTransport(shc);<p>
  2.20&nbsp;&nbsp;<STRONG><A NAME="Q2_20">What is the best way to send a large 
file (>10Mb) with a soap request?</A></STRONG><BR>
   As a MIME attachment. Note that this will use a lot of memory because the 
entire file is read into memory before it is sent.<p>
  2.21&nbsp;&nbsp;<STRONG><A NAME="Q2_21">Help! I got the following error 
message: "SOAP Service Manager: Unable to read 'DeployedServices.ds': assuming 
fresh start"</A></STRONG><BR>
   This message will appear the first time you run SOAP as the file does not 
exist and needs to be created for the first time. Don't worry - it is just a 
warning not an error.<p>
  2.22&nbsp;&nbsp;<STRONG><A NAME="Q2_22">How can I generate a WSDL file for my 
SOAP service?</A></STRONG><BR>
   You can use IBM web services toolkit - WSTK - 
(class<BR>com.ibm.wstk.swrapper.ui.SWrapperGUI) on <A 
HREF="http://www.alphaworks.ibm.com/tech/wsde";>http://www.alphaworks.ibm.com/tech/wsde</A>
  or IBM Web services development environment on <A 
HREF="http://www.alphaworks.ibm.com/tech/webservicestoolkit/.<BR>You">http://www.alphaworks.ibm.com/tech/webservicestoolkit/.<BR>You</A>
  could also consider using GLUE which includes a command line tool for static 
generation of WSDL: <A 
HREF="http://www.themindelectric.com/";>http://www.themindelectric.com/</A>.<p>
  2.23&nbsp;&nbsp;<STRONG><A NAME="Q2_23">Is there a tool that can validate 
WSDL?</A></STRONG><BR>
   Yes Simon Fell has written a Schematron-based validator for SOAP oriented 
WSDL documents. See here: <A 
HREF="http://www.pocketsoap.com/wsdl/";>http://www.pocketsoap.com/wsdl/</A>.<p>
  2.25&nbsp;&nbsp;<STRONG><A NAME="Q2_25">Is it possible to pass parameters to 
the constructor in a SOAP application ?</A></STRONG><BR>
   No unfortunately it isn't. The SOAP server requires that you have a public 
no-argument constructor - this is what used to create an instance of your 
target service provider. <BR>An alternative to parameter passing is to load the 
information you need from a property file.<p>
  2.26&nbsp;&nbsp;<STRONG><A NAME="Q2_26">How do I write a SOAP service that 
maintains state across a session?</A></STRONG><BR>
   Both the client and the server have to be modified to use maintain state 
across a session:<BR><BR>(a) Setting the scope to "Session" tells the 
server-side to store the target object in the context of the session. You do 
this in the deployment descriptor (scope="Session"). <BR><BR>(b) The client 
side needs to be told to return the cookies that help the maintain 
sessions:<BR> // Build the call.<BR> Call call = new Call();<BR> // We require 
the session to be maintained<BR> SOAPHTTPConnection conn = new 
SOAPHTTPConnection();<BR> conn.setMaintainSession(true);<BR> 
call.setSOAPTransport(conn); <BR><BR>See the samples.addressbook2.Main sample 
code for a detailed example of how to do this.<p>
  2.27&nbsp;&nbsp;<STRONG><A NAME="Q2_27">Where can I find the WSDL 
specification document?</A></STRONG><BR>
   The WSDL specification document is available <A 
HREF="at<BR>http://www.w3.org/TR/wsdl";>at<BR>http://www.w3.org/TR/wsdl</A>.<p>
  
  
  <p><H2><u>3.&nbsp;&nbsp;Installation</u></H2>
  3.0&nbsp;&nbsp;<STRONG><A NAME="Q3_0">Can I install Apache-SOAP 2.1 on Tomcat 
4.0 beta?</A></STRONG><BR>
   Catalina (Tomcat 4) uses a different class loading model to the tomcat 3.* 
series so if you follow the Tomcat instructions in the soap distribution when 
the soap web application is loaded it will not be able to find 
org.apache.soap.* or the SAX classes needed. However it should work If you put 
xerces.jar and soap.jar into the lib directory under WEB-INF under your web 
application.<p>
  3.1&nbsp;&nbsp;<STRONG><A NAME="Q3_1">How do I install Apache-SOAP on 
Tomcat?</A></STRONG><BR>
   Follow the instructions that are included with the Apache-SOAP distribution. 
Make sure that you read the instructions carefully as there are a bunch of 
'gotchas'.<BR>Xmethods.com have a good tutorial which includes setup 
information: <A 
HREF="http://www.xmethods.com/gettingstarted/apache.html";>http://www.xmethods.com/gettingstarted/apache.html</A>
 <p>
  3.2&nbsp;&nbsp;<STRONG><A NAME="Q3_2">How do I install Apache-SOAP on Bea 
WebLogic 6.0?</A></STRONG><BR>
   Dion Almaer has written an article about this: <A 
HREF="http://www.almaer.com/weblogic60.html";>http://www.almaer.com/weblogic60.html</A>.
 There are some additional comments here: <A 
HREF="http://marc.theaimsgroup.com/?l=soap-user&m=98808422428291&w=2";>http://marc.theaimsgroup.com/?l=soap-user&m=98808422428291&w=2</A>.<p>
  3.3&nbsp;&nbsp;<STRONG><A NAME="Q3_3">How do I install Apache-SOAP on 
Resin?</A></STRONG><BR>
   Under Resin 1.2.3 configure a web app to point to the soap webapp directory 
(i.e.<path-to-apache-soap>/webapps/soap).<p>
  3.4&nbsp;&nbsp;<STRONG><A NAME="Q3_4">How do I install Apache-SOAP on IBM 
WebSphere?</A></STRONG><BR>
   Wouter Cloetens has provided instructions on using Apache-SOAP with IBM 
Websphere v1 v2 and v3.0 on <A 
HREF="http://workspot.net/~zombie/soap/.<BR>There">http://workspot.net/~zombie/soap/.<BR>There</A>
  are also instructions for WebSphere v3.5 in the Apache-SOAP distribution - 
see <A 
HREF="http://xml.apache.org/websrc/cvsweb.cgi/~checkout~/xml-soap/java/docs/install/websphere.html?rev=1.1&content-type=text/html&only_with_tag=MAIN";>http://xml.apache.org/websrc/cvsweb.cgi/~checkout~/xml-soap/java/docs/install/websphere.html?rev=1.1&content-type=text/html&only_with_tag=MAIN</A>.<p>
  3.5&nbsp;&nbsp;<STRONG><A NAME="Q3_5">How do I install Apache-SOAP on 
Bluestone?</A></STRONG><BR>
   The Bluestone people provide a download with instructions and samples: <A 
HREF="http://gallery.bluestone.com/scripts/SaISAPI.dll/Gallery.class/techDownloads/index.jsp";>http://gallery.bluestone.com/scripts/SaISAPI.dll/Gallery.class/techDownloads/index.jsp</A>
 <p>
  3.6&nbsp;&nbsp;<STRONG><A NAME="Q3_6">How do I install Apache-SOAP on 
Orion?</A></STRONG><BR>
   Have a look here: <A 
HREF="http://marc.theaimsgroup.com/?l=soap-dev&m=97678072329144&q=p3";>http://marc.theaimsgroup.com/?l=soap-dev&m=97678072329144&q=p3</A>
 <p>
  3.7&nbsp;&nbsp;<STRONG><A NAME="Q3_7">How do I install Apache-SOAP on 
Apache-JServ?</A></STRONG><BR>
   Here are some instructions: <A 
HREF="http://marc.theaimsgroup.com/?l=soap-user&m=98890652006035&w=2";>http://marc.theaimsgroup.com/?l=soap-user&m=98890652006035&w=2</A>.<p>
  3.8&nbsp;&nbsp;<STRONG><A NAME="Q3_8">How do I install Apache-SOAP on 
iPlanet?</A></STRONG><BR>
   See Erik Onnen's article here: <A 
HREF="http://marc.theaimsgroup.com/?l=soap-user&m=98753020626284&q=p3";>http://marc.theaimsgroup.com/?l=soap-user&m=98753020626284&q=p3</A>.<p>
  3.10&nbsp;&nbsp;<STRONG><A NAME="Q3_10">How do I install Apache-SOAP on 
Unify's ServletExec?</A></STRONG><BR>
   See <A 
HREF="http://marc.theaimsgroup.com/?l=soap-user&m=97741067209680&w=2";>http://marc.theaimsgroup.com/?l=soap-user&m=97741067209680&w=2</A>
 <p>
  
  
  <p><H2><u>4.&nbsp;&nbsp;Troubleshooting</u></H2>
  4.2&nbsp;&nbsp;<STRONG><A NAME="Q4_2">Help! Visual Age can't compile SOAP - 
it says I'm missing package com.ibm.xmi.job.*</A></STRONG><BR>
   These classes can be downloaded from <A 
HREF="http://www.alphaworks.ibm.com/aw.nsf/textformula/bc977085639b0fb888256a10006";>http://www.alphaworks.ibm.com/aw.nsf/textformula/bc977085639b0fb888256a10006</A>.
 The missing package is a xmisoap.jar which contains the following files: 
<BR>com.ibm.xmi.framework.* <BR>com.ibm.xmi.job.* <BR>com.ibm.xmi.utility.*<p>
  4.7&nbsp;&nbsp;<STRONG><A NAME="Q4_7">Help! I'm using Tomcat+SOAP on Linux. 
When I try to access the SOAP admin page, Tomcat crashes and I see this 
message: "HotSpot Virtual Machine Error, Unexpected Signal 11"</A></STRONG><BR>
   This may be related to a jdk1.3 bug on linux; try<BR>- using jdk1.2<BR>- 
using the -server or -client option on the jdk1.3 JVM<p>
  
  
  <p><H2><u>5.&nbsp;&nbsp;SOAP and .NET</u></H2>
  5.3&nbsp;&nbsp;<STRONG><A NAME="Q5_3">Help! My Apache SOAP Client cannot 
connect to a .NET service - the server says it expects 'text/xml' and doesn't 
understand "text/xml; charset=utf-8".</A></STRONG><BR>
   There is also a kludgy workaround to allow an Apache-SOAP client to send the 
request with just "text/xml" in the Content-Type header. See some of the 
examples e.g. samples/xmethods/GetTemp.java.<BR>SOAP users have also commented 
that if you upgrade to MSSoap toolkit 2.0 beta2 (or even rc0) this problem 
seems to go away.<p>
  </OL>
  
  <HR NOSHADE TITLE="Page Footer"></BODY></HTML>
  
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to