You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general-cvs@xml.apache.org by je...@apache.org on 2003/09/01 22:14:01 UTC

cvs commit: xml-site/targets/soap/faq faq_chawke.html

jechawke    2003/09/01 13:14:01

  Modified:    targets/soap/faq faq_chawke.html
  Log:
  Added some new faq entries, made some minor corrections.
  
  Revision  Changes    Path
  1.14      +10 -4     xml-site/targets/soap/faq/faq_chawke.html
  
  Index: faq_chawke.html
  ===================================================================
  RCS file: /home/cvs/xml-site/targets/soap/faq/faq_chawke.html,v
  retrieving revision 1.13
  retrieving revision 1.14
  diff -u -r1.13 -r1.14
  --- faq_chawke.html	15 Mar 2003 12:32:27 -0000	1.13
  +++ faq_chawke.html	1 Sep 2003 20:14:01 -0000	1.14
  @@ -11,7 +11,7 @@
   </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:j_chawke@hotmail.com">Jonathan Chawke</A>, and was last modified on Sat 15-Mar-2003 12:27 GMT.
  +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:j_chawke@hotmail.com">Jonathan Chawke</A>, and was last modified on Mon 01-Sep-2003 09:05 GMT.
   <br>Corrections and suggestions for new questions are always welcome.
   <H1><A NAME="toc">Table of Contents</A></H1><OL><LI><H2>Hot Topics</H2><i>This section answers questions that have been appearing frequently on the mailing list.</i><p>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>
  @@ -25,6 +25,7 @@
   1.8&nbsp;&nbsp;<A HREF="#Q1_8">I think I have an XML parser library problem. How can I determine exactly which library is being used by Apache SOAP?</A><br>
   1.9&nbsp;&nbsp;<A HREF="#Q1_9">How can I view the 'raw' XML data that is exchanged between a SOAP client and server?</A><br>
   1.10&nbsp;&nbsp;<A HREF="#Q1_10">I can't get SOAP working with Tomcat 4 (Catalina). Help!</A><br>
  +1.11&nbsp;&nbsp;<A HREF="#Q1_11">Help! I can't unsubscribe from the Apache-SOAP user mailing list!</A><br>
   <br></LI><LI><H2>General</H2><i>This section answers general questions.</i><p>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>
  @@ -57,6 +58,7 @@
   2.41&nbsp;&nbsp;<A HREF="#Q2_41">I'd like to deploy multiple services using a single deployment descriptor file. Is this possible?</A><br>
   2.42&nbsp;&nbsp;<A HREF="#Q2_42">Will Apache SOAP support JAXM when it's ready?</A><br>
   2.43&nbsp;&nbsp;<A HREF="#Q2_43">Will Apache SOAP support JAX-RPC?</A><br>
  +2.44&nbsp;&nbsp;<A HREF="#Q2_44">Is it possible to write a web service that can login to an FTP server and download a file?</A><br>
   <br></LI><LI><H2>Installation</H2><i>This section helps resolve questions which arise when installing Apache SOAP in a particular application server environment.</i><p>3.1&nbsp;&nbsp;<A HREF="#Q3_1">What jar files do I need to provide for Apache-SOAP clients?</A><br>
   3.2&nbsp;&nbsp;<A HREF="#Q3_2">How do I install Apache-SOAP on Tomcat 3.x?</A><br>
   3.3&nbsp;&nbsp;<A HREF="#Q3_3">Can I install Apache-SOAP 2.1 on Tomcat 4.0?</A><br>
  @@ -167,6 +169,8 @@
   There are a couple of tools which you can use to do this:<BR>(1) TcpTunnel (textual interface) / TcpTunnelGui (graphical interface), which are both provided with the standard Apache SOAP distribution. See <A HREF="http://xml.apache.org/soap/faq/faq_chawke.html#Q2_10">http://xml.apache.org/soap/faq/faq_chawke.html#Q2_10</a> for more information on how to use these tools. <BR>(2) UtilSnoop, described as its author as 'somewhat more user friendly' than TcpTunnelGui. It's available at <A HREF="http://www.lanw.com/books/javasoap/">http://www.lanw.com/books/javasoap/</a>. <BR>(3) Iona's XMLBus product seems to include a similar tool called the 'SOAP Message Spy' - see <A HREF="http://www.xmlbus.com/work/">http://www.xmlbus.com/work/</a>.<p>
   1.10&nbsp;&nbsp;<STRONG><A NAME="Q1_10">I can't get SOAP working with Tomcat 4 (Catalina). Help!</A></STRONG><BR>
   You probably need to do two things:<BR>(1) Modify your catalina.bat (or catalina.sh on Unix) file to include the soap libs in your classpath. <BR>(2) Catalina's class loader operates different that Tomcat 3, so you need to put soap.jar in the WEB-INF of the application's directory under a 'lib' sub-dir.<BR>For more detailed instructions, see here: <A HREF="http://marc.theaimsgroup.com/?l=soap-user&m=100802546024930&w=2">http://marc.theaimsgroup.com/?l=soap-user&m=100802546024930&w=2</a>.<p>
  +1.11&nbsp;&nbsp;<STRONG><A NAME="Q1_11">Help! I can't unsubscribe from the Apache-SOAP user mailing list!</A></STRONG><BR>
  +Should you decide to unsubscribe from the Apache SOAP user mailing list, you should send a mail to:<BR>soap-user-unsubscribe@ws.apache.org<BR>The old address (soap-user-unsubscribe@xml.apache.org) no longer works.<p>
   
   
   <p><H2><u>2.&nbsp;&nbsp;General</u></H2>
  @@ -197,7 +201,7 @@
   2.13&nbsp;&nbsp;<STRONG><A NAME="Q2_13">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.14&nbsp;&nbsp;<STRONG><A NAME="Q2_14">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 its design, see: <A HREF="http://www.extreme.indiana.edu/soap/">http://www.extreme.indiana.edu/soap/</a>. <BR>You could also consider using IBM's 'Web Services Development Environment' <A HREF="http://www.alphaworks.ibm.com/tech/wsde">http://www.alphaworks.ibm.com/tech/wsde</a> (warning: it is a big download). Among other things, it will automatically generate WSDL files from any java class or COM object, create a browser-based client, and deploy your services to Websphere or Apache.<BR>Also have a look at KSoap - a small-footprint SOAP lib for J2ME: <A HREF="http://ksoap.enhydra.org/index.html">http://ksoap.enhydra.org/index.html</a>. <BR>Systinet (formerly Idoox) also provide a JavaScript-based SOAP implementation that enables you to invoke a SOAP request from a browser. The JavaScript support is included in WASP Lite. You can download it from <A HREF="http://www.systinet.com/download.html">http://www.systinet.com/download.html</a>.<p>
  +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 its design, see: <A HREF="http://www.extreme.indiana.edu/soap/">http://www.extreme.indiana.edu/soap/</a>. <BR>You could also consider using IBM's 'Web Services Development Environment' <A HREF="http://www.alphaworks.ibm.com/tech/wsde">http://www.alphaworks.ibm.com/tech/wsde</a> (warning: it is a big download). Among other things, it will automatically generate WSDL files from any java class or COM object, create a browser-based client, and deploy your services to Websphere or Apache.<BR>Also have a look at KSoap - a small-footprint SOAP lib for J2ME: <A HREF="http://ksoap.enhydra.org/index.html.<BR>Systinet">http://ksoap.enhydra.org/index.html.<BR>Systinet</a> (formerly Idoox) also provide a JavaScript-based SOAP implementation that enables you to invoke a SOAP request from a browser. The JavaScript support is included in WASP Lite. You can download it from <A HREF="http://www.systinet.com/download.html.<BR>Last">http://www.systinet.com/download.html.<BR>Last</a> (but not least), you could also try WingFoot SOAP at <A HREF="http://www.wingfoot.com">http://www.wingfoot.com</a> - it provides full support for SOAP 1.1.<p>
   2.15&nbsp;&nbsp;<STRONG><A NAME="Q2_15">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.18&nbsp;&nbsp;<STRONG><A NAME="Q2_18">Is there a way to generate SOAP stub/skeleton code from a deployment descriptor?</A></STRONG><BR>
  @@ -234,6 +238,8 @@
   There are no plans at present to support JAXM (<A HREF="http://java.sun.com/xml/jaxm/">http://java.sun.com/xml/jaxm/</a>) in Apache SOAP. However, there are plans to provide JAXM support in Axis (<A HREF="http://xml.apache.org/axis/">http://xml.apache.org/axis/</a>).<p>
   2.43&nbsp;&nbsp;<STRONG><A NAME="Q2_43">Will Apache SOAP support JAX-RPC?</A></STRONG><BR>
   There are no plans at present to support JAX-RPC (<A HREF="http://java.sun.com/xml/jaxrpc/">http://java.sun.com/xml/jaxrpc/</a>) in Apache SOAP. However, the Axis (<A HREF="http://xml.apache.org/axis/">http://xml.apache.org/axis/</a>) developers report that Axis is already moving towards full compliance with the current JAX-RPC draft spec.<p>
  +2.44&nbsp;&nbsp;<STRONG><A NAME="Q2_44">Is it possible to write a web service that can login to an FTP server and download a file?</A></STRONG><BR>
  +Yes! Have a look here: <A HREF="http://dev.systinet.com/code_samples/demos/ftpservice">http://dev.systinet.com/code_samples/demos/ftpservice</a><p>
   
   
   <p><H2><u>3.&nbsp;&nbsp;Installation</u></H2>
  @@ -379,7 +385,7 @@
   8.7&nbsp;&nbsp;<STRONG><A NAME="Q8_7">Is there a command-line utility that I can use to generate a WSDL File?</A></STRONG><BR>
   Yes - the IBM web services toolkit (WSTK) 2.3 (<A HREF="http://www.ibm.com/developerworks/webservices/">http://www.ibm.com/developerworks/webservices/</a>) includes a utility called 'wsdlgen'. It is in WSTK_HOME/bin.<BR>See also the Open Source WSDL4J project on <A HREF="http://oss.software.ibm.com/developerworks/projects/wsdl4j/">http://oss.software.ibm.com/developerworks/projects/wsdl4j/</a>.<p>
   8.8&nbsp;&nbsp;<STRONG><A NAME="Q8_8">Any one know is there any open source UDDI  server implementation?  (the UDDI4J server is locked into DB2)</A></STRONG><BR>
  -Have a look at the following:<BR>- Systinet (formerly Idoox) WASP <A HREF="http://www.systinet.com/">http://www.systinet.com/</a> (not open source, uses JDBC)<BR>- The Mind Electric GLUE <A HREF="http://www.themindelectric.com">http://www.themindelectric.com</a> (not open source, uses JDBC)<BR>- jUUDI, on sourceforge at <A HREF="http://sourceforge.net/projects/uddi/">http://sourceforge.net/projects/uddi/</a>. It's relatively young (i.e. the current release is an alpha), but SOAP users report that the guy running the project is very helpful, and that it looks like the code runs off whichever db platform you want. Ensure you get the code from CVS, not the (tarball) release.<BR>- pUDDIng at <A HREF="http://www.opensorcerer.org/">http://www.opensorcerer.org/</a> (UDDI v2.0 on Oracle). The author is talking about adding support for other database platforms.<p>
  +Have a look at the following:<BR>- Systinet (formerly Idoox) WASP <A HREF="http://www.systinet.com/">http://www.systinet.com/</a> (not open source, uses JDBC)<BR>- The Mind Electric GLUE <A HREF="http://www.themindelectric.com">http://www.themindelectric.com</a> (not open source, uses JDBC)<BR>- jUUDI (pronounced 'Judy'), on sourceforge at <A HREF="http://sourceforge.net/projects/juddi/">http://sourceforge.net/projects/juddi/</a>. It's relatively young (the current release is a beta), but SOAP users report that the guy running the project is very helpful, and that it looks like the code runs off whichever db platform you want. Ensure you get the code from CVS, not the (tarball) release.<BR>- pUDDIng at <A HREF="http://www.opensorcerer.org/">http://www.opensorcerer.org/</a> (UDDI v2.0 on Oracle). The author is talking about adding support for other database platforms.<p>
   8.9&nbsp;&nbsp;<STRONG><A NAME="Q8_9">Is there a tool that can be used to parse WSDL files?</A></STRONG><BR>
   Yes, IBM have one. The Web Services Description Language for Java Toolkit (WSDL4J) allows the creation, representation, and manipulation of WSDL documents describing services. See <A HREF="http://oss.software.ibm.com/developerworks/projects/wsdl4j/">http://oss.software.ibm.com/developerworks/projects/wsdl4j/</a>.<p>
   8.10&nbsp;&nbsp;<STRONG><A NAME="Q8_10">Where should I place my WSDL files?</A></STRONG><BR>
  @@ -398,7 +404,7 @@
   
   <p><H2><u>9.&nbsp;&nbsp;SOAP and .NET</u></H2>
   9.1&nbsp;&nbsp;<STRONG><A NAME="Q9_1">Does Apache SOAP work with Microsoft SOAP?</A></STRONG><BR>
  -Yes, but with a number of 'gotchas'. You need to install a patch to the MS SOAP package. One of the well-known interoperability problems between Apache 2.0 and MS Soap is that MS clients do not send type information with each parameter, and the Apache soap server will reject such requests. <BR>Microsoft now have a useful resource page for interoperability (including articles specifically discussing integration with Apache SOAP): <A HREF="http://www.msdn.microsoft.com/library/default.asp?url=/library/en-us/dnsrvspec/html/globalxmlwebsrvinterop.asp?frame=true">http://www.msdn.microsoft.com/library/default.asp?url=/library/en-us/dnsrvspec/html/globalxmlwebsrvinterop.asp?frame=true</a>. <BR>James Snell has provided a patch adding the typing. It can be found at SOAP-WRC web site (<A HREF="http://www.soap-wrc.com/apache_ms_soap_interop.zip">http://www.soap-wrc.com/apache_ms_soap_interop.zip</a>). <BR>Both Apache and Microsoft are working hard to ensure interoperability between their SOAP implementations (in case you don't believe us, have a look here: <A HREF="http://marc.theaimsgroup.com/?l=soap-user&m=98505313219298&w=2">http://marc.theaimsgroup.com/?l=soap-user&m=98505313219298&w=2</a>).<BR>There are other problems with SOAP interoperability (in general) which are discussed here: <A HREF="http://www-106.ibm.com/developerworks/webservices/library/ws-inter.html">http://www-106.ibm.com/developerworks/webservices/library/ws-inter.html</a>.<p>
  +Yes, but with a (decreasing) number of 'gotchas'. If you are just getting started, we recommend you look at Apache Axis, which is the next generation SOAP implementation from Apache (<A HREF="http://ws.apache.org/axis/">http://ws.apache.org/axis/</a>). This interoperates very nicely with Microsoft SOAP. <BR>Microsoft now have a useful resource page for interoperability (including articles specifically discussing integration with Apache SOAP): <A HREF="http://www.msdn.microsoft.com/library/default.asp?url=/library/en-us/dnsrvspec/html/globalxmlwebsrvinterop.asp?frame=true">http://www.msdn.microsoft.com/library/default.asp?url=/library/en-us/dnsrvspec/html/globalxmlwebsrvinterop.asp?frame=true</a>. <BR>Both Apache and Microsoft are working hard to ensure interoperability between their SOAP implementations (in case you don't believe us, have a look here: <A HREF="http://marc.theaimsgroup.com/?l=soap-user&m=98505313219298&w=2">http://marc.theaimsgroup.com/?l=soap-user&m=98505313219298&w=2</a>).<BR>There are other problems with SOAP interoperability (in general) which are discussed here: <A HREF="http://www-106.ibm.com/developerworks/webservices/library/ws-inter.html">http://www-106.ibm.com/developerworks/webservices/library/ws-inter.html</a>.<p>
   9.2&nbsp;&nbsp;<STRONG><A NAME="Q9_2">How do I Access a Apache SOAP Service using a Microsoft SOAP (VB) Client?</A></STRONG><BR>
   See <A HREF="http://marc.theaimsgroup.com/?l=soap-user&m=98683038702626&amp;w=2">http://marc.theaimsgroup.com/?l=soap-user&m=98683038702626&amp;w=2</a>.<p>
   9.3&nbsp;&nbsp;<STRONG><A NAME="Q9_3">How do I Access a Microsoft SOAP Service using an Apache SOAP Client?</A></STRONG><BR>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: general-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: general-cvs-help@xml.apache.org