Changeset 941

Timestamp:

09/13/03 21:48:54 (5 years ago)

Author:

nahi

Message:

Document for 1.5.0

Files:

• trunk/RELEASE_en.html (modified) (11 diffs)

trunk/RELEASE_en.html

@@ -19 +19 @@
-
-<p class="status">
-January 17
+September 13
-Created: July 17, 2000
-</p>
@@ -34 +34 @@
-
-<p>
-4.8
+5.0
-</p>
-
@@ -54 +54 @@
-
-<p>
+Thousands of lines are changed in this release
+(*.rb in current SOAP4R distribution has 30kloc or over).
+But the biggest change is coding convention, camelCase to non_camel_case.
+Though I tried to keep compatibility between 1.5.0 and 1.4.8, but there's no
+way to keep it at a few point.  If you'll find your code which was developed
+for 1.4.8 does not run under 1.5.0, feel free to ask
+<a href="mailto:nakahiro@sarion.co.jp">me</a> to solve the problem.
+</p>
+<ul>
+  <li>Dependency libraries;
+  <ul>
+    <li>Add net/http support.  Users can try sample SOAP clients without installing http-access2.  For actual usage, consider installing http-access2 for speed and thread-safe SOAP client.  CAUTION: Building SOAP CGI server needs http-access2 to be installed.</li>
+    <li>Soap4r standalone server requires webrick module to be installed instead of GServer.rb and httpserver.rb.</li>
+    <li>Supports iconv.  To use utf-8, you need to install iconv(included in ruby/1.8) or uconv.</li>
+    <li>Suspend NQXML XML parser support.</li>
+    <li>Remove REXML processor version check.  No longer needed.</li>
+    <li>Rewrite tests with test/unit.</li>
+  </ul></li>
+
+  <li>Features;
+  <ul>
+    <li>Efforts to support messaging with document/literal and ASP.NET interoperability.</li>
+    <li>Add document/literal messaging interface to wsdlDriver.rb.  See a very brief example in sample/soapbox/wsdlDriver.rb though I still didn't try to login to Jabber server..  Jabber folks?</li>
+    <li>XML pretty printing.</li>
+    <li>Better Ruby object mapping.  Rewrote RubytypeFactory to support more Ruby objects.  Tests in AMarshal(http://cvs.m17n.org/~akr/amarshal/) much helped it.  Thanks very much to Tanaka Akira-san.</li>
+    <li>SOAPMarshal accepts IO as an output device like Marshal#dump.</li>
+    <li>SOAPElement: constructor signature change.  Added extraattrs attribute.</li>
+    <li>XSDDateTimeImpl: to_time did not set usec.</li>
+    <li>StreamHandler: add reset method to shutdown a connection to a site.</li>
+  </ul></li>
+
+  <li>Others;
+  <ul>
+    <li>Simplify installer and remove uninstaller.  Saving inventory file in src dir could be the problem.</li>
+    <li>Class/Module architecture relocation.</li>
+    <li>Changing coding convention to fit with Ruby's.  Added lib/soap/compat.rb which defines compatibility definitions for 1.4.8.  lib/soap/compat.rb warns when the library is loaded.</li>
+    <li>Many warnings raised under 1.8, caused by illegal references like XSD::XSDInt in typeMap.rb.  Soap4r defined toplevel::XSDInt.  Define XSD* classes in XSD module and introduce it to toplevel.</li>
+  </ul></li>
+</ul>
+
+<p>
+Thanks to all of soap4r users for their support.
+</p>
+
+<h2 id="install" name="install">2. Install</h2>
+
+<p>
+At first, see <a href="#dependencies">Dependencies</a> section.
+You may need to install some extra packages.
+Next, get the archived file of SOAP4R and extract it, then simply try;
+</p>
+<pre class="path">
+$ ruby install.rb
+</pre>
+
+<p>
+Necessary files will be installed to suitable directory.
+</p>
+
+<p>
+Files in lib/soap directory are SOAP4R library program itself.
+</p>
+
+<dl>
+<dt class="path">lib/</dt>
+<dd>Libraries.</dd>
+
+<dt class="path">sample/</dt>
+<dd>SOAP4R samples.
+See <a href="#samples">Samples</a> section.</dd>
+
+<dt class="path">test/</dt>
+<dd>Some tests.
+Unit test MUST cover all lines of code, but far from enough so far...
+<br/>
+test/interopR2/ directory includes Clients/Server for
+<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
+Followings are advanced examples to use complex type transmit,
+sending base64 encoded string, multi-dimensional array, and so on.
+<ul>
+<li>test/interopR2/server.rb is a RPC Server side implementation.</li>
+<li>test/interopR2/client.rb is a RPC Client side implementation.</li>
+<li>test/interopR2/base.rb includes common definitions for client/server.</li>
+</ul>
+</dd>
+</dl>
+
+<h2 id="uninstall" name="uninstall">3. Uninstall</h2>
+
+<p>
+Simply delete installed files.
+</p>
+
+<h2 id="whats" name="whats">4. What is SOAP4R?</h2>
+
+<p>
+'SOAP4R' is an implementation of
+<a href="http://www.w3.org/TR/SOAP/">Simple Object Access Protocol (SOAP) 1.1 (W3C Note)</a>.
+</p>
+
+<p>
+Comments, information such as interoperability between SOAP4R and another implementation are welcomed.
+Feel free sending mail to
+<a href="mailto:nakahiro@sarion.co.jp" class="path">nakahiro@sarion.co.jp</a>.
+</p>
+
+<h2 id="dependencies" name="dependencies">5. Dependencies</h2>
+
+<p>
+SOAP4R is written in <a href="http://www.ruby-lang.org">Ruby</a> and
+aims to use with Ruby application.
+You have to install Ruby itself.
+Ruby/1.6 series or later is required.
+It does not works on 1.4 series because it does not have class variable.
+</p>
+
+<p>
+SOAP4R depends on following Ruby modules in
+<a href="http://raa.ruby-lang.org">RAA</a>.
+You also have to install these modules to use SOAP4R.
+</p>
+
+<dl>
+<dt class="path">XML processor</dt>
+<dd>SOAP4R requires a XML processor package installed.
+For now, one of following XML processor must be installed
+(SOAP4R automatically detects it in runtime).
+FYI: xmlscan and REXML are scheduled to be included in ruby/1.8's standard
+distribution.  Version following each project is the version tested with soap4r.
+<br/>
+Note: ruby/1.8 includes REXML so you don't have to install extra XML parser library.
+<ul>
+<li><a href="http://raa.ruby-lang.org/list.rhtml?name=xmlscan">[RAA:xmlscan]</a> (0.2.3, 0.3.x)</li>
+<li><a href="http://raa.ruby-lang.org/list.rhtml?name=rexml">[RAA:REXML]</a> (2.7.1)</li>
+<li><a href="http://raa.ruby-lang.org/list.rhtml?name=rexml-stable">[RAA:REXML-stable]</a> (2.4.8)</li>
+<li><a href="http://raa.ruby-lang.org/list.rhtml?name=xmlparser">[RAA:XMLParser]</a> (0.6.5)</li>
+</ul></dd>
+
+<dt class="path"><a href="http://raa.ruby-lang.org/list.rhtml?name=devel-logger">[RAA:devel-logger]</a> (1.1.0)</dt>
+<dd>Logging utility by NaHi.</dd>
+
+<dt class="path"><a href="http://raa.ruby-lang.org/list.rhtml?name=webrick">[RAA:webrick]</a> (1.3.1) (required for soap server)</dt>
+<dd>TCP server toolkit by Gotoyuzo.
+ruby/1.8 includes WEBrick in standard distribution library.</dd>
+
+<dt class="path"><a href="http://raa.ruby-lang.org/list.rhtml?name=http-access2">[RAA:http-access2]</a> (2.0.0) (required for SOAP CGI server, recommended for SOAP client)</dt>
+<dd>Yet another HTTP client implementation by NaHi.</dd>
+
+<dt class="path"><a href="http://raa.ruby-lang.org/list.rhtml?name=date2">[RAA:date2]</a> (3.2) (required under ruby/1.6)</dt>
+<dd>Date and DateTime implementation by Todayoshi Funaba.
+Note: From ruby/1.8, this module is included in standard distribution.
+You don't have to install it if you are using ruby/1.8 or later.</dd>
+
+<dt class="path"><a href="http://raa.ruby-lang.org/list.rhtml?name=uconv">[RAA:uconv]</a> (0.4.10) (required for UTF-8 handling under ruby/1.6)</dt>
+<dd>by Yoshida Masato.
+It is requred when you use ruby/1.6 and want automatic CES conversion between
+SJIS &lt;-&gt; UTF8 and EUC &lt;-&gt; UTF8.
+Under ruby/1.8, soap4r uses iconv in standard distribution library.
+Note: SJIS &lt;-&gt; EUC uses NKF module which is in standard distribution.
+I will support Iconv for more conversion set.
+</dd>
+
+</dl>
+
+<h2 id="samples" name="samples">6. Samples</h2>
+
+<p>
+Samples are in sample/ directory of distribution.
+Some samples try to connect to public servers.
+Set environment variable HTTP_PROXY if you are in a firewall and you have
+http proxy to the internet like;
+</p>
+<pre class="path">
+$ export HTTP_PROXY=http://myproxyserver:8080
+  or
+$ setenv HTTP_PROXY http://myproxyserver:8080
+</pre>
+
+<dl>
+<dt class="path">babelfish.rb</dt>
+<dd>A client for
+<a href="http://www.xmethods.com/ve2/ViewListing.po?serviceid=14">BabelFish</a>
+which namespace URI is 'urn:xmethodsBabelFish'.
+<pre class="path">
+$ ./babelfish.rb "Text to translate" [ translation pattern like 'en_fr' ]
+</pre>
+</dd>
+
+<dt class="path">whois.rb</dt>
+<dd>A client for
+<a href="http://www.xmethods.com/ve2/ViewListing.po?serviceid=34">SQLData's WHOIS</a>
+which namespace URI is 'http://www.SoapClient.com/xml/SQLDataSoap.xsd'.
+<pre class="path">
+$ ./whois.rb ruby-lang.org
+</pre>
+CAUTION: This WhoIs server does not handle non-ascii characters correctly.
+Querying domain which entry contains Japanese or so will hang.  Gee.
+</dd>
+
+<dt class="path">digraph.rb</dt>
+<dd>A sample of SOAP marshalling/unmarshalling.
+It creates a digraph that contains multi-ref-ed nodes at first
+and marshals this object to get serialized XML instance.
+Then reads and unmarshals this XML instance to recover a object
+which has the same links among nodes in the digraph.
+</dd>
+
+<dt class="path">apacheClient.rb</dt>
+<dd>SOAP-RPC client sample which connects with demonstration server;
+stockquote and addressbook in Apache-SOAP.
+You have to install Apache-SOAP and deploy demostration programs.<br />
+To execute;
+<pre class="path">
+$ ./apacheClient.rb http://localhsot:2020/xml-soap/rpcrouter/rpcrouter.jsp
+</pre>
+</dd>
+
+<dt class="path">GoogleSearch/</dt>
+<dd>A sample client to search with <a href="http://www.google.com/apis/">Google Web API</a> using WSDL.
+You need to get a developer's key to use it.
+See wsdlDriver.rb.
+</dd>
+
+<dt class="path">Amazon/</dt>
+<dd>A sample client to connect with <a href="http://associates.amazon.com/exec/panama/associates/ntg/browse/-/1067662/086-5207681-4585409">AmazonWebServices</a> using WSDL.
+See wsdlDriver.rb.
+</dd>
+
+<dt class="path">Calc/</dt>
+<dd>Calc service contains 2 servers and 2 clients.
+calc.rb is hosted by server.rb, calc2.rb is hosted by server2.rb.
+client.rb is for server.rb, client2.rb is for server2.rb.
+<dl>
+<dt>calc.rb</dt>
+<dd>Calc server definition using module and module methods.
+This module responds 'add', 'sub', 'multi' and 'div'.</dd>
+<dt>server.rb</dt>
+<dd>Standalone server.
+It requires calc.rb and serve module methods of this module.
+To run this server;
+<pre class="path">
+$ ./server.rb
+</pre>
+</dd>
+<dt>server.cgi</dt>
+<dd>CGI version.
+To run this server, copy server.cgi and calc.rb to suitable directory
+of your WWW server.
+</dd>
+<dt>client.rb</dt>
+<dd>It connects to server.rb or server.cgi,
+and hit methods served by calc.rb.
+To run the client;
+<pre class="path">
+$ ./client.rb
+</pre>
+Is it stacked?  Did you run the server.rb?<br/>
+Turn logger and wireDumpDev in its source on to see logs and wire dumps of
+SOAP transport.</dd>
+
+<dt>calc2.rb</dt>
+<dd>Calc server definition using class and instance methods.
+An instance of this class holds its value.  Methods 'set' and 'get' is to
+set/get the value.
+It also responds to '+', '-', '*', and '/'.
+</dd>
+<dt>server2.rb</dt>
+<dd>It requires calc2.rb and creates an instance of CalcService2
+that responds all SOAP requests.
+Since '+', '-' and so on of calc2.rb are not valid name as an element
+in XML instance,
+this sample register the method '+' as 'add', '-' as 'sub', and so on.
+</dd>
+<dt>server2.cgi</dt>
+<dd>CGI version.
+To run this server, copy server2.cgi and calc2.rb to suitable directory
+of your WWW server.
+</dd>
+<dt>client2.rb</dt>
+<dd>It connects to server2.rb or server2.cgi.
+Set a value at first and call methods like 'puts objAtServer + 2'.</dd>
+</dl>
+</dd>
+
+<dt class="path">Exchange/</dt>
+<dd>A sample to retrieve the currency rate from public SOAP service.</dd>
+<dl>
+<dt>iExchange.rb</dt>
+<dd>It includes common definitions for client and server of
+Exchange service.
+Including only a definition of namespace URI of this service.</dd>
+<dt>exchange.rb</dt>
+<dd>Definition of servant class ExchangeService which returns the currency rate
+after connecting to another site by SOAP to get the real rate.
+So that this class is the SOAP server for local client and 
+is also a SOAP client for public server.
+An instance of this class is hosted by server.rb.
+The instance responds to only 'getRate' which receives two country code
+such as 'USA' and 'Japan'.</dd>
+<dt>server.rb</dt>
+<dd>It requires exchange.rb and creates an instance of ExchangeService
+that responds all SOAP requests.
+To run this server;
+<pre class="path">
+$ ./server.rb
+</pre>
+</dd>
+<dt>server.cgi</dt>
+<dd>CGI version.
+To run this server, copy server.cgi and exchange.rb to suitable directory
+of your WWW server.
+</dd>
+<dt>client.rb</dt>
+<dd>It connects to server.rb.
+Turn logger and wireDumpDev in its source on to see logs and wire dumps of
+SOAP transport.
+To run the client;
+<pre class="path">
+$ ./client.rb
+</pre>
+</dd>
+</dl>
+</dd>
+
+<dt class="path">SampleStruct/</dt>
+<dd>A sample to transmit complex structured object which has recursive
+object reference.
+<dl>
+<dt>iSampleStruct.rb</dt>
+<dd>It includes common definitions for client and server of
+SampleStruct service.
+Definition of SampleStruct class and namespace URI of this service.</dd>
+<dt>sampleStruct.rb</dt>
+<dd>Definition of servant class SampleStructService.
+An instance of this class is hosted by server.rb.
+The instance responds to only 'hi' which receives a SampleStruct and wraps
+it in the new instance of SampleStruct to return .</dd>
+<dt>server.rb</dt>
+<dd>It requires sampleStruct.rb and creates an instance of SampleStructService
+that responds all SOAP requests.
+To run this server;
+<pre class="path">
+$ ./server.rb
+</pre>
+</dd>
+<dt>server.cgi</dt>
+<dd>CGI version.
+To run this server, copy server.cgi and sampleStruct.rb to suitable directory
+of your WWW server.
+</dd>
+<dt>client.rb</dt>
+<dd>It connects to server.rb.
+Turn logger and wireDumpDev in its source on to see logs and wire dumps of
+SOAP transport.
+To run the client;
+<pre class="path">
+$ ./client.rb
+</pre>
+</dd>
+</dl>
+</dd>
+
+<dt class="path">RAA/</dt>
+<dd>SOAP-RPC client samples.
+These programs connect to RAA SOAP Interface on www.ruby-lang.org.
+<ul>
+<li>soap4r.rb: Ruby program using SOAP4R</li>
+<li>xmlrpc4r.rb: Ruby program using xmlrpc4r</li>
+<li>pocketSOAP.js: JScript program using pocketSOAP</li>
+<li>SOAP::Lite.pl: Perl program using SOAP::Lite for Perl</li>
+</ul>
+Since the server is (still) under testing phase so stable operation is not expected.</dd>
+
+<dt class="path">webrick/</dt>
+<dd>SOAP-RPC server samples which runs with WEBrick.
+<ul>
+<li>httpd.rb: HTTP server which soaplet.rb mounts to.
+It is powered by WEBrick so you must install
+<a href="http://raa.ruby-lang.org/list.rhtml?name=webrick">[RAA:WEBrick]</a>
+to run it.</li>
+<li>soaplet.rb: A bricklet to add a SOAP function to WEBrick.
+It hosts exchange.rb, sampleStruct.rb below, and it is mounted to httpd.rb
+to serve ExchangeService and SampleStructService.</li>
+<li>ExchangeService
+<dl>
+<dt>exchange.rb</dt>
+<dd>A server class definition which returns the currency rate
+after connecting to another site by SOAP to get the real rate.
+An instance of this class is instanciated in httpd.rb and this instance
+respond to each HTTP request.</dd>
+<dt>exchangeClient.rb</dt>
+<dd>A client to connect soaplet.rb via SOAP/HTTP to call exchange.rb.</dd>
+<dt>iExchange.rb</dt>
+<dd>Common class(type) definitions for server and client.</dd>
+</dl>
+</li>
+
+<li>SampleStructService
+<dl>
+<dt>sampleStruct.rb</dt>
+<dd>A server class definition which wraps a given struct
+and returns it.
+An instance of this class is instanciated in httpd.rb and this instance
+respond to each HTTP request.</dd>
+<dt>sampleStructClient.rb</dt>
+<dd>A client to connect soaplet.rb via SOAP/HTTP to call sampleStruct.rb</dd>
+<dt>iSampleStruct.rb</dt>
+<dd>Common class(type) definitions for server and client.</dd>
+</dl></li>
+</ul>
+Run the server;
+<pre class="path">
+$ ruby httpd.rb
+</pre>
+Then, run clients;
+<pre class="path">
+$ ruby sampleStruct.rb
+$ ruby exchangeClient.rb
+</pre>
+Set 'logger' and 'wireDumpDev' in clients to see log and wiredumps of SOAP.
+</dd>
+
+<dt class="path">ICD</dt>
+<dd>A client for
+<a href="http://www.iwebmethod.net/">Insider's Computer Dictionary Web Service</a>.
+This service is implemented with ASP.NET so that it's also a sample of
+a client which connects to ASP.NET.
+CAUTION: this sample contains non-ascii chars in its source and dumped results.
+<dl>
+<dt>IICD.rb</dt>
+<dd>Class(type) definitions for this server.</dd>
+<dt>icd.rb</dt>
+<dd>Client implementation.  To run the client;
+<pre class="path">
+$ ./icd.rb
+</pre>
+</dd>
+</dl>
+</dd>
+
+<dt class="path">WSDemo</dt>
+<dd>A sample of messaging client.  Server side sample does not exist now...</dd>
+
+<dt class="path">RWiki</dt>
+<dd>A sample CGI server which receives a request via SOAP and dispatches it
+to RWiki server via dRuby.  Naive SOAP/dRuby bridge implementation.</dd>
+
+</dl>
+
+<h2 id="restrictions" name="restrictions">7. Restrictions</h2>
+
+<p>
+The following features of the
+<a href="http://www.w3.org/TR/SOAP/">SOAP 1.1 (W3C Note)</a>
+spec are <strong>NOT</strong> currently supported:
+</p>
+
+<ul>
+<li style="margin-top: 2ex;">SOAP Envelope
+<ul>
+<li>SOAP actor attribute</li>
+<li>SOAP mustUnderstand attribute</li>
+<li>SOAP Fault Codes</li>
+</ul></li>
+<li style="margin-top: 2ex;">SOAP Encoding
+<ul>
+<li>Decoding using XML Schema</li>
+</ul></li>
+<li style="margin-top: 2ex;">Othres
+<ul>
+<li>Transport binding except HTTP server and client</li>
+</ul></li>
+</ul>
+
+<h2 id="resources" name="resources">8. Resources</h2>
+
+<dl>
+<dt class="path"><a href="http://raa.ruby-lang.org/list.rhtml?name=soap4r">[RAA:soap4r]</a></dt>
+<dd>I will post a new release to RAA.
+Check RAA to get a new stable (I hope) version.</dd>
+
+<dt class="path"><a href="http://www.ruby-lang.org/cgi-bin/cvsweb.cgi/lib/soap4r/">CVS</a></dt>
+<dd>There is the SOAP4R CVS repository in cvs.ruby-lang.org.
+(Thanks to knu, the maintainer of cvs.ruby-lang.org.)
+Check here to get most recent (but could be unstable) version.</dd>
+
+<dt class="path"><a href="http://rrr.jin.gr.jp/rwiki?cmd=view&name=soap4r">SOAP4R Wiki</a></dt>
+<dd>There is a wiki for SOAP4R, running under
+<a href="http://www.ruby-lang.org/raa/list.rhtml?name=rwiki">[RAA:RWiki]</a>.
+Feel free to add your comment there.
+Any comments are welcomed. (as always)</dd>
+
+<dt class="path"><a href="http://rrr.jin.gr.jp/soap4r?cmd=view;name=InteropResults">InteropResults</a></dt>
+<dd>Test results of <a href="http://www.whitemesa.com/interop.htm">SOAPBuilders Interoperability Lab &quot;Round 2&quot;</a>.</dd>
+
+</dl>
+
+<h2 id="history" name="history">9. History</h2>
+
+<dl>
+<dt>1.5.0 - January 17, 2003</dt>
+<dd>Thousands of lines are changed in this release
+(*.rb in current SOAP4R distribution has 30kloc or over).
+But the biggest change is coding convention, camelCase to non_camel_case.
+Though I tried to keep compatibility between 1.5.0 and 1.4.8, but there's no
+way to keep it at a few point.  If you'll find your code which was developed
+for 1.4.8 does not run under 1.5.0, feel free to ask
+<a href="mailto:nakahiro@sarion.co.jp">me</a> to solve the problem.
+<ul>
+  <li>Dependency libraries;
+  <ul>
+    <li>Add net/http support.  Users can try sample SOAP clients without installing http-access2.  For actual usage, consider installing http-access2 for speed and thread-safe SOAP client.  CAUTION: Building SOAP CGI server needs http-access2 to be installed.</li>
+    <li>Soap4r standalone server requires webrick module to be installed instead of GServer.rb and httpserver.rb.</li>
+    <li>Supports iconv.  To use utf-8, you need to install iconv(included in ruby/1.8) or uconv.</li>
+    <li>Suspend NQXML XML parser support.</li>
+    <li>Remove REXML processor version check.  No longer needed.</li>
+    <li>Rewrite tests with test/unit.</li>
+  </ul></li>
+
+  <li>Features;
+  <ul>
+    <li>Efforts to support messaging with document/literal and ASP.NET interoperability.</li>
+    <li>Add document/literal messaging interface to wsdlDriver.rb.  See a very brief example in sample/soapbox/wsdlDriver.rb though I still didn't try to login to Jabber server..  Jabber folks?</li>
+    <li>XML pretty printing.</li>
+    <li>Better Ruby object mapping.  Rewrote RubytypeFactory to support more Ruby objects.  Tests in AMarshal(http://cvs.m17n.org/~akr/amarshal/) much helped it.  Thanks very much to Tanaka Akira-san.</li>
+    <li>SOAPMarshal accepts IO as an output device like Marshal#dump.</li>
+    <li>SOAPElement: constructor signature change.  Added extraattrs attribute.</li>
+    <li>XSDDateTimeImpl: to_time did not set usec.</li>
+    <li>StreamHandler: add reset method to shutdown a connection to a site.</li>
+  </ul></li>
+
+  <li>Others;
+  <ul>
+    <li>Simplify installer and remove uninstaller.  Saving inventory file in src dir could be the problem.</li>
+    <li>Class/Module architecture relocation.</li>
+    <li>Changing coding convention to fit with Ruby's.  Added lib/soap/compat.rb which defines compatibility definitions for 1.4.8.  lib/soap/compat.rb warns when the library is loaded.</li>
+    <li>Many warnings raised under 1.8, caused by illegal references like XSD::XSDInt in typeMap.rb.  Soap4r defined toplevel::XSDInt.  Define XSD* classes in XSD module and introduce it to toplevel.</li>
+  </ul></li>
+</ul>
+</dd>
+
+<dt>1.4.8 - January 17, 2003</dt>
+<dd>
-This version has these enhancements and bug fixes;
-</p>
-<ul>
-  <li>Avoid warnings;
@@ -91 +633 @@
-  <li>wsdl2ruby: Add --force option to override existing file.</li>
-  <li>Fixed many bugs.</li>
-</ul>
-
-<h2 id="install" name="install">2. Install</h2>
-
-<p>
-At first, see <a href="#dependencies">Dependencies</a> section.
-You may need to install some extra packages.
-Next, get the archived file of SOAP4R and extract it, then simply try;
-</p>
-<pre class="path">
-$ ruby install.rb
-</pre>
-
-<p>
-Necessary files will be installed to suitable directory.
-</p>
-
-<p>
-Files in lib/soap directory are SOAP4R library program itself.
-Followings are redistributed files in redist/.
-</p>
-
-<dl>
-<dt class="path">GServer</dt>
-<dd>by John W. Small: <a href="http://fairfax2.laser.net/~jsmall/rubycorner.html">http://fairfax2.laser.net/~jsmall/rubycorner.html</a></dd>
-
-<dt class="path">httpserver.rb</dt>
-<dd>by Michael Neumann: httpserver.rb in <a href="http://www.ruby-lang.org/raa/list.rhtml?name=xml-rpc">[RAA:XML-RPC]</a></dd>
-</dl>
-
-<p>
-Files in archive:
-</p>
-
-<dl>
-<dt class="path">lib/soap/</dt>
-<dd>SOAP4R library.</dd>
-
-<dt class="path">lib/wsdl/</dt>
-<dd>WSDL4R library.</dd>
-
-<dt class="path">sample/</dt>
-<dd>SOAP4R samples.
-See <a href="#samples">Samples</a> section.</dd>
-
-<dt class="path">test/</dt>
-<dd>Clients/Server for
-<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
-Followings are advanced examples to use complex type transmit,
-sending base64 encoded string, multi-dimensional array, and so on.
-<ul>
-<li>test/interopR2/server.cgi is a RPC Server side implementation.</li>
-<li>test/interopR2/client*.rb is a RPC Client side implementation.</li>
-<li>test/interopR2/base.rb includes common definitions for client/server.</li>
-</ul>
-</dd>
-
-<dt class="path">redist/</dt>
-<dd>Redistributed modules which SOAP4R uses.
-I would appriciate to authors of these programs.
-</dd>
-
-</dl>
-
-<h2 id="uninstall" name="uninstall">3. Uninstall</h2>
-
-<p>
-To uninstall;
-</p>
-
-<pre class="path">
-$ ruby uninstall.rb
-</pre>
-
-<p>
-Of cource, modules listed at <a href="#dependencies">Dependencies</a>
-which you may install are not uninstalled.
-</p>
-
-<h2 id="whats" name="whats">4. What is SOAP4R?</h2>
-
-<p>
-'SOAP4R' is an implementation of
-<a href="http://www.w3.org/TR/SOAP/">Simple Object Access Protocol (SOAP) 1.1 (W3C Note)</a>.
-</p>
-
-<p>
-Comments, information such as interoperability between SOAP4R and another implementation are welcomed.
-Feel free sending mail to
-<a href="mailto:nakahiro@sarion.co.jp" class="path">nakahiro@sarion.co.jp</a>.
-</p>
-
-<h2 id="dependencies" name="dependencies">5. Dependencies</h2>
-
-<p>
-SOAP4R is written in <a href="http://www.ruby-lang.org">Ruby</a> and
-aims to use with Ruby application.
-You have to install Ruby itself.
-Ruby/1.6 series are required.
-It does not works on 1.4 series because it does not have class variable.
-</p>
-
-<p>
-SOAP4R depends on following Ruby modules in
-<a href="http://www.ruby-lang.org/raa/">RAA</a>.
-You also have to install these modules to use SOAP4R.
-</p>
-
-<dl>
-<dt class="path">XML processor</dt>
-<dd>SOAP4R requires a XML processor package installed.
-For now, one of following XML processor must be installed
-(SOAP4R automatically detects it in runtime).
-FYI: xmlscan and REXML are scheduled to be included in ruby/1.8's standard
-distribution.  Version following each project is the version tested with soap4r.
-<ul>
-<li><a href="http://www.ruby-lang.org/raa/list.rhtml?name=xmlscan">[RAA:xmlscan]</a> (0.1.3 or 0.2.0-20030116)</li>
-<li><a href="http://www.ruby-lang.org/raa/list.rhtml?name=rexml">[RAA:REXML]</a> (2.5.3)</li>
-<li><a href="http://www.ruby-lang.org/raa/list.rhtml?name=rexml-stable">[RAA:REXML-stable]</a> (2.4.5)</li>
-<li><a href="http://www.ruby-lang.org/raa/list.rhtml?name=xmlparser">[RAA:XMLParser]</a> (0.6.5)</li>
-<li><a href="http://www.ruby-lang.org/raa/list.rhtml?name=nqxml">[RAA:NQXML]</a> (1.1.3p1)</li>
-</ul></dd>
-
-<dt class="path"><a href="http://www.ruby-lang.org/raa/list.rhtml?name=date2">[RAA:date2]</a> (3.2)</dt>
-<dd>Date and DateTime implementation by Todayoshi Funaba.
-Note: From ruby/1.8, this module is included in standard distribution.
-You don't have to install it if you are using ruby/1.8 or later.</dd>
-
-<dt class="path"><a href="http://www.ruby-lang.org/raa/list.rhtml?name=devel-logger">[RAA:devel-logger]</a> (1.0.1)</dt>
-<dd>Logging utility by NaHi.</dd>
-
-<dt class="path"><a href="http://www.ruby-lang.org/raa/list.rhtml?name=http-access2">[RAA:http-access2]</a> (version j)</dt>
-<dd>Yet another HTTP client implementation by NaHi.</dd>
-
-<dt class="path"><a href="http://www.ruby-lang.org/raa/list.rhtml?name=Uconv">[RAA:Uconv]</a> (optional) (0.4.10)</dt>
-<dd>by Yoshida Masato.
-It is requred when you want automatic CES conversion between
-SJIS &lt;-&gt; UTF8 and EUC &lt;-&gt; UTF8.
-Note: SJIS &lt;-&gt; EUC uses NKF module which is in standard distribution.
-I will support Iconv for more conversion set.
-</dd>
-
-</dl>
-
-<h2 id="samples" name="samples">6. Samples</h2>
-
-<p>
-Samples are in sample/ directory of distribution.
-Some samples try to connect to public servers.
-Set environment variable HTTP_PROXY if you are in a firewall and you have
-http proxy to the internet like;
-</p>
-<pre class="path">
-$ export HTTP_PROXY=http://myproxyserver:8080
-  or
-$ setenv HTTP_PROXY http://myproxyserver:8080
-</pre>
-
-<dl>
-<dt class="path">babelfish.rb</dt>
-<dd>A client for
-<a href="http://www.xmethods.com/ve2/ViewListing.po?serviceid=14">BabelFish</a>
-which namespace URI is 'urn:xmethodsBabelFish'.
-<pre class="path">
-$ ./babelfish.rb "Text to translate" [ translation pattern like 'en_fr' ]
-</pre>
-</dd>
-
-<dt class="path">whois.rb</dt>
-<dd>A client for
-<a href="http://www.xmethods.com/ve2/ViewListing.po?serviceid=34">SQLData's WHOIS</a>
-which namespace URI is 'http://www.SoapClient.com/xml/SQLDataSoap.xsd'.
-<pre class="path">
-$ ./whois.rb ruby-lang.org
-</pre>
-CAUTION: This WhoIs server does not handle non-ascii characters correctly.
-Querying domain which entry contains Japanese or so will hang.  Gee.
-</dd>
-
-<dt class="path">digraph.rb</dt>
-<dd>A sample of SOAP marshalling/unmarshalling.
-It creates a digraph that contains multi-ref-ed nodes at first
-and marshals this object to get serialized XML instance.
-Then reads and unmarshals this XML instance to recover a object
-which has the same links among nodes in the digraph.
-</dd>
-
-<dt class="path">apacheClient.rb</dt>
-<dd>SOAP-RPC client sample which connects with demonstration server;
-stockquote and addressbook in Apache-SOAP.
-You have to install Apache-SOAP and deploy demostration programs.<br />
-To execute;
-<pre class="path">
-$ ./apacheClient.rb http://localhsot:2020/xml-soap/rpcrouter/rpcrouter.jsp
-</pre>
-</dd>
-
-<dt class="path">GoogleSearch/</dt>
-<dd>A sample client to search with <a href="http://www.google.com/apis/">Google Web API</a> using WSDL.
-You need to get a developer's key to use it.
-See wsdlDriver.rb.
-</dd>
-
-<dt class="path">Amazon/</dt>
-<dd>A sample client to connect with <a href="http://associates.amazon.com/exec/panama/associates/ntg/browse/-/1067662/086-5207681-4585409">AmazonWebServices</a> using WSDL.
-You need to get a developer's token to use it.
-See wsdlDriver.rb.
-</dd>
-
-<dt class="path">Calc/</dt>
-<dd>Calc service contains 2 servers and 2 clients.
-calc.rb is hosted by server.rb, calc2.rb is hosted by server2.rb.
-client.rb is for server.rb, client2.rb is for server2.rb.
-<dl>
-<dt>calc.rb</dt>
-<dd>Calc server definition using module and module methods.
-This module responds 'add', 'sub', 'multi' and 'div'.</dd>
-<dt>server.rb</dt>
-<dd>Standalone server.
-It requires calc.rb and serve module methods of this module.
-To run this server;
-<pre class="path">
-$ ./server.rb
-</pre>
-</dd>
-<dt>server.cgi</dt>
-<dd>CGI version.
-To run this server, copy server.cgi and calc.rb to suitable directory
-of your WWW server.
-</dd>
-<dt>client.rb</dt>
-<dd>It connects to server.rb or server.cgi,
-and hit methods served by calc.rb.
-To run the client;
-<pre class="path">
-$ ./client.rb
-</pre>
-Is it stacked?  Did you run the server.rb?<br/>
-Turn logger and wireDumpDev in its source on to see logs and wire dumps of
-SOAP transport.</dd>
-
-<dt>calc2.rb</dt>
-<dd>Calc server definition using class and instance methods.
-An instance of this class holds its value.  Methods 'set' and 'get' is to
-set/get the value.
-It also responds to '+', '-', '*', and '/'.
-</dd>
-<dt>server2.rb</dt>
-<dd>It requires calc2.rb and creates an instance of CalcService2
-that responds all SOAP requests.
-Since '+', '-' and so on of calc2.rb are not valid name as an element
-in XML instance,
-this sample register the method '+' as 'add', '-' as 'sub', and so on.
-</dd>
-<dt>server2.cgi</dt>
-<dd>CGI version.
-To run this server, copy server2.cgi and calc2.rb to suitable directory
-of your WWW server.
-</dd>
-<dt>client2.rb</dt>
-<dd>It connects to server2.rb or server2.cgi.
-Set a value at first and call methods like 'puts objAtServer + 2'.</dd>
-</dl>
-</dd>
-
-<dt class="path">Exchange/</dt>
-<dd>A sample to retrieve the currency rate from public SOAP service.</dd>
-<dl>
-<dt>iExchange.rb</dt>
-<dd>It includes common definitions for client and server of
-Exchange service.
-Including only a definition of namespace URI of this service.</dd>
-<dt>exchange.rb</dt>
-<dd>Definition of servant class ExchangeService which returns the currency rate
-after connecting to another site by SOAP to get the real rate.
-So that this class is the SOAP server for local client and 
-is also a SOAP client for public server.
-An instance of this class is hosted by server.rb.
-The instance responds to only 'getRate' which receives two country code
-such as 'USA' and 'Japan'.</dd>
-<dt>server.rb</dt>
-<dd>It requires exchange.rb and creates an instance of ExchangeService
-that responds all SOAP requests.
-To run this server;
-<pre class="path">
-$ ./server.rb
-</pre>
-</dd>
-<dt>server.cgi</dt>
-<dd>CGI version.
-To run this server, copy server.cgi and exchange.rb to suitable directory
-of your WWW server.
-</dd>
-<dt>client.rb</dt>
-<dd>It connects to server.rb.
-Turn logger and wireDumpDev in its source on to see logs and wire dumps of
-SOAP transport.
-To run the client;
-<pre class="path">
-$ ./client.rb
-</pre>
-</dd>
-</dl>
-</dd>
-
-<dt class="path">SampleStruct/</dt>
-<dd>A sample to transmit complex structured object which has recursive
-object reference.
-<dl>
-<dt>iSampleStruct.rb</dt>
-<dd>It includes common definitions for client and server of
-SampleStruct service.
-Definition of SampleStruct class and namespace URI of this service.</dd>
-<dt>sampleStruct.rb</dt>
-<dd>Definition of servant class SampleStructService.
-An instance of this class is hosted by server.rb.
-The instance responds to only 'hi' which receives a SampleStruct and wraps
-it in the new instance of SampleStruct to return .</dd>
-<dt>server.rb</dt>
-<dd>It requires sampleStruct.rb and creates an instance of SampleStructService
-that responds all SOAP requests.
-To run this server;
-<pre class="path">
-$ ./server.rb
-</pre>
-</dd>
-<dt>server.cgi</dt>
-<dd>CGI version.
-To run this server, copy server.cgi and sampleStruct.rb to suitable directory
-of your WWW server.
-</dd>
-<dt>client.rb</dt>
-<dd>It connects to server.rb.
-Turn logger and wireDumpDev in its source on to see logs and wire dumps of
-SOAP transport.
-To run the client;
-<pre class="path">
-$ ./client.rb
-</pre>
-</dd>
-</dl>
-</dd>
-
-<dt class="path">RAA/</dt>
-<dd>SOAP-RPC client samples.
-These programs connect to RAA SOAP Interface on www.ruby-lang.org.
-<ul>
-<li>soap4r.rb: Ruby program using SOAP4R</li>
-<li>xmlrpc4r.rb: Ruby program using xmlrpc4r</li>
-<li>pocketSOAP.js: JScript program using pocketSOAP</li>
-<li>SOAP::Lite.pl: Perl program using SOAP::Lite for Perl</li>
-</ul>
-Since the server is (still) under testing phase so stable operation is not expected.</dd>
-
-<dt class="path">webrick/</dt>
-<dd>SOAP-RPC server samples which runs with WEBrick.
-<ul>
-<li>httpd.rb: HTTP server which soaplet.rb mounts to.
-It is powered by WEBrick so you must install
-<a href="http://www.ruby-lang.org/raa/list.rhtml?name=webrick">[RAA:WEBrick]</a>
-to run it.</li>
-<li>soaplet.rb: A bricklet to add a SOAP function to WEBrick.
-It hosts exchange.rb, sampleStruct.rb below, and it is mounted to httpd.rb
-to serve ExchangeService and SampleStructService.</li>
-<li>ExchangeService
-<dl>
-<dt>exchange.rb</dt>
-<dd>A server class definition which returns the currency rate
-after connecting to another site by SOAP to get the real rate.
-An instance of this class is instanciated in httpd.rb and this instance
-respond to each HTTP request.</dd>
-<dt>exchangeClient.rb</dt>
-<dd>A client to connect soaplet.rb via SOAP/HTTP to call exchange.rb.</dd>
-<dt>iExchange.rb</dt>
-<dd>Common class(type) definitions for server and client.</dd>
-</dl>
-</li>
-
-<li>SampleStructService
-<dl>
-<dt>sampleStruct.rb</dt>
-<dd>A server class definition which wraps a given struct
-and returns it.
-An instance of this class is instanciated in httpd.rb and this instance
-respond to each HTTP request.</dd>
-<dt>sampleStructClient.rb</dt>
-<dd>A client to connect soaplet.rb via SOAP/HTTP to call sampleStruct.rb</dd>
-<dt>iSampleStruct.rb</dt>
-<dd>Common class(type) definitions for server and client.</dd>
-</dl></li>
-</ul>
-Run the server;
-<pre class="path">
-$ ruby httpd.rb
-</pre>
-Then, run clients;
-<pre class="path">
-$ ruby sampleStruct.rb
-$ ruby exchangeClient.rb
-</pre>
-Set 'logger' and 'wireDumpDev' in clients to see log and wiredumps of SOAP.
-</dd>
-
-<dt class="path">ICD</dt>
-<dd>A client for
-<a href="http://www.iwebmethod.net/">Insider's Computer Dictionary Web Service</a>.
-This service is implemented with ASP.NET so that it's also a sample of
-a client which connects to ASP.NET.
-CAUTION: this sample contains non-ascii chars in its source and dumped results.
-<dl>
-<dt>IICD.rb</dt>
-<dd>Class(type) definitions for this server.</dd>
-<dt>icd.rb</dt>
-<dd>Client implementation.  To run the client;
-<pre class="path">
-$ ./icd.rb
-</pre>
-</dd>
-</dl>
-</dd>
-
-<dt class="path">WSDemo</dt>
-<dd>A sample of messaging client.  Server side sample does not exist now...</dd>
-
-<dt class="path">RWiki</dt>
-<dd>A sample CGI server which receives a request via SOAP and dispatches it
-to RWiki server via dRuby.  Naive SOAP/dRuby bridge implementation.</dd>
-
-</dl>
-
-<h2 id="restrictions" name="restrictions">7. Restrictions</h2>
-
-<p>
-The following features of the
-<a href="http://www.w3.org/TR/SOAP/">SOAP 1.1 (W3C Note)</a>
-spec are <strong>NOT</strong> currently supported:
-</p>
-
-<ul>
-<li style="margin-top: 2ex;">SOAP Envelope
-<ul>
-<li>SOAP actor attribute</li>
-<li>SOAP mustUnderstand attribute</li>
-<li>SOAP Fault Codes</li>
-</ul></li>
-<li style="margin-top: 2ex;">SOAP Encoding
-<ul>
-<li>Decoding using XML Schema</li>
-</ul></li>
-<li style="margin-top: 2ex;">Othres
-<ul>
-<li>Transport binding except HTTP server and client</li>
-</ul></li>
-</ul>
-
-<h2 id="resources" name="resources">8. Resources</h2>
-
-<dl>
-<dt class="path"><a href="http://www.ruby-lang.org/raa/list.rhtml?name=soap4r">[RAA:soap4r]</a></dt>
-<dd>I will post a new release to RAA.
-Check RAA to get a new stable (I hope) version.</dd>
-
-<dt class="path"><a href="http://www.ruby-lang.org/~knu/cgi-bin/cvsweb.cgi/lib/soap4r/">CVS</a></dt>
-<dd>There is the SOAP4R CVS repository in cvs.ruby-lang.org.
-(Thanks to knu, the maintainer of cvs.ruby-lang.org.)
-Check here to get most recent (but could be unstable) version.</dd>
-
-<dt class="path"><a href="http://www.jin.gr.jp/~nahi/Ruby/SOAP4R/wiki.cgi">SOAP4R Wiki</a></dt>
-<dd>There is a wiki for SOAP4R, running under
-<a href="http://www.ruby-lang.org/raa/list.rhtml?name=rwiki">[RAA:RWiki]</a>.
-Feel free to add your comment there.
-Any comments are welcomed. (as always)</dd>
-
-<dt class="path"><a href="http://www.jin.gr.jp/~nahi/Ruby/SOAP4R/wiki.cgi?cmd=view;name=InteropResults">InteropResults</a></dt>
-<dd>Test results of <a href="http://www.whitemesa.com/interop.htm">SOAPBuilders Interoperability Lab &quot;Round 2&quot;</a>.</dd>
-
-</dl>
-
-<h2 id="history" name="history">9. History</h2>
-
-<dl>
-<dt>1.4.8 - January 17, 2002</dt>
-<dd>
-This version has these enhancements and bug fixes;
-<ul>
-  <li>Avoid warnings;
-  <ul>
-    <li>Use Object#class instead of Object#type.</li>
-    <li>Avoid implicit use a String as a regexp source.</li>
-  </ul></li>
-  <li>Add wsdlDriver which reads WSDL file and allow client to call procedures.  Here is an example to search Google.
-  <pre>
-    require 'soap/wsdlDriver'
-    searchWord = ARGV.shift
-    # You must get key from http://www.google.com/apis/ to use Google Web APIs.
-    key = File.open(File.expand_path("~/.google_key")).read.chomp
-    GOOGLE_WSDL = 'http://api.google.com/GoogleSearch.wsdl'
-    # Load WSDL and create driver.
-    google = SOAP::WSDLDriverFactory.new(GOOGLE_WSDL).createDriver
-    # Just invoke!
-    result = google.doGoogleSearch(key, searchWord, 0, 10, false, "", false, "", 'utf-8', 'utf-8')
-    result.resultElements.each do |ele|
-      puts "== #{ele.title}: #{ele.URL}"
-      puts ele.snippet
-      puts
-    end
-  </pre></li>
-  <li>WSDLDriver client examples of AmazonWebServices, RAA and RNN (Japanese Ruby blog site) are also included in sample/ dir.</li>
-  <li>Support xmlscan XML processor.</li>
-  <li>Changed XML processor detection scheme.  Search xmlscan, REXML, XMLParser and NQXML in this order.</li>
-  <li>Rewrite charset handling of XML processor.
-  <ul>
-    <li>If you only use us-ascii and utf-8, all XML processors should work without uconv module.</li>
-    <li>With xmlscan/0.2 or later, you can handle euc-jp or shift_jis encoded XML instance WITHOUT uconv module.</li>
-    <li>With other XML processors includes xmlscan/0.1, you