You are viewing a plain text version of this content. The canonical link for it is here.
Posted to soap-dev@xml.apache.org by du...@apache.org on 2001/05/21 23:25:38 UTC
cvs commit: xml-soap/java/docs faq_chawke.html changes.html faq.html
duftler 01/05/21 14:25:37
Modified: java/docs changes.html faq.html
Added: java/docs faq_chawke.html
Log:
Added a link to Jonathan's (included) FAQ. Jonathan has stated that he
intends to eventually merge his FAQ with the existing one, and host the
end-result on the Apache SOAP web-site.
Submitted by: Jonathan Chawke (j_chawke@hotmail.com)
Revision Changes Path
1.11 +3 -1 xml-soap/java/docs/changes.html
Index: changes.html
===================================================================
RCS file: /home/cvs/xml-soap/java/docs/changes.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- changes.html 2001/05/21 18:14:46 1.10
+++ changes.html 2001/05/21 21:25:29 1.11
@@ -51,7 +51,9 @@
will cause the SOAPHTTPConnection to return the appropriate cookies with requests.</li>
<li>Added a default encoding style property to SOAPMappingRegistry, to be used
when no encoding style is specified.</li>
- <li>Added some additional samples.</li>
+ <li>Removed special treatment of CDATA sections in the code that inserts
+escape sequences. The code will now round trip Strings correctly,
+whether they contain CDATA sections or not.</li>
</ul>
</li>
1.3 +4 -0 xml-soap/java/docs/faq.html
Index: faq.html
===================================================================
RCS file: /home/cvs/xml-soap/java/docs/faq.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- faq.html 2001/01/30 06:05:05 1.2
+++ faq.html 2001/05/21 21:25:31 1.3
@@ -57,6 +57,10 @@
<em><a href="http://www.xmethods.com/gettingstarted/apache.html">A Quick-Start Guide for Installing Apache SOAP</a></em>
by XMethods.
</li>
+<li class="faqA">
+<em><a href="faq_chawke.html">Jonathan Chawke's SOAP FAQ</a></em> which will eventually be merged with
+this FAQ and hosted on the Apache SOAP web-site.
+</li>
</ul>
1.1 xml-soap/java/docs/faq_chawke.html
Index: faq_chawke.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML><HEAD><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows-1252">
<style type="text/css"><!--
H1 { font-family : Arial, Helvetica; font-size : 14pt }
H2 { font-family : Arial, Helvetica; font-style: italic; font-size : 12pt }
H3 { font-family : Arial, Helvetica; font-size : 10pt }
CODE { font-family : Courier New, Courier; font-size : 9pt; color : #0000ff }
PRE { font-family : Courier New, Courier; font-size : 9pt; color : #0000ff } --> </style>
<TITLE>Apache-SOAP User's FAQ</TITLE>
<META NAME="subject" CONTENT="Apache-SOAP User's FAQ">
</HEAD>
<BODY LINK="#0000ff" VLINK="#800080">
<H1>Apache-SOAP User's FAQ</H1>
<H1><A NAME="toc">Table of Contents</A></H1><OL><LI><H2>General</H2>1.1 <A HREF="#Q1_1">Where can I get help on SOAP issue XYZ?</A><br>
1.2 <A HREF="#Q1_2">Where can I find mailing list archives for the soap-user mailing list?</A><br>
1.3 <A HREF="#Q1_3">I'm just getting started with SOAP. Where can I find a tutorial on SOAP programming?</A><br>
1.4 <A HREF="#Q1_4">How do I tell my Apache SOAP client to use a proxy server?</A><br>
1.5 <A HREF="#Q1_5">How do I perform Proxy Authentication with my Apache SOAP client?</A><br>
1.6 <A HREF="#Q1_6">How do I use TcpTunnel and TcpTunnelGUI?</A><br>
1.7 <A HREF="#Q1_7">How can I generate a WSDL file for my SOAP service?</A><br>
1.8 <A HREF="#Q1_8">How do I use SOAP over SSL?</A><br>
1.9 <A HREF="#Q1_9">How do I use SOAP over SMTP?</A><br>
1.10 <A HREF="#Q1_10">Where do I find nightly builds of the POP3 and SMTP beans?</A><br>
<br></LI><LI><H2>Installation</H2>2.1 <A HREF="#Q2_1">How do I install Apache-SOAP on Bea WebLogic 6.0?</A><br>
2.2 <A HREF="#Q2_2">How do I install Apache-SOAP on Resin?</A><br>
2.3 <A HREF="#Q2_3">How do I install Apache-SOAP on IBM WebSphere?</A><br>
2.4 <A HREF="#Q2_4">How do I install Apache-SOAP on Bluestone?</A><br>
2.5 <A HREF="#Q2_5">How do I install Apache-SOAP on Orion?</A><br>
<br></LI><LI><H2>Troubleshooting</H2>3.1 <A HREF="#Q3_1">Help! I'm getting this error: "Element must contain a:'faultcode' element"</A><br>
3.2 <A HREF="#Q3_2">Help! Visual Age can't compile SOAP - it says I'm missing package com.ibm.xmi.job.*</A><br>
<br></LI><LI><H2>SOAP and .NET</H2>4.1 <A HREF="#Q4_1">How do I Access a Apache SOAP Service using a Microsoft SOAP Client?</A><br>
4.2 <A HREF="#Q4_2">How do I Access a Microsoft SOAP Service using an Apache SOAP Client?</A><br>
4.3 <A HREF="#Q4_3">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>
<HR NOSHADE><H2>Questions and Answers</H2>
<OL>
<p><H2><u>1. General</u></H2>
1.1 <STRONG><A NAME="Q1_1">Where can I get help on SOAP issue XYZ?</A></STRONG><BR>
Try subscribing to the soap user mailing list on <A HREF="http://xml.apache.org/soap/mail.html">http://xml.apache.org/soap/mail.html</A> or searching the mailing list archives (see "Where can I find mailing list archives for the soap-user mailing list?" for more information).<p>
1.2 <STRONG><A NAME="Q1_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>
1.3 <STRONG><A NAME="Q1_3">I'm just getting started with SOAP. Where can I find a tutorial on SOAP programming?</A></STRONG><BR>
Try here: <A HREF="http://www.perfectxml.com/articles/xml/hellosoap.asp">http://www.perfectxml.com/articles/xml/hellosoap.asp</A> and here: <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>.<p>
1.4 <STRONG><A NAME="Q1_4">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);<p>
1.5 <STRONG><A NAME="Q1_5">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>
1.6 <STRONG><A NAME="Q1_6">How do I use TcpTunnel and TcpTunnelGUI?</A></STRONG><BR>
There is 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>
1.7 <STRONG><A NAME="Q1_7">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.alphaworks.ibm.com/tech/webservicestoolkit/">http://www.alphaworks.ibm.com/tech/webservicestoolkit/</A>.<p>
1.8 <STRONG><A NAME="Q1_8">How do I use SOAP over SSL?</A></STRONG><BR>
See the Apache-SOAP SSL FAQ: <A HREF="http://xml.apache.org/websrc/cvsweb.cgi/~checkout~/xml-soap/java/docs/install/FAQ_Tomcat_SOAP_SSL.html">http://xml.apache.org/websrc/cvsweb.cgi/~checkout~/xml-soap/java/docs/install/FAQ_Tomcat_SOAP_SSL.html</A> <p>
1.9 <STRONG><A NAME="Q1_9">How do I use SOAP over SMTP?</A></STRONG><BR>
See the Apache-SMTP FAQ available in the soap user mail archives: <A HREF="http://marc.theaimsgroup.com/?l=soap-user&m=98692249417026&q=p3">http://marc.theaimsgroup.com/?l=soap-user&m=98692249417026&q=p3</A>.<p>
1.10 <STRONG><A NAME="Q1_10">Where do I find nightly builds of the POP3 and SMTP beans?</A></STRONG><BR>
You'll find them here: <A HREF="http://www.alphaworks.ibm.com/ab.nsf/">http://www.alphaworks.ibm.com/ab.nsf/</A>.<p>
<p><H2><u>2. Installation</u></H2>
2.1 <STRONG><A NAME="Q2_1">How do I install Apache-SOAP on Bea WebLogic 6.0?</A></STRONG><BR>
Dion Almaer has written an article about this: <A HREF="http://www.almaer.com/weblogic60.html">http://www.almaer.com/weblogic60.html</A>.<p>
2.2 <STRONG><A NAME="Q2_2">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).<p>
2.3 <STRONG><A NAME="Q2_3">How do I install Apache-SOAP on IBM WebSphere?</A></STRONG><BR>
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/.<BR>There">http://workspot.net/~zombie/soap/.<BR>There</A> 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>.<p>
2.4 <STRONG><A NAME="Q2_4">How do I install Apache-SOAP on Bluestone?</A></STRONG><BR>
Coming soon!<p>
2.5 <STRONG><A NAME="Q2_5">How do I install Apache-SOAP on Orion?</A></STRONG><BR>
Coming soon!<p>
<p><H2><u>3. Troubleshooting</u></H2>
3.1 <STRONG><A NAME="Q3_1">Help! I'm getting this error: "Element must contain a:'faultcode' element"</A></STRONG><BR>
This is probably due to a bug in some newer releases of Xerces (e.g. 1.3.1). Try using Xerces 1.2.3 or 1.3.0 instead - have a look on <A HREF="http://xml.apache.org/dist/xerces-j/">http://xml.apache.org/dist/xerces-j/</A>. You should also make sure that it is the FIRST entry in your CLASSPATH.<p>
3.2 <STRONG><A NAME="Q3_2">Help! Visual Age can't compile SOAP - it says I'm missing package com.ibm.xmi.job.*</A></STRONG><BR>
These classes can be downloaded from <A HREF="http://www.alphaworks.ibm.com/aw.nsf/textformula/bc977085639b0fb888256a10006">http://www.alphaworks.ibm.com/aw.nsf/textformula/bc977085639b0fb888256a10006</A>. The missing package is a xmisoap.jar which contains the following files: <BR>com.ibm.xmi.framework.* <BR>com.ibm.xmi.job.* <BR>com.ibm.xmi.utility.*<p>
<p><H2><u>4. SOAP and .NET</u></H2>
4.1 <STRONG><A NAME="Q4_1">How do I Access a Apache SOAP Service using a Microsoft SOAP Client?</A></STRONG><BR>
Coming soon!<p>
4.2 <STRONG><A NAME="Q4_2">How do I Access a Microsoft SOAP Service using an Apache SOAP Client?</A></STRONG><BR>
Coming soon!<p>
4.3 <STRONG><A NAME="Q4_3">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>
</OL>
<HR NOSHADE TITLE="Page Footer"></BODY></HTML>