jechawke    01/09/20 05:41:22

  Modified:    targets/soap/faq faq_chawke.html
  Log:
  Added a bunch of new entries to the faq.
  
  Revision  Changes    Path
  1.7       +41 -5     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.6
  retrieving revision 1.7
  diff -u -r1.6 -r1.7
  --- faq_chawke.html   2001/08/07 13:43:17     1.6
  +++ faq_chawke.html   2001/09/20 12:41:22     1.7
  @@ -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:[EMAIL 
PROTECTED]">Jonathan Chawke</A>, and was last modified on Tue 07-Aug-2001 02:25 
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:[EMAIL 
PROTECTED]">Jonathan Chawke</A>, and was last modified on Thu 20-Sep-2001 
01:37PM 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>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>
  @@ -22,6 +22,7 @@
   1.6&nbsp;&nbsp;<A HREF="#Q1_6">Help! I'm getting this error: "Exception in 
thread "main" java.lang.NoSuchMethodError 
   at org.apache.soap.util.xml.QName.<init>(QName.java:80)"</A><br>
   1.7&nbsp;&nbsp;<A HREF="#Q1_7">Help! I'm getting this error: "Exception in 
thread "main" java.lang.AbstractMethodError at 
org.apache.soap.util.xml.QName.<init>(QName.java:80)"</A><br>
  +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>
   <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>
  @@ -44,6 +45,7 @@
   2.24&nbsp;&nbsp;<A HREF="#Q2_24">Help! I got the following error message: 
"SOAP Service Manager: Unable to read 'DeployedServices.ds': assuming fresh 
start"</A><br>
   2.28&nbsp;&nbsp;<A HREF="#Q2_28">How do I tell my Apache SOAP client to use 
a proxy server?</A><br>
   2.29&nbsp;&nbsp;<A HREF="#Q2_29">How do I perform Proxy Authentication with 
my Apache SOAP client?</A><br>
  +2.30&nbsp;&nbsp;<A HREF="#Q2_30">My Apache SOAP service needs to make 
connections to other Internet sites. How do I configure my SOAP service to use 
a proxy server?</A><br>
   2.31&nbsp;&nbsp;<A HREF="#Q2_31">Are there any commercially ready servlet 
containers which will support Apache SOAP clients ?</A><br>
   2.32&nbsp;&nbsp;<A HREF="#Q2_32">Where can I find a list of public SOAP 
services that are available on the Internet?</A><br>
   2.34&nbsp;&nbsp;<A HREF="#Q2_34">What tools are available that use Apache 
SOAP?</A><br>
  @@ -61,6 +63,7 @@
   3.11&nbsp;&nbsp;<A HREF="#Q3_11">How do I install Apache-SOAP on 
Apache-JServ?</A><br>
   3.12&nbsp;&nbsp;<A HREF="#Q3_12">How do I install Apache-SOAP on 
iPlanet?</A><br>
   3.14&nbsp;&nbsp;<A HREF="#Q3_14">How do I install Apache-SOAP on Unify's 
ServletExec?</A><br>
  +3.17&nbsp;&nbsp;<A HREF="#Q3_17">How do I install Apache-SOAP on Borland 
Application Server (BAS) 4.5?</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.3&nbsp;&nbsp;<A HREF="#Q4_3">Help! My client sees error message: 
"SOAP-ENV:Server.BadTargetObjectURI"</A><br>
   4.5&nbsp;&nbsp;<A HREF="#Q4_5">Help! I try to run my SOAP client I get this 
message: "Unsupported response content type "text/html", must be: "text/xml". 
Response was: HTTP Error 405 - Method Not Allowed".</A><br>
  @@ -76,6 +79,7 @@
   4.17&nbsp;&nbsp;<A HREF="#Q4_17">Help! I'm getting this error: "Caught 
SOAPException <SOAP-ENV:Client>: Error opening socket:connection 
refused"</A><br>
   4.18&nbsp;&nbsp;<A HREF="#Q4_18">Help! I'm getting this error when I run one 
of the MIME samples: "Error parsing response:
   javax.mail.MessagingException: Missing start boundary"</A><br>
  +4.19&nbsp;&nbsp;<A HREF="#Q4_19">Help! I'm getting this error: 
"java.lang.NoClassDefFoundError: 
javax/xml/transform/TransformerException"</A><br>
   <br></LI><LI><H2>Design and Architecture Issues</H2>5.2&nbsp;&nbsp;<A 
HREF="#Q5_2">Can a SOAP server maintain session between multiple client 
invocations?</A><br>
   5.3&nbsp;&nbsp;<A HREF="#Q5_3">What is an actor?</A><br>
   5.4&nbsp;&nbsp;<A HREF="#Q5_4">Can Apache-SOAP handle large (multiple 
megabyte) files?</A><br>
  @@ -88,6 +92,9 @@
   5.15&nbsp;&nbsp;<A HREF="#Q5_15">What is the performance difference (if any) 
between SOAP and RMI? Are there any benchmark test results available?</A><br>
   5.16&nbsp;&nbsp;<A HREF="#Q5_16">I am writing a SOAP service which returns a 
set of data. Is it better to return this data in an object, or as an XML data 
structure?</A><br>
   5.17&nbsp;&nbsp;<A HREF="#Q5_17">Are Apache SOAP calls synchronous or 
asynchronous?</A><br>
  +5.18&nbsp;&nbsp;<A HREF="#Q5_18">What is the 'best' way of sending XML data 
using SOAP?</A><br>
  +5.19&nbsp;&nbsp;<A HREF="#Q5_19">Does Apache SOAP use SAX or DOM for 
parsing/representation of XML?</A><br>
  +5.20&nbsp;&nbsp;<A HREF="#Q5_20">How does SOAP compare with CORBA?</A><br>
   <br></LI><LI><H2>SOAP and Namespaces</H2>6.1&nbsp;&nbsp;<A HREF="#Q6_1">What 
are all these SOAP Namespaces?</A><br>
   6.2&nbsp;&nbsp;<A HREF="#Q6_2">Do I need to use namespaces on my XML 
data?</A><br>
   6.3&nbsp;&nbsp;<A HREF="#Q6_3">What are all those namespace prefixes in my 
SOAP messages? Won't they keep validation from working?</A><br>
  @@ -103,8 +110,13 @@
   8.6&nbsp;&nbsp;<A HREF="#Q8_6">Is there a command-line utility that I can 
use to generate WSDL stub and skeleton files?</A><br>
   8.7&nbsp;&nbsp;<A HREF="#Q8_7">Any one know is there any open source UDDI  
server implementation?  (the UDDI4J server is locked into DB2)</A><br>
   8.8&nbsp;&nbsp;<A HREF="#Q8_8">Is there a tool that can be used to parse 
WSDL files?</A><br>
  +8.9&nbsp;&nbsp;<A HREF="#Q8_9">Where should I place my WSDL files?</A><br>
  +8.10&nbsp;&nbsp;<A HREF="#Q8_10">Where can I find out about how WSDL and 
UDDI work together?</A><br>
  +8.11&nbsp;&nbsp;<A HREF="#Q8_11">Where can I find out more about 
UDDI?</A><br>
   <br></LI><LI><H2>SOAP and .NET</H2>9.1&nbsp;&nbsp;<A HREF="#Q9_1">Does 
Apache SOAP work with Microsoft SOAP?</A><br>
   9.4&nbsp;&nbsp;<A HREF="#Q9_4">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>
  +9.5&nbsp;&nbsp;<A HREF="#Q9_5">Where can I find information about 
interoperating between an MS SOAP client and an Apache SOAP service?</A><br>
  +9.7&nbsp;&nbsp;<A HREF="#Q9_7">Where can I find an example of how to use the 
low-level MS SOAP API?</A><br>
   </OL>
   
   <HR NOSHADE><H2>Questions and Answers</H2>
  @@ -127,6 +139,8 @@
   The most likely cause of this problem is that you have more than one xml 
parser library (jar) in your classpath. Finding the other xml library can be 
tricky. Note that the JVM looks in two places BEFORE it looks at classpath. It 
finds "Bootstrap" classes and "Extension" classes first. $JAVA_HOME/jre/lib/ext 
is where the extension classes live. <BR>People often find another XML parser 
hiding in JAVA_HOME\jre\lib\ext. <BR>Libraries to look for include: xml.jar, 
xsltc.jar. The solution is to delete these jars (or move them to a directory 
that isn't included in the classpath).<BR>Note also that JRun users got around 
this problem by adding the xerces jar to the JRun classpath in 
<jrun>/lib/global.properties:<BR>    jrun.classpath=c:/myjars/xerces.jar;..�<p>
   1.7&nbsp;&nbsp;<STRONG><A NAME="Q1_7">Help! I'm getting this error: 
"Exception in thread "main" java.lang.AbstractMethodError at 
org.apache.soap.util.xml.QName.<init>(QName.java:80)"</A></STRONG><BR>
   See Question 1.6 above.<p>
  +1.8&nbsp;&nbsp;<STRONG><A NAME="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></STRONG><BR>
  +Matt Duftler has kindly provided a JSP page can tell you whether a 
JAXP-compliant parser is being found, what package the implementing classes of 
the org.w3c.dom interfaces are from, and whether the org.w3c.dom interfaces 
being resolved are namespace-aware. The JSP file is available here: <A 
HREF="http://marc.theaimsgroup.com/?l=soap-user&m=99669938017194&w=2";>http://marc.theaimsgroup.com/?l=soap-user&m=99669938017194&w=2</a>.<p>
   
   
   <p><H2><u>2.&nbsp;&nbsp;General</u></H2>
  @@ -135,7 +149,7 @@
   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: <BR><A 
HREF="http://www-106.ibm.com/developerworks/library/ws-peer2/";>http://www-106.ibm.com/developerworks/library/ws-peer2/</a>
  <BR><A 
HREF="http://www.perfectxml.com/articles/xml/hellosoap.asp";>http://www.perfectxml.com/articles/xml/hellosoap.asp</a>
  <BR><A 
HREF="http://www.soapwebservices.com/articles/what_is_soap.asp";>http://www.soapwebservices.com/articles/what_is_soap.asp</a>
 (shockwave flash presentation) <BR><A 
HREF="http://www.javapro.com/upload/free/features/javapro/2001/04apr01/prs0104/prs0104-1.asp";>http://www.javapro.com/upload/free/features/javapro/2001/04apr01/prs0104/prs0104-1.asp</a>
  <BR><A 
HREF="http://www.soaplite.com/#LINKS";>http://www.soaplite.com/#LINKS</a> <BR><A 
HREF="http://soap.manilasites.com/";>http://soap.manilasites.com/</a> <BR><A 
HREF="http://www.xmethods.net/gettingstarted/apache.html";>http://www.xmethods.net/gettingstarted/apache.html</a><p>
  +Try these links: <BR><A 
HREF="http://www-106.ibm.com/developerworks/library/ws-peer2/";>http://www-106.ibm.com/developerworks/library/ws-peer2/</a>
 <BR><A 
HREF="http://www.soapuser.com/client2.html";>http://www.soapuser.com/client2.html</a>
 <BR><A 
HREF="http://www.soapuser.com/server1.html";>http://www.soapuser.com/server1.html</a>
   <BR><A 
HREF="http://www.perfectxml.com/articles/xml/hellosoap.asp";>http://www.perfectxml.com/articles/xml/hellosoap.asp</a>
  <BR><A 
HREF="http://www.soapwebservices.com/articles/what_is_soap.asp";>http://www.soapwebservices.com/articles/what_is_soap.asp</a>
 (shockwave flash presentation) <BR><A 
HREF="http://www.javapro.com/upload/free/features/javapro/2001/04apr01/prs0104/prs0104-1.asp";>http://www.javapro.com/upload/free/features/javapro/2001/04apr01/prs0104/prs0104-1.asp</a>
  <BR><A 
HREF="http://www.soaplite.com/#LINKS";>http://www.soaplite.com/#LINKS</a> <BR><A 
HREF="http://soap.manilasites.com/";>http://soap.manilasites.com/</a> <BR><A 
HREF="http://www.xmethods.net/gettingstarted/apache.html";>http://www.xmethods.net/gettingstarted/apache.html</a><p>
   2.4&nbsp;&nbsp;<STRONG><A NAME="Q2_4">Are there any other SOAP FAQs 
available?</A></STRONG><BR>
   Yes, a list of FAQs is available here: <A 
HREF="http://www.SoapRPC.com/faqs/";>http://www.SoapRPC.com/faqs/</a>. You could 
also look at the SOAP FAQ maintained by Developmentor: <A 
HREF="http://www.develop.com/soap/soapfaq.htm";>http://www.develop.com/soap/soapfaq.htm</a>.<p>
   2.5&nbsp;&nbsp;<STRONG><A NAME="Q2_5">Where can I download the SOAP 
specification document(s)?</A></STRONG><BR>
  @@ -167,15 +181,17 @@
   2.20&nbsp;&nbsp;<STRONG><A NAME="Q2_20">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.22&nbsp;&nbsp;<STRONG><A NAME="Q2_22">Are there any ISP's that will host 
SOAP applications?</A></STRONG><BR>
  -We haven't heard of any yet, but there _are_ ISPs that host servlets and JSP 
pages, so it's probably just a matter of time:<BR>- <A 
HREF="http://www.servlets.com/isps/<BR>-">http://www.servlets.com/isps/<BR>-</a>
 <A 
HREF="http://www.adrenalinegroup.com/jwsisp.html";>http://www.adrenalinegroup.com/jwsisp.html</a><p>
  +We haven't heard of any yet, but there _are_ ISPs that host servlets and JSP 
pages, so it's probably just a matter of time:<BR>- <A 
HREF="http://www.servlets.com/isps/";>http://www.servlets.com/isps/</a> <BR>- <A 
HREF="http://www.adrenalinegroup.com/jwsisp.html";>http://www.adrenalinegroup.com/jwsisp.html</a><p>
   2.24&nbsp;&nbsp;<STRONG><A NAME="Q2_24">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.28&nbsp;&nbsp;<STRONG><A NAME="Q2_28">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);<BR>Call
 call = new Call(); // prepare the service 
invocation<BR>call.setSOAPTransport(conn); // use the proxy<p>
   2.29&nbsp;&nbsp;<STRONG><A NAME="Q2_29">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.30&nbsp;&nbsp;<STRONG><A NAME="Q2_30">My Apache SOAP service needs to make 
connections to other Internet sites. How do I configure my SOAP service to use 
a proxy server?</A></STRONG><BR>
  +There are at least two ways of doing this:<BR>(1) Dynamically modify your 
system properties at execution time:<BR>  Properties prop = 
System.getProperties(); <BR>  prop.put("http.proxyHost","yourProxy.com");<BR>  
prop.put("http.proxyPort","80");<BR><BR>(2) Let TOMCAT do the proxying for you. 
If you are using Tomcat as a servlet engine, you can set the environment 
variable TOMCAT_OPTS as follows:<BR>For a HTTP Proxy:<BR>    set 
TOMCAT_OPTS="-DProxyHost=your.proxy.server -DproxyPort=8080"<BR>For a SOCKS 
Proxy:<BR>    set TOMCAT_OPTS="-DsocksProxyHost=your.socks.server 
-DsocksProxyPort=1080"<p>
   2.31&nbsp;&nbsp;<STRONG><A NAME="Q2_31">Are there any commercially ready 
servlet containers which will support Apache SOAP clients ?</A></STRONG><BR>
  -Yes, here is a (probably incomplete) list (in no particular order) of 
servlet containers that various SOAP-users have used to host Apache-SOAP 
services:<BR>- Bea WebLogic 6.0 at <A 
HREF="http://www.bea.com/";>http://www.bea.com/</a> <BR>- Resin at <A 
HREF="http://www.caucho.com/";>http://www.caucho.com/</a> <BR>- IBM WebSphere at 
<A 
HREF="http://www-4.ibm.com/software/webservers/";>http://www-4.ibm.com/software/webservers/</a>
 <BR>- HP Bluestone at <A 
HREF="http://www.bluestone.com/";>http://www.bluestone.com/</a>  <BR>- Orion at 
<A HREF="http://www.orionserver.com/";>http://www.orionserver.com/</a> <BR>- 
iPlanet Application Server at <A 
HREF="http://www.iplanet.com/";>http://www.iplanet.com/</a> <BR>- ServletExec 
from Unify at <A HREF="http://www.unify.com/";>http://www.unify.com/</a>  
<BR>Note that we are not endorsing any of the above commercial products - just 
reporting what people have mentioned on the soap-users mailing list. Note that 
in most cases, a little bit of tweaking is required to get Apache-SOAP working 
under a given application server.<BR>The good news is that in most (if not all) 
cases, these teething problems have already been resolved by other SOAP users. 
See Section 3 of this FAQ for more information.<p>
  +Yes, here is a (probably incomplete) list (in no particular order) of 
servlet containers that various SOAP-users have used to host Apache-SOAP 
services:<BR>- Bea WebLogic 6.0 at <A 
HREF="http://www.bea.com/";>http://www.bea.com/</a> <BR>- Resin at <A 
HREF="http://www.caucho.com/";>http://www.caucho.com/</a> <BR>- IBM WebSphere at 
<A 
HREF="http://www-4.ibm.com/software/webservers/";>http://www-4.ibm.com/software/webservers/</a>
 <BR>- HP Bluestone at <A 
HREF="http://www.bluestone.com/";>http://www.bluestone.com/</a>  <BR>- Orion at 
<A HREF="http://www.orionserver.com/";>http://www.orionserver.com/</a> <BR>- 
iPlanet Application Server at <A 
HREF="http://www.iplanet.com/";>http://www.iplanet.com/</a> <BR>- Borland 
Application Server at <A 
HREF="http://www.borland.com/";>http://www.borland.com/</a> <BR>- ServletExec 
from Unify at <A HREF="http://www.unify.com/";>http://www.unify.com/</a>  
<BR>Note that we are not endorsing any of the above commercial products - just 
reporting what people have mentioned on the soap-users mailing list. Note that 
in most cases, a little bit of tweaking is required to get Apache-SOAP working 
under a given application server.<BR>The good news is that in most (if not all) 
cases, these teething problems have already been resolved by other SOAP users. 
See Section 3 of this FAQ for more information.<p>
   2.32&nbsp;&nbsp;<STRONG><A NAME="Q2_32">Where can I find a list of public 
SOAP services that are available on the Internet?</A></STRONG><BR>
   Salcentral maintain a searchable list of web services here: <A 
HREF="http://www.salcentral.com/";>http://www.salcentral.com/</a>. <BR>Xmethods 
have a list here as well: <A 
HREF="http://www.xmethods.net/";>http://www.xmethods.net/</a>.<p>
   2.34&nbsp;&nbsp;<STRONG><A NAME="Q2_34">What tools are available that use 
Apache SOAP?</A></STRONG><BR>
  @@ -186,7 +202,7 @@
   
   <p><H2><u>3.&nbsp;&nbsp;Installation</u></H2>
   3.1&nbsp;&nbsp;<STRONG><A NAME="Q3_1">What jar files do I need to provide 
for Apache-SOAP clients?</A></STRONG><BR>
  -For an Apache-SOAP 2.2 deployment, you will need to include the following 
jars:<BR>- xerces.jar<BR>- soap.jar<BR>- mail.jar<BR>- activation.jar<p>
  +For an Apache-SOAP 2.2 deployment, you will need to include the following 
jars:<BR>- xerces.jar<BR>- soap.jar<BR>- mail.jar<BR>- activation.jar<BR>The 
Apache-SOAP client-side dependencies are described in more detail on the 
web-site, in the "Installation" section, under the "Client-Side Instructions" 
heading. See <A 
HREF="http://xml.apache.org/soap/docs/";>http://xml.apache.org/soap/docs/</a> 
for this information.<p>
   3.2&nbsp;&nbsp;<STRONG><A NAME="Q3_2">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 have a good tutorial which includes setup information: 
<A 
HREF="http://www.xmethods.net/gettingstarted/apache.html";>http://www.xmethods.net/gettingstarted/apache.html</a><p>
   3.3&nbsp;&nbsp;<STRONG><A NAME="Q3_3">Can I install Apache-SOAP 2.1 on 
Tomcat 4.0 beta?</A></STRONG><BR>
  @@ -211,6 +227,8 @@
   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.14&nbsp;&nbsp;<STRONG><A NAME="Q3_14">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>
  +3.17&nbsp;&nbsp;<STRONG><A NAME="Q3_17">How do I install Apache-SOAP on 
Borland Application Server (BAS) 4.5?</A></STRONG><BR>
  +Installation of SOAP on BAS 4.5 is done in 3 steps:<BR>1) Deploy the <soap 
install dir>/webapps/soap.war using the deploy tool.<BR>2) Edit "<BAS451 
install dir>\var\servers\<server name>\adm\properties\ias.config" and add a 
line like "addpath <xerces install dir>/xerces.jar" at the end of the 
modifiable section."<BR>3) Add the required libraries either in the appserver 
or in the webcontainer.<BR> <BR>See <A 
HREF="http://marc.theaimsgroup.com/?l=soap-user&m=99728307503567&w=2";>http://marc.theaimsgroup.com/?l=soap-user&m=99728307503567&w=2</a>.
 Thanks to  <BR>Laurent Letellier and Colin Mondesir for this information.<p>
   
   
   <p><H2><u>4.&nbsp;&nbsp;Troubleshooting</u></H2>
  @@ -242,6 +260,8 @@
   4.18&nbsp;&nbsp;<STRONG><A NAME="Q4_18">Help! I'm getting this error when I 
run one of the MIME samples: "Error parsing response:
   javax.mail.MessagingException: Missing start boundary"</A></STRONG><BR>
   Ensure that you have added activation.jar and mail.jar to your classpath.<p>
  +4.19&nbsp;&nbsp;<STRONG><A NAME="Q4_19">Help! I'm getting this error: 
"java.lang.NoClassDefFoundError: 
javax/xml/transform/TransformerException"</A></STRONG><BR>
  +The javax.xml.transform.TransformerException class is in the xalan library - 
see <A 
HREF="http://xml.apache.org/xalan-j/index.html";>http://xml.apache.org/xalan-j/index.html</a>.
 Ensure that xalan.jar is in your SOAP server's classpath. If you're using an 
XSLT library other than xalan, make sure the jar defines 
javax.xml.transform.TransformerException.<p>
   
   
   <p><H2><u>5.&nbsp;&nbsp;Design and Architecture Issues</u></H2>
  @@ -269,6 +289,12 @@
   If the clients consuming the SOAP service are all written in Java, then it 
is probably easier to return objects. Otherwise you should probably return your 
data as XML (i.e. as DOM Elements).<p>
   5.17&nbsp;&nbsp;<STRONG><A NAME="Q5_17">Are Apache SOAP calls synchronous or 
asynchronous?</A></STRONG><BR>
   If you're using the HTTP transport then the calls are synchronous. If you're 
using the SMTP transport then calls are asynchronous. A number of people have 
discussed the need to provide one-way calls over HTTP - see <A 
HREF="http://marc.theaimsgroup.com/?l=soap-user&w=2&r=1&s=one-way&q=b";>http://marc.theaimsgroup.com/?l=soap-user&w=2&r=1&s=one-way&q=b</a>.<p>
  +5.18&nbsp;&nbsp;<STRONG><A NAME="Q5_18">What is the 'best' way of sending 
XML data using SOAP?</A></STRONG><BR>
  +Unfortunately there isn't a definitive answer (not yet anyway!). <BR>But 
here's a brief summary of the options:<BR>(a) Send the XML as a string (works 
ok until the string gets large, at which point performance really 
degrades)<BR>(b) Send the XML in the body of the Envelope (you need to marshall 
and unmarshall the data)<BR>(c) Send the XML as an attachment inside a message 
(you don't need to worry about serialisation or marshalling). See the MIME 
sample SOAP application for details on how to use attachments.<BR><BR>For more 
information, have a browse through the archives: <A 
HREF="http://marc.theaimsgroup.com/?l=soap-user&w=2&r=1&s=Best+way+to+send+XML&q=b";>http://marc.theaimsgroup.com/?l=soap-user&w=2&r=1&s=Best+way+to+send+XML&q=b</a>.<p>
  +5.19&nbsp;&nbsp;<STRONG><A NAME="Q5_19">Does Apache SOAP use SAX or DOM for 
parsing/representation of XML?</A></STRONG><BR>
  +Apache SOAP uses DOM. Axis, the next generation of Apache SOAP, is based on 
SAX (and performs significantly better as a result). See here for more 
information: <A 
HREF="http://xml.apache.org/axis/";>http://xml.apache.org/axis/</a>.<p>
  +5.20&nbsp;&nbsp;<STRONG><A NAME="Q5_20">How does SOAP compare with 
CORBA?</A></STRONG><BR>
  +See this article on IBM developerWorks: <A 
HREF="http://www-106.ibm.com/developerworks/webservices/library/ws-arc3/";>http://www-106.ibm.com/developerworks/webservices/library/ws-arc3/</a><p>
   
   
   <p><H2><u>6.&nbsp;&nbsp;SOAP and Namespaces</u></H2>
  @@ -308,6 +334,12 @@
   Have a look at the following:<BR>- Idoox WASP <A 
HREF="http://www.idoox.com";>http://www.idoox.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>
   8.8&nbsp;&nbsp;<STRONG><A NAME="Q8_8">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.9&nbsp;&nbsp;<STRONG><A NAME="Q8_9">Where should I place my WSDL 
files?</A></STRONG><BR>
  +Put the files in a directory on your web server, and make them available to 
SOAP clients. Don't forget that to put them in a location where SOAP clients 
have adequate permissions to download them (you can use your web browser to 
test downloading/viewing the WSDL file).<p>
  +8.10&nbsp;&nbsp;<STRONG><A NAME="Q8_10">Where can I find out about how WSDL 
and UDDI work together?</A></STRONG><BR>
  +Have a look here: <A 
HREF="http://www.uddi.org/bestpractices.html";>http://www.uddi.org/bestpractices.html</a><p>
  +8.11&nbsp;&nbsp;<STRONG><A NAME="Q8_11">Where can I find out more about 
UDDI?</A></STRONG><BR>
  +Have a look here: <A 
HREF="http://www.uddi.org/whitepapers.html";>http://www.uddi.org/whitepapers.html</a><p>
   
   
   <p><H2><u>9.&nbsp;&nbsp;SOAP and .NET</u></H2>
  @@ -315,6 +347,10 @@
   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>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>).<p>
   9.4&nbsp;&nbsp;<STRONG><A NAME="Q9_4">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>
  +9.5&nbsp;&nbsp;<STRONG><A NAME="Q9_5">Where can I find information about 
interoperating between an MS SOAP client and an Apache SOAP 
service?</A></STRONG><BR>
  +Have a look here:<BR><A 
HREF="http://xml.apache.org/soap/docs/guide/interop.html";>http://xml.apache.org/soap/docs/guide/interop.html</a>
 <BR><A 
HREF="http://www-106.ibm.com/developerworks/library/ws-ref3/?n-ws-5241";>http://www-106.ibm.com/developerworks/library/ws-ref3/?n-ws-5241</a>
 <BR><A 
HREF="http://www.perfectxml.com/articles/xml/soapguide.asp";>http://www.perfectxml.com/articles/xml/soapguide.asp</a><p>
  +9.7&nbsp;&nbsp;<STRONG><A NAME="Q9_7">Where can I find an example of how to 
use the low-level MS SOAP API?</A></STRONG><BR>
  +Here is a tutorial which shows how to write a SOAP client using the MS SOAP 
low-level API: <A 
HREF="http://www.soapuser.com/client4.html";>http://www.soapuser.com/client4.html</a><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