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 Tue, 24 Jul 2001 12:49:33 GMT
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:j_chawke@hotmail.com">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:j_chawke@hotmail.com">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: general-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: general-cvs-help@xml.apache.org


Mime
View raw message