jechawke    01/07/24 05:49:33

  Modified:    targets/soap/faq faq_chawke.html
  Log:
  Added some new faq entries.
  
  Revision  Changes    Path
  1.5       +30 -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.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- faq_chawke.html   2001/07/04 13:56:16     1.4
  +++ faq_chawke.html   2001/07/24 12:49:33     1.5
  @@ -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 Wed 04-Jul-2001 
01:55PM 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 Tue 24-Jul-2001 01:38 
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>
  @@ -19,14 +19,17 @@
   1.4&nbsp;&nbsp;<A HREF="#Q1_4">Help! I got this error message: "Fault String 
= org.w3c.dom.Node: method getNamespaceURI() java/lang/String; not 
found"</A><br>
   1.5&nbsp;&nbsp;<A HREF="#Q1_5">Help! The Samples won't work. Every time I 
run a sample client I get this response: 
     "Fault String = java.lang.NoSuchMethodError"</A><br>
  +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>
   <br></LI><LI><H2>General</H2>2.1&nbsp;&nbsp;<A HREF="#Q2_1">Where can I get 
help on SOAP issue XYZ?</A><br>
   2.2&nbsp;&nbsp;<A HREF="#Q2_2">Where can I find mailing list archives for 
the soap-user mailing list?</A><br>
   2.3&nbsp;&nbsp;<A HREF="#Q2_3">I'm just getting started with SOAP. Where can 
I find a tutorial on SOAP programming?</A><br>
   2.4&nbsp;&nbsp;<A HREF="#Q2_4">Are there any other SOAP FAQs 
available?</A><br>
  -2.5&nbsp;&nbsp;<A HREF="#Q2_5">How does SOAP compare with other XML 
protocols?</A><br>
  +2.5&nbsp;&nbsp;<A HREF="#Q2_5">Where can I download the SOAP specification 
document(s)?</A><br>
   2.6&nbsp;&nbsp;<A HREF="#Q2_6">Are there any good books on SOAP?</A><br>
   2.7&nbsp;&nbsp;<A HREF="#Q2_7">What other SOAP implementations are 
available?</A><br>
   2.8&nbsp;&nbsp;<A HREF="#Q2_8">What is meant by the phrase 'SOAP is a 
wire-level protocol'?</A><br>
  +2.9&nbsp;&nbsp;<A HREF="#Q2_9">How does SOAP compare with other XML 
protocols?</A><br>
   2.10&nbsp;&nbsp;<A HREF="#Q2_10">How do I use TcpTunnel and 
TcpTunnelGUI?</A><br>
   2.11&nbsp;&nbsp;<A HREF="#Q2_11">How do I use SOAP over SSL?</A><br>
   2.12&nbsp;&nbsp;<A HREF="#Q2_12">How do I use SOAP over SMTP?</A><br>
  @@ -43,6 +46,7 @@
   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>
  +2.36&nbsp;&nbsp;<A HREF="#Q2_36">How do I restrict access to the Apache SOAP 
administration client?</A><br>
   <br></LI><LI><H2>Installation</H2>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?</A><br>
   3.3&nbsp;&nbsp;<A HREF="#Q3_3">Can I install Apache-SOAP 2.1 on Tomcat 4.0 
beta?</A><br>
  @@ -68,7 +72,8 @@
   4.13&nbsp;&nbsp;<A HREF="#Q4_13">I'm getting an error telling me that class 
'XMLParserLiason' is not found. What is wrong?</A><br>
   4.14&nbsp;&nbsp;<A HREF="#Q4_14">Help! I'm getting this error message: 
"Unable to retrieve PropertyDescriptor for property 'checkMustUnderstands' of 
class 'class org.apache.soap.server.DeploymentDescriptor'.</A><br>
   4.15&nbsp;&nbsp;<A HREF="#Q4_15">Help! I'm getting this error: "BSF Error: 
Unable to load language: javascript". I'm using bsf 2.2 and js.jar from 
rhino14R3.zip.</A><br>
  -4.17&nbsp;&nbsp;<A HREF="#Q4_17">Help! I'm getting this error: "Caught 
SOAPException <SOAP-ENV:Client>: Error opening socket:connection refused: no 
further information"</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>
   <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>
  @@ -79,18 +84,21 @@
   5.12&nbsp;&nbsp;<A HREF="#Q5_12">I would like to write a SOAP service method 
that returns a DOM Document (org.w3c.dom.Document). How do I do this?</A><br>
   5.14&nbsp;&nbsp;<A HREF="#Q5_14">What is the performance difference (if any) 
between SOAP and RMI? Are there any benchmark test results available?</A><br>
   5.15&nbsp;&nbsp;<A HREF="#Q5_15">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.16&nbsp;&nbsp;<A HREF="#Q5_16">Are Apache SOAP calls synchronous or 
asynchronous?</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>
   <br></LI><LI><H2>SOAP and Serialization</H2>7.1&nbsp;&nbsp;<A 
HREF="#Q7_1">How do I send user defined java objects using SOAP?</A><br>
   7.2&nbsp;&nbsp;<A HREF="#Q7_2">What are the different SOAP encoding styles? 
Which should I use?</A><br>
   7.3&nbsp;&nbsp;<A HREF="#Q7_3">How do you serialize java.util.Date 
objects?</A><br>
  +7.7&nbsp;&nbsp;<A HREF="#Q7_7">How can I make a SOAP call which serializes 
both an xml literal and a string?</A><br>
   <br></LI><LI><H2>WSDL</H2>8.1&nbsp;&nbsp;<A HREF="#Q8_1">Where can I find 
the WSDL specification document?</A><br>
   8.2&nbsp;&nbsp;<A HREF="#Q8_2">Does Apache SOAP use WSDL?</A><br>
   8.3&nbsp;&nbsp;<A HREF="#Q8_3">How can I generate a WSDL file for my SOAP 
service?</A><br>
   8.4&nbsp;&nbsp;<A HREF="#Q8_4">Is there a tool that can validate 
WSDL?</A><br>
   8.5&nbsp;&nbsp;<A HREF="#Q8_5">Is there a command-line utility that I can 
use to generate a WSDL File?</A><br>
   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>
   <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>
   </OL>
  @@ -110,6 +118,9 @@
   1.5&nbsp;&nbsp;<STRONG><A NAME="Q1_5">Help! The Samples won't work. Every 
time I run a sample client I get this response: 
     "Fault String = java.lang.NoSuchMethodError"</A></STRONG><BR>
   Ensure that:<BR>(a) You have deployed the sample service you want to use. 
<BR>(b) Xerces.jar is the very first entry in your classpath (set this in 
tomcat.bat or tomcat.sh as per the SOAP installation instructions).<BR>(c) 
There are no other XML parsers in your classpath. Some people have experienced 
this problem due to an early version of the JAXP package hiding in 
JAVA_HOME/jre/lib/ext.<BR>(d) The sample classes are in the server's 
CLASSPATH.<p>
  +1.6&nbsp;&nbsp;<STRONG><A NAME="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></STRONG><BR>
  +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).<p>
   
   
   <p><H2><u>2.&nbsp;&nbsp;General</u></H2>
  @@ -121,14 +132,16 @@
   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>
   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">How does SOAP compare with other XML 
protocols?</A></STRONG><BR>
  -See 'XML Protocol Comparisons', produced by the W3C: <A 
HREF="http://www.w3.org/2000/03/29-XML-protocol-matrix";>http://www.w3.org/2000/03/29-XML-protocol-matrix</a>.<p>
  +2.5&nbsp;&nbsp;<STRONG><A NAME="Q2_5">Where can I download the SOAP 
specification document(s)?</A></STRONG><BR>
  +SOAP 1.1 is here: <A 
HREF="http://www.w3.org/TR/SOAP<BR>There">http://www.w3.org/TR/SOAP<BR>There</a>
 are also some other SOAP-related specs in this list: <A 
HREF="http://www.w3.org/TR/";>http://www.w3.org/TR/</a>.<p>
   2.6&nbsp;&nbsp;<STRONG><A NAME="Q2_6">Are there any good books on 
SOAP?</A></STRONG><BR>
   See <A 
HREF="http://www.soaprpc.com/books/";>http://www.soaprpc.com/books/</a>.<p>
   2.7&nbsp;&nbsp;<STRONG><A NAME="Q2_7">What other SOAP implementations are 
available?</A></STRONG><BR>
   A good list of SOAP implementations is available here: <A 
HREF="http://directory.google.com/Top/Computers/Programming/Internet/Web_Services/SOAP/Implementations/";>http://directory.google.com/Top/Computers/Programming/Internet/Web_Services/SOAP/Implementations/</a>
 <BR>and here: <A 
HREF="http://www.soap-wrc.com/webservices/default.asp";>http://www.soap-wrc.com/webservices/default.asp</a>
 <BR>and here: <A 
HREF="http://www.soapware.org/directory/4/implementations";>http://www.soapware.org/directory/4/implementations</a><p>
   2.8&nbsp;&nbsp;<STRONG><A NAME="Q2_8">What is meant by the phrase 'SOAP is a 
wire-level protocol'?</A></STRONG><BR>
   A Wire level protocol is a protocol for Cross machine component interaction. 
DCOM, RMI and CORBA are popular wire level protocols. SOAP is a new technology 
which brings about cross machine, cross language and cross platform 
interoperability. You can learn more about this from the following sites: 
<BR><A HREF="http://www.w3.org/TR/SOAP/";>http://www.w3.org/TR/SOAP/</a> <BR><A 
HREF="http://www.javaworld.com/javaworld/jw-03-2001/jw-0330-soap.html";>http://www.javaworld.com/javaworld/jw-03-2001/jw-0330-soap.html</a>
 <BR><A 
HREF="http://www.msdn.microsoft.com/soap";>http://www.msdn.microsoft.com/soap</a><p>
  +2.9&nbsp;&nbsp;<STRONG><A NAME="Q2_9">How does SOAP compare with other XML 
protocols?</A></STRONG><BR>
  +See 'XML Protocol Comparisons', produced by the W3C: <A 
HREF="http://www.w3.org/2000/03/29-XML-protocol-matrix";>http://www.w3.org/2000/03/29-XML-protocol-matrix</a>.<p>
   2.10&nbsp;&nbsp;<STRONG><A NAME="Q2_10">How do I use TcpTunnel and 
TcpTunnelGUI?</A></STRONG><BR>
   For a short answer, see <A 
HREF="http://marc.theaimsgroup.com/?l=soap-user&m=98628744413873&w=2";>http://marc.theaimsgroup.com/?l=soap-user&m=98628744413873&w=2</a>.
 There is also a great article on IBM's developerWorks site: <A 
HREF="http://www-106.ibm.com/developerworks/webservices/library/ws-peer3/?dwzone=ws";>http://www-106.ibm.com/developerworks/webservices/library/ws-peer3/?dwzone=ws</a>.<p>
   2.11&nbsp;&nbsp;<STRONG><A NAME="Q2_11">How do I use SOAP over 
SSL?</A></STRONG><BR>
  @@ -161,6 +174,8 @@
   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>
   Brought to you by the same folks that brought you UDDI, is the Web Services 
Definition Language. WSDL is an XML schema that defines documents, in XML 
format, that describe SOAP services. There is an IBM alphaWorks toolkit that 
generates Java service client libraries and service handler skeletons from a 
WSDL document. See the WSDL specification (<A 
HREF="http://www-106.ibm.com/developerworks/library/w-wsdl.html";>http://www-106.ibm.com/developerworks/library/w-wsdl.html</a>),
 and the IBM toolkit (<A 
HREF="http://www.alphaworks.ibm.com/tech/webservicestoolkit";>http://www.alphaworks.ibm.com/tech/webservicestoolkit</a>).<p>
  +2.36&nbsp;&nbsp;<STRONG><A NAME="Q2_36">How do I restrict access to the 
Apache SOAP administration client?</A></STRONG><BR>
  +There are a number of possible solutions (none of which are perfect):<BR>- 
Modify your servlet container's security settings so that only certain IP 
addresses can access the admin page. If you are running Tomcat with its 
security manager, you can add an entry for the soap webapp in the .policy file 
located in the conf directory, and then you can control which IP addresses the 
webapp will accept connections from.<BR>- Modify the code - see <A 
HREF="http://soap.manilasites.com/stories/storyReader$13";>http://soap.manilasites.com/stories/storyReader$13</a>
 <BR>- Modify your firewall configuration. Some firewalls can filter on URLs, 
and you could use this to prevent accesses to the admin page (although this 
wouldn't prevent someone from running the ServiceManagerClient directly).<p>
   
   
   <p><H2><u>3.&nbsp;&nbsp;Installation</u></H2>
  @@ -216,8 +231,9 @@
   Try using a later version of Xerces such as 1.4 (you're probably using 1.2.* 
or 1.3.1) and see if the problem goes away. Also, make sure that you have 
removed all previous versions of Apache SOAP from your classpath.<p>
   4.15&nbsp;&nbsp;<STRONG><A NAME="Q4_15">Help! I'm getting this error: "BSF 
Error: Unable to load language: javascript". I'm using bsf 2.2 and js.jar from 
rhino14R3.zip.</A></STRONG><BR>
   This is a result of a code change that the Mozilla folks made which is not 
backward-compatible. You have two options:  <BR>(a) Upgrade to Rhino 1.5. 
<BR>(b) Re-compile BSF against rhino14R3. The compiler will flag a line of code 
- remove the last parameter from the function call on this line and the problem 
should go away.<p>
  -4.17&nbsp;&nbsp;<STRONG><A NAME="Q4_17">Help! I'm getting this error: 
"Caught SOAPException <SOAP-ENV:Client>: Error opening socket:connection 
refused: no further information"</A></STRONG><BR>
  -The problem is caused by one of the following:<BR>(a) Your SOAP client isn't 
specifying the right port in the service URL, e.g.  It is using <A 
HREF="http://localhost:80/soap/servlet/rpcrouter";>http://localhost:80/soap/servlet/rpcrouter</a>
 but the SOAP service router is listening on port 8080 (i.e. <A 
HREF="http://localhost:8080/soap/servlet/rpcrouter";>http://localhost:8080/soap/servlet/rpcrouter</a>
 ). <BR>(b) Your SOAP client isn't specifying the right path in the service 
URL, e.g. it is using <A 
HREF="http://localhost:8080/rpcrouter";>http://localhost:8080/rpcrouter</a> 
instead of <A 
HREF="http://localhost:8080/soap/servlet/rpcrouter";>http://localhost:8080/soap/servlet/rpcrouter</a>.
 <BR>(c) Your application server/servlet container (e.g. Tomcat) isn't 
running.<p>
  +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>
   
   
   <p><H2><u>5.&nbsp;&nbsp;Design and Architecture Issues</u></H2>
  @@ -241,6 +257,8 @@
   There aren't any official benchmark test results available, but some ad hoc 
testing by SOAP users suggests that RMI is about 5 times faster than an 
unoptimized SOAP implementation. The XML parser is considered to be the 
bottleneck in Apache SOAP. <BR>Bear in mind that:<BR>- Apache SOAP 
implementations will be optimized in the future, and RMI probably won't. <BR>- 
The common expectation is that eventually, SOAP implementations will provide 
performance that is comparable to RMI.<BR>- RMI is Java only, SOAP isn't.<p>
   5.15&nbsp;&nbsp;<STRONG><A NAME="Q5_15">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></STRONG><BR>
   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.16&nbsp;&nbsp;<STRONG><A NAME="Q5_16">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>
   
   
   <p><H2><u>6.&nbsp;&nbsp;SOAP and Namespaces</u></H2>
  @@ -259,6 +277,8 @@
   The Apache SOAP library uses the 'SOAP-ENV:encodingStyle' attribute as a 
lookup qualifier when locating a Serializer for a Java object or a Deserializer 
for an XML element.<BR>The SOAP specification allows the 'encodingStyle' 
attribute to hold multiple URIs which denote increasingly general encoding 
rules. What isn't defined, however, is how a SOAP processor is to determine 
which encoding style to apply. Consequently, the Apache SOAP library does not 
support this syntax and will always treat the encodingStyle attribute value as 
a single URI reference.<BR>1. SOAP Encoding: This encoding style is identified 
by the SOAP Encoding URI <A 
HREF="http://schemas.xmlsoap.org/soap/encoding/";>http://schemas.xmlsoap.org/soap/encoding/</a>
 and is described fully in Section 5 of the SOAP specification. <BR>2. XMI 
Encoding <BR>3. Literal XML Encoding<p>
   7.3&nbsp;&nbsp;<STRONG><A NAME="Q7_3">How do you serialize java.util.Date 
objects?</A></STRONG><BR>
   Use BeanSerializer. Either add a mapping for date in the deployment xml file 
or call SOAPMappingRegistry.mapTypes() in your application. A more "correct" 
DateSerializer is planned that serializes using the ISO date format.<BR>Date 
objects should be converted to xsd:date (<A 
HREF="http://www.w3.org/TR/xmlschema-2/#date";>http://www.w3.org/TR/xmlschema-2/#date</a>)
 or xsd:timeInstant (<A 
HREF="http://www.w3.org/TR/xmlschema-2/#timeInstant";>http://www.w3.org/TR/xmlschema-2/#timeInstant</a>)
 to be SOAP compliant. <BR>The SOAP spec says, "For simple types, SOAP adopts 
all the types found in the section Built-in datatypes of the XML Schema Part 2: 
Datatypes", (<A 
HREF="http://www.w3.org/TR/SOAP/#_Toc478383514";>http://www.w3.org/TR/SOAP/#_Toc478383514</a>),
 but not all have been implemented<p>
  +7.7&nbsp;&nbsp;<STRONG><A NAME="Q7_7">How can I make a SOAP call which 
serializes both an xml literal and a string?</A></STRONG><BR>
  +You need to set different encoding styles for your parameters.<BR>Consider 
the addressbook client parameter creation:<BR>   params.addElement(new 
Parameter("nameToLookup", String.class,<BR>                                     
nameToLookup, null));<BR>That Parameter constructor has the following 
signature:<BR>   Parameter(String name, Class type, Object value, String 
encodingStyleURI);<BR><BR>The last argument doesn't have to be null - you can 
set it to something like Constants.NS_URI_SOAP_ENC or 
Constants.NS_URI_LITERAL_XML.<p>
   
   
   <p><H2><u>8.&nbsp;&nbsp;WSDL</u></H2>
  @@ -267,13 +287,15 @@
   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>.
 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>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.<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">Is there a tool that can validate 
WSDL?</A></STRONG><BR>
   Yes: Simon Fell has written a Schematron-based validator for SOAP oriented 
WSDL documents. See here: <A 
HREF="http://www.pocketsoap.com/wsdl/";>http://www.pocketsoap.com/wsdl/</a>. 
Note that the current version only checks the relationships between the various 
parts of the WSDL, it doesn't really check anything in the schema sections yet. 
A couple of folks on the schematron mailing list are working on some XSD 
checking code, and it will be added to the validator when its done.<p>
   8.5&nbsp;&nbsp;<STRONG><A NAME="Q8_5">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.<p>
   8.6&nbsp;&nbsp;<STRONG><A NAME="Q8_6">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.7&nbsp;&nbsp;<STRONG><A NAME="Q8_7">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>- 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>
   
   
   <p><H2><u>9.&nbsp;&nbsp;SOAP and .NET</u></H2>
  
  
  

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

Reply via email to