xml-general-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jecha...@apache.org
Subject cvs commit: xml-site/targets/soap/faq faq_chawke.html
Date Thu, 20 Sep 2001 12:41:22 GMT
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:j_chawke@hotmail.com">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:j_chawke@hotmail.com">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: general-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: general-cvs-help@xml.apache.org


Mime
View raw message