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, 17 Oct 2002 07:45:15 GMT
jechawke    2002/10/17 00:45:14

  Modified:    targets/soap/faq faq_chawke.html
  Log:
  Added some new faq entries, made some minor corrections.
  
  Revision  Changes    Path
  1.12      +29 -8     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.11
  retrieving revision 1.12
  diff -u -r1.11 -r1.12
  --- faq_chawke.html	25 Jun 2002 11:37:16 -0000	1.11
  +++ faq_chawke.html	17 Oct 2002 07:45:14 -0000	1.12
  @@ -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 25-Jun-2002 01:06 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 17-Oct-2002 07:44 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">Where can I find out about Axis?</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,13 +58,14 @@
   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">I'm not sure which version of the Apache-SOAP
jar (soap.jar) I'm using. How can I tell?</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>
   3.4&nbsp;&nbsp;<A HREF="#Q3_4">How do I install Apache-SOAP on Bea WebLogic
5.1?</A><br>
   3.5&nbsp;&nbsp;<A HREF="#Q3_5">How do I install Apache-SOAP on Bea WebLogic
6.0?</A><br>
   3.6&nbsp;&nbsp;<A HREF="#Q3_6">How do I install Apache-SOAP on Bea WebLogic
6.1?</A><br>
  -3.7&nbsp;&nbsp;<A HREF="#Q3_7">How do I install Apache-SOAP on Resin?</A><br>
  +3.7&nbsp;&nbsp;<A HREF="#Q3_7">How do I install Apache-SOAP on Bea WebLogic
7.0?</A><br>
   3.8&nbsp;&nbsp;<A HREF="#Q3_8">How do I install Apache-SOAP on IBM WebSphere?</A><br>
   3.9&nbsp;&nbsp;<A HREF="#Q3_9">How do I install Apache-SOAP on Bluestone?</A><br>
   3.10&nbsp;&nbsp;<A HREF="#Q3_10">How do I install Apache-SOAP on Orion?</A><br>
  @@ -71,8 +73,10 @@
   3.12&nbsp;&nbsp;<A HREF="#Q3_12">How do I install Apache-SOAP on iPlanet
Web Server?</A><br>
   3.13&nbsp;&nbsp;<A HREF="#Q3_13">How do I install Apache-SOAP on iPlanet
Application Server?</A><br>
   3.14&nbsp;&nbsp;<A HREF="#Q3_14">How do I install Apache-SOAP on Unify's
ServletExec?</A><br>
  +3.15&nbsp;&nbsp;<A HREF="#Q3_15">How do I install Apache-SOAP on Resin?</A><br>
   3.16&nbsp;&nbsp;<A HREF="#Q3_16">How do I install Apache-SOAP on Oracle 8i
Application Server?</A><br>
   3.18&nbsp;&nbsp;<A HREF="#Q3_18">How do I install Apache-SOAP on Borland
Application Server (BAS) 4.5?</A><br>
  +3.19&nbsp;&nbsp;<A HREF="#Q3_19">How do I install Apache SOAP on MacOS X?</A><br>
   <br></LI><LI><H2>Troubleshooting</H2><i>This section
answers general troubleshooting queries.</i><p>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>
  @@ -93,6 +97,7 @@
   4.21&nbsp;&nbsp;<A HREF="#Q4_21">I think I may have an old XML/Servlet library
which is causing problems with SOAP. How do I determine if this library is being used?</A><br>
   4.22&nbsp;&nbsp;<A HREF="#Q4_22">Help! The calculator example won't work.
I'm seeing this error: ""SOAP-ENV:Server.BadTargetObjectURI
    - Unable to load BSF: script services not available withoutBSF: com.ibm.bsf.BSFManager</A><br>
  +4.23&nbsp;&nbsp;<A HREF="#Q4_23">I'm getting this error when sending/receiving
JavaBeans: java.lang.IllegalArgumentException: Unable to retrieve PropertyDescriptor for property
'xxx'. Help!</A><br>
   <br></LI><LI><H2>Design and Architecture Issues</H2><i>This
section aims to provide some opinions and suggestions on design and architecture issues.</i><p>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>
  @@ -134,6 +139,8 @@
   8.13&nbsp;&nbsp;<A HREF="#Q8_13">The WSTK proxygen tool generates a class
that requires a URL parameter in the constructor. What should I use?</A><br>
   8.14&nbsp;&nbsp;<A HREF="#Q8_14">Is there a simple tool which allows you
to test a SOAP service using WSDL?</A><br>
   8.15&nbsp;&nbsp;<A HREF="#Q8_15">Is there a Java API for parsing and manipulating
WSDL files?</A><br>
  +8.16&nbsp;&nbsp;<A HREF="#Q8_16">How do I define an array using WSDL?</A><br>
  +8.17&nbsp;&nbsp;<A HREF="#Q8_17">Is Web Services Meta Language (WSML) supported
by Apache SOAP?</A><br>
   <br></LI><LI><H2>SOAP and .NET</H2><i>This section
answers questions which arise when integrating with Microsoft's .NET platform.</i><p>9.1&nbsp;&nbsp;<A
HREF="#Q9_1">Does Apache SOAP work with Microsoft SOAP?</A><br>
   9.2&nbsp;&nbsp;<A HREF="#Q9_2">How do I Access a Apache SOAP Service using
a Microsoft SOAP (VB) Client?</A><br>
   9.3&nbsp;&nbsp;<A HREF="#Q9_3">How do I Access a Microsoft SOAP Service using
an Apache SOAP Client?</A><br>
  @@ -172,6 +179,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) Simon Fell's TcpTrace [<A HREF="http://www.pocketsoap.com/]">http://www.pocketsoap.com/]</a>,
which can handle very large data packets.<BR>(4) 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">Where can I find out about
Axis?</A></STRONG><BR>
  +Axis [<A HREF="http://xml.apache.org/axis/]">http://xml.apache.org/axis/]</a>
is essentially Apache SOAP 3.0. It is a from-scratch rewrite, designed around a streaming
model (using SAX internally rather than DOM). The intention is to create a more modular, more
flexible, and higher-performing SOAP implementation (relative to Apache SOAP 2.0).<BR>The
Axis FAQ is available here: <A HREF="http://xml.apache.org/axis/faq.html.<BR>An">http://xml.apache.org/axis/faq.html.<BR>An</a>
overview of Axis is available here: <A HREF="http://www.javaworld.com/javaworld/jw-01-2002/jw-0125-axis_p.html<BR>A">http://www.javaworld.com/javaworld/jw-01-2002/jw-0125-axis_p.html<BR>A</a>
quick comparison of Axis to Apache SOAP is also available here:<BR><A HREF="http://marc.theaimsgroup.com/?l=soap-user&m=103249135518918&w=2">http://marc.theaimsgroup.com/?l=soap-user&m=103249135518918&w=2</a>.<p>
   
   
   <p><H2><u>2.&nbsp;&nbsp;General</u></H2>
  @@ -239,6 +248,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">I'm not sure which version
of the Apache-SOAP jar (soap.jar) I'm using. How can I tell?</A></STRONG><BR>
  +One simple way of determining the version is to look at the size of the jar:<BR>-
The Apache-SOAP 2.0 jar is around 130 Kb<BR>- The Apache-SOAP 2.1 jar is around 195
Kb<BR>- The Apache-SOAP 2.2 jar is around 215 Kb<BR>- The Apache-SOAP 2.3.x jar
is usually around 275 Kb<p>
   
   
   <p><H2><u>3.&nbsp;&nbsp;Installation</u></H2>
  @@ -254,10 +265,10 @@
   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.6&nbsp;&nbsp;<STRONG><A NAME="Q3_6">How do I install Apache-SOAP
on Bea WebLogic 6.1?</A></STRONG><BR>
   It seems to be more or less the same process as that used for WebLogic 6.0, but there are
some (new) gotchas related to JAXP. See <A HREF="http://xml.apache.org/soap/faq/faq-for-WL6.1beta.html">http://xml.apache.org/soap/faq/faq-for-WL6.1beta.html</a>
[note: when WebLogic 6.1 is released, we will merge this FAQ with the Apache SOAP install
docs] and <A HREF="http://marc.theaimsgroup.com/?l=soap-user&m=99270271408539&w=2">http://marc.theaimsgroup.com/?l=soap-user&m=99270271408539&w=2</a>.
See also <A HREF="http://groups.google.com/groups?selm=9aa6e58.0201112156.c3e9724%40posting.google.com&oe=UTF8&output=gplain">http://groups.google.com/groups?selm=9aa6e58.0201112156.c3e9724%40posting.google.com&oe=UTF8&output=gplain</a>.<p>
  -3.7&nbsp;&nbsp;<STRONG><A NAME="Q3_7">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).
See also <A HREF="http://marc.theaimsgroup.com/?l=soap-user&m=99650513909887&w=2">http://marc.theaimsgroup.com/?l=soap-user&m=99650513909887&w=2</a>.<p>
  +3.7&nbsp;&nbsp;<STRONG><A NAME="Q3_7">How do I install Apache-SOAP
on Bea WebLogic 7.0?</A></STRONG><BR>
  +See instructions here: <A HREF="http://marc.theaimsgroup.com/?l=soap-user&m=102641868716713&w=2">http://marc.theaimsgroup.com/?l=soap-user&m=102641868716713&w=2</a>.<p>
   3.8&nbsp;&nbsp;<STRONG><A NAME="Q3_8">How do I install Apache-SOAP
on IBM WebSphere?</A></STRONG><BR>
  -Apache SOAP has worked under every version of WebSphere from 1.1 to 3.02. It will work
out of the box on WebSphere 3.5 with fixpak 2 applied. 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/">http://workspot.net/~zombie/soap/</a>.
There 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>.
<BR>Be sure to check the following items: <BR>1. Explicitly set the port number
that you have exposed the rpcrouter servlet on. Even if it is default(80), just mention it
in the URL as <A HREF="http://aaa.bbb.ccc.ddd:port/soap/servlet/rpcrouter">http://aaa.bbb.ccc.ddd:port/soap/servlet/rpcrouter</a>.
<BR>2. Verify that xerces is at the start of your path not only by setting it in the
App but also in the websphere configuration files (admin.config, setupclient.bat).<p>
  +Apache SOAP has worked under every version of WebSphere from 1.1 to 3.02. It will work
out of the box on WebSphere 3.5 with fixpak 2 applied. 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/">http://workspot.net/~zombie/soap/</a>.
There 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>.
<BR>Be sure to check the following items: <BR>1. Explicitly set the port number
that you have exposed the rpcrouter servlet on. Even if it is default(80), just mention it
in the URL as <A HREF="http://aaa.bbb.ccc.ddd:port/soap/servlet/rpcrouter">http://aaa.bbb.ccc.ddd:port/soap/servlet/rpcrouter</a>.
<BR>2. Verify that xerces is at the start of your path not only by setting it in the
App but also in the websphere configuration files (admin.config, setupclient.bat).<BR>There
is also an IBM tutorial on using SOAP with Websphere:  <A HREF="http://www-3.ibm.com/software/webservers/appserv/doc/v40/ae/infocenter/was/0607_soap.html">http://www-3.ibm.com/software/webservers/appserv/doc/v40/ae/infocenter/was/0607_soap.html</a>.<p>
   3.9&nbsp;&nbsp;<STRONG><A NAME="Q3_9">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.10&nbsp;&nbsp;<STRONG><A NAME="Q3_10">How do I install Apache-SOAP
on Orion?</A></STRONG><BR>
  @@ -270,10 +281,14 @@
   See the instructions on the iPlanet.com web site: <BR><A HREF="http://developer.iplanet.com/appserver/samples/soap/docs/index.html">http://developer.iplanet.com/appserver/samples/soap/docs/index.html</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.15&nbsp;&nbsp;<STRONG><A NAME="Q3_15">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).
See also <A HREF="http://marc.theaimsgroup.com/?l=soap-user&m=99650513909887&w=2">http://marc.theaimsgroup.com/?l=soap-user&m=99650513909887&w=2</a>.<p>
   3.16&nbsp;&nbsp;<STRONG><A NAME="Q3_16">How do I install Apache-SOAP
on Oracle 8i Application Server?</A></STRONG><BR>
   According to the Oracle folks, SOAP should work under the latest production release of
Oracle 8i, which is Oracle 8.1.7. Earlier releases of Oracle 8i (e.g 8.1.6) seem to be more
awkward: the JVM bundled with 8.1.6 has a bug that affects Xerces. See here for more information:
<A HREF="http://marc.theaimsgroup.com/?l=soap-user&m=98200304522497&w=2">http://marc.theaimsgroup.com/?l=soap-user&m=98200304522497&w=2</a>.<p>
   3.18&nbsp;&nbsp;<STRONG><A NAME="Q3_18">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>
  +3.19&nbsp;&nbsp;<STRONG><A NAME="Q3_19">How do I install Apache SOAP
on MacOS X?</A></STRONG><BR>
  +Follow the standard installation instructions, bearing in mind one gotcha: see <A HREF="http://marc.theaimsgroup.com/?l=soap-user&m=103219627001409&w=2">http://marc.theaimsgroup.com/?l=soap-user&m=103219627001409&w=2</a>.<p>
   
   
   <p><H2><u>4.&nbsp;&nbsp;Troubleshooting</u></H2>
  @@ -314,6 +329,8 @@
   4.22&nbsp;&nbsp;<STRONG><A NAME="Q4_22">Help! The calculator example
won't work. I'm seeing this error: ""SOAP-ENV:Server.BadTargetObjectURI
    - Unable to load BSF: script services not available withoutBSF: com.ibm.bsf.BSFManager</A></STRONG><BR>
   You might want to download bsf from<BR><A HREF="http://oss.software.ibm.com/developerworks/projects/bsf">http://oss.software.ibm.com/developerworks/projects/bsf</a>
<BR>and js from <A HREF="http://www.mozilla.org/rhino/download.html">http://www.mozilla.org/rhino/download.html</a>
<BR><BR>For more info, see:<BR><A HREF="http://marc.theaimsgroup.com/?l=soap-user&m=99687932626273&w=2">http://marc.theaimsgroup.com/?l=soap-user&m=99687932626273&w=2</a><p>
  +4.23&nbsp;&nbsp;<STRONG><A NAME="Q4_23">I'm getting this error when
sending/receiving JavaBeans: java.lang.IllegalArgumentException: Unable to retrieve PropertyDescriptor
for property 'xxx'. Help!</A></STRONG><BR>
  +One possible cause of this error is if you are using the BeanSerializer to send/receive
JavaBeans, and remembering to have the appropriate (presumably private) member variables for
the property, but FORGETTING to include the JavaBean accessor methods. Adding public accessors
may solve the problem. [Thanks to Richard Kennard for this entry].<p>
   
   
   <p><H2><u>5.&nbsp;&nbsp;Design and Architecture Issues</u></H2>
  @@ -383,9 +400,9 @@
   8.2&nbsp;&nbsp;<STRONG><A NAME="Q8_2">Does Apache SOAP use WSDL?</A></STRONG><BR>
   A WSDL document does not actually get used directly by the Apache SOAP API in any way.
It is simply an XML grammer that allows non-Apache SOAP client applications to discover the
methods and classes available in a SOAP service.<p>
   8.3&nbsp;&nbsp;<STRONG><A NAME="Q8_3">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.ibm.com/developerworks/webservices">http://www.ibm.com/developerworks/webservices</a>.
<BR><BR>You 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>.
<BR><BR>The Apache AXIS folks are also working on a tool called java2wsdl. See
<A HREF="http://xml.apache.org/axis/">http://xml.apache.org/axis/</a> for more
information.<BR><BR>SilverStream now provide a product called jBrokerWeb which
includes compilers to convert WSDL to Java and vice versa. See <A HREF="http://extend.silverstream.com/workbench/app/jsp/jbrokerweb.jsp">http://extend.silverstream.com/workbench/app/jsp/jbrokerweb.jsp</a>
for more information.<p>
  +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.ibm.com/developerworks/webservices">http://www.ibm.com/developerworks/webservices</a>.
<BR><BR>You 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>.
<BR><BR>The Apache AXIS folks are also working on a tool called java2wsdl. See
<A HREF="http://xml.apache.org/axis/">http://xml.apache.org/axis/</a> for more
information. <BR><BR>SilverStream now provide a product called jBrokerWeb which
includes compilers to convert WSDL to Java and vice versa. See <A HREF="http://extend.silverstream.com/workbench/app/jsp/jbrokerweb.jsp">http://extend.silverstream.com/workbench/app/jsp/jbrokerweb.jsp</a>
for more information.<p>
   8.4&nbsp;&nbsp;<STRONG><A NAME="Q8_4">How can I generate Java code
from an existing WSDL file?</A></STRONG><BR>
  -WASP from Systinet (formerly Idoox) includes a tool called WSDLCompiler. It is able to
generate Java and JavaScript code from WSDL 1.1. It is available at <A HREF="http://www.systinet.com/.<BR><BR>GLUE">http://www.systinet.com/.<BR><BR>GLUE</a>
from The Mind Electric includes a tool called 'wsdl2java' which also does this. See <A
HREF="http://www.themindelectric.com/">http://www.themindelectric.com/</a>.<p>
  +Apache Axis [<A HREF="http://xml.apache.org/axis/]">http://xml.apache.org/axis/]</a>
includes a tool for generating Java stubs from WSDL files. Bear in mind that the output of
WSDL2Java won't always work with Apache SOAP - see <A HREF="http://marc.theaimsgroup.com/?l=soap-user&m=103235649515321&w=2.<BR><BR>WASP">http://marc.theaimsgroup.com/?l=soap-user&m=103235649515321&w=2.<BR><BR>WASP</a>
from Systinet (formerly Idoox) includes a tool called WSDLCompiler. It is able to generate
Java and JavaScript code from WSDL 1.1. It is available at <A HREF="http://www.systinet.com/.<BR><BR>GLUE">http://www.systinet.com/.<BR><BR>GLUE</a>
from The Mind Electric includes a tool called 'wsdl2java' which also does this. See <A
HREF="http://www.themindelectric.com/">http://www.themindelectric.com/</a>.<p>
   8.5&nbsp;&nbsp;<STRONG><A NAME="Q8_5">Is there a command-line utility
that I can use to generate WSDL stub and skeleton files?</A></STRONG><BR>
   Yes - the IBM web services toolkit (<A HREF="http://www.ibm.com/developerworks/webservices/">http://www.ibm.com/developerworks/webservices/</a>)
includes a command-line java application that should do what you want: <BR>.com.ibm.wsdl.Main
-?<BR>Note that:<BR>(a) It is in the wsdl.jar library.<BR>(b) Passing in
'-?' (without the apostrophes) gets you a list of available commands that the class supports.<p>
   8.6&nbsp;&nbsp;<STRONG><A NAME="Q8_6">Is there a tool that can validate
WSDL?</A></STRONG><BR>
  @@ -408,13 +425,17 @@
   Yes, there is a very nice (and freely downloadable) Java application (with GUI) which can
generate and interactively test WSDL. For more information, see <A HREF="http://www.sics.se/~hamfors/">http://www.sics.se/~hamfors/</a>.<p>
   8.15&nbsp;&nbsp;<STRONG><A NAME="Q8_15">Is there a Java API for parsing
and manipulating WSDL files?</A></STRONG><BR>
   Yes. Anne Thomas Manes reports that there's a new Java API in the works called JWSDL (JSR
110 - see <A HREF="http://www.jcp.org/jsr/detail/110.jsp">http://www.jcp.org/jsr/detail/110.jsp</a>).
It's based on the WSDL4J API developed by IBM. You can obtain a preliminary implementation
of JWSDL from IBM (it's part of the WSTK).<BR>Systinet (formerly Idoox) also includes
a JWSDL library. You can download Systinet's SOAP implementation (WASP), which includes full
support for WSDL, from <A HREF="http://www.systinet.com/">http://www.systinet.com/</a>.<p>
  +8.16&nbsp;&nbsp;<STRONG><A NAME="Q8_16">How do I define an array using
WSDL?</A></STRONG><BR>
  +See <A HREF="http://www.soapware.org/bdg#arrays">http://www.soapware.org/bdg#arrays</a>.<p>
  +8.17&nbsp;&nbsp;<STRONG><A NAME="Q8_17">Is Web Services Meta Language
(WSML) supported by Apache SOAP?</A></STRONG><BR>
  +WSML is COM specific - see [<A HREF="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/soap/htm/soap_overview_72r0.asp]">http://msdn.microsoft.com/library/default.asp?url=/library/en-us/soap/htm/soap_overview_72r0.asp]</a>.
<BR>A WSML file is used to describe the mapping between a service (as described in the
WSDL file) and the methods which implement it in a COM object. <BR>The Axis/Java equivalent
is WSDD (Web Service Deployment Descriptor). <BR>The WSDL2Java program can generate
WSDD documents.<p>
   
   
   <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>).<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>
  +See:<BR>(a) <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>.
<BR>(b) See here for an example of a VB6 client using the high-level API in the MS SOAP
toolkit: <A HREF="http://www.scottnichol.com/vbclienthiapachesoap.htm">http://www.scottnichol.com/vbclienthiapachesoap.htm</a>.
<BR>(c) See here for an example of a VB6 client using the low-level API in the MS SOAP
toolkit: <BR><A HREF="http://www.scottnichol.com/vbclientapachesoap.htm">http://www.scottnichol.com/vbclientapachesoap.htm</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>
   See <A HREF="http://support.microsoft.com/directory/article.asp?id=q307279">http://support.microsoft.com/directory/article.asp?id=q307279</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>
  
  
  

---------------------------------------------------------------------
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