Changeset 1882

Timestamp:

07/12/07 23:20:59 (1 year ago)

Author:

nahi

Message:

• updated README
  

Files:

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

trunk/RELEASE_en.html

@@ -19 +19 @@
-
-<p class="status">
-n 14
+l 8
-Created: July 17, 2000
-</p>
@@ -34 +34 @@
-
-<p>
-6
+7
-</p>
-
@@ -53 +53 @@
-
-<p>
-
+
+
-</p>
+<ul><li>SOAP/Ruby mapping
+<ul><li>try to call klass.soap_marshallable before mapping an XML element to the klass while unmarshalling. to avoid auto-mapping from element name, define klass.soap_marshallable method let it return false. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/223" title="avoid the AutoMapping (closed)">#223</a>)
+</li><li>[BUG] Array or Struct was not properly marshalled when literal service + generated stub combination. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/360" title="Array or Struct is not properly marshalled through stub definition for  ... (closed)">#360</a>)
+</li><li>[BUG] derived class was marshalled without xsi:type for literal service. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/361" title="derived class  is marshalled without xsi:type for literal service (closed)">#361</a>)
+</li><li>[BUG] passing nil as a basetype through generated mapping registry was broken in 1.5.6. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/369" title="nil passed as attribute to axis service gets sent as an empty string  ... (closed)">#369</a>)
+</li><li>[BUG] an rpc/encoded parameter could be wrongly typed when the parameter is typed as a derived type from a base type of XML Schema datatypes. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/371" title="an rpc/encoded parameter wrongly typed (closed)">#371</a>)
+
+</li><li>[BUG] under the earlier versions, we could use [] instead of CountryTargets[]. from 1.5.6-GA it doesn't work. let LiteralRegistry decide how the class should be mapped to according to the defined class in the parent complexType. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/373" title="generic Array cannot be used instead of a custom array (closed)">#373</a>)
+</li></ul></li></ul><ul><li>RPC
+<ul><li>allow xsi:nil="true" element as an RPC request though I don't think it's SOAP spec compliant. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/374" title="SOAP::Lite incompatibility (closed)">#374</a>)
+</li></ul></li></ul><ul><li>Payload
+<ul><li>added an API for filtering streamhandler to capture/generate HTTP header. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/276" title="streamHandler filter to capture/create HTTP header (closed)">#276</a>)
+</li><li>added 'protocol.http.auth' option to set authentication information for both BasicAuth and DigestAuth. with the latest http-access2, now soap4r client can connect to DigestAuth server. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/345" title="Client Digest Authentication Implemented (closed)">#345</a>)
+
+</li></ul></li></ul><ul><li>WSDL
+<ul><li>[BUG] error when simpleType element usage as "part" definition directly. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/367" title="error when simpleType element usage as &#34;part&#34; definition directly (closed)">#367</a>)
+</li></ul></li></ul><ul><li>misc
+<ul><li>let xsd2ruby.rb generate a mapping registry and a mapper from XML Schema definition. the mapper has obj2xml and xml2obj which uses the generated mapping registry. you can use this instead of XSD::Mapping.obj2xml and XSD::Mapping.xml2obj which does not know anything about mapping. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/362" title="classname parameter for bin/xsd2ruby.rb (closed)">#362</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/363" title="mapping xml&lt;-&gt;obj based on XML Schema (closed)">#363</a>)
+</li><li>importer should not import <a class="ext-link" href="http://schemas.xmlsoap.org/soap/encoding/"><span class="icon">http://schemas.xmlsoap.org/soap/encoding/</span></a>. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/366" title="importer should not import http://schemas.xmlsoap.org/soap/encoding/ (closed)">#366</a>)
+</li><li>[BUG] wsdl2ruby.rb did not generate a classdef entry for empty element definition such as &lt;element name="foo"/&gt;. let wsdl2ruby.rb generate 'class Foo &lt; String'. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/370" title="empty element definition causes 'cannot find mapped class' warning (closed)">#370</a>)
+</li></ul></li></ul>
+
+<p>
+Thanks to all of soap4r-ml members and soap4r users for their support.
+And special thanks to following contributors;
+</p>
+<pre>
+'Aaron Pfeifer' for contributing a patch for safemethodname.
+'Andi Wundsam' for contributing a patch for net/http + no_proxy.
+'anonymous contributor from Wall St.' for contributing a MSSOAP + Excel sample.
+'Emil Marceta' for contributing a patch for one-way service support.
+'Ernie' for contributing a helloworld WSDL sample and WSDL service feature of HTTPServer.
+'Felipe Contreras' for contributing an union + memberType sample and patches for missing 'require'.
+'Greg Lappen' for contributing an eBaySvc sample.
+'Ger Apeldoorn' for contributing a sample of complex type + MIME attachment.
+'Jamie Herre' for contributing a SwA implementation.
+'John Anderson' for contributing a patch for handling gzipped HTTP content.
+'Junichi Uekawa' for contributing a HTTP redirection patch for net/http.
+'Kent Sibilev' for contributing a patch for correct extraattr handling of SOAPHeaderItem.
+'Leoš Bitto' for contributing a patch for XML pretty print.
+'Michael Neumann' for contributing an original implementation of standaloneServer.
+'Oliver M. Bolzer' for contributing a patch for net/http + SSL.
+'Owen Fraser-Green' for contributing a patch for MIME CRLF handling.
+'Patrick Chanezon' for contributing a patch for wsdl2ruby classdef name option.
+'Peter Gardfjäll' for contributing a patch for wsdl:fault handling.
+'Sandi Metz' for contributing a patch for SwA in document/literal service.
+'SHINAGAWA, Norihide' for contributing a patch for emx platform.
+'Tadayoshi Funaba' for contributing a patch for date/time XMLSchema datatypes.
+'UENO Katsuhiro' for xmlscan implementation.
+'Walter Korman' for contributing soap4r.gemspec and a workaround patch for gem's require problem.
+'wrex' for contributing a patch for soap4r to work with SalesForce service.
+</pre>
+
+<h2 id="install" name="install"><span class="content">2. Install</span></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 and directories in lib 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>Tests.  It also contains useful sample scripts for servers and clients.
+<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"><span class="content">3. Uninstall</span></h2>
+
+<p>
+Simply delete installed files.
+</p>
+
+<h2 id="whats" name="whats"><span class="content">4. What is SOAP4R?</span></h2>
+
+<p>
+'SOAP4R' is an implementation of
+<a href="http://www.w3.org/TR/SOAP/">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:nahi@ruby-lang.org" class="path">nahi@ruby-lang.org</a>.
+</p>
+
+<h2 id="dependencies" name="dependencies"><span class="content">5. Dependencies</span></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.
+</p>
+<ul>
+  <li>ruby-1.8.6</li>
+  <li>ruby-1.6.8</li>
+</ul>
+
+<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>
+
+<h3><span class="content">for ruby-1.8.6</span></h3>
+
+<dl>
+<dt class="path"><a href="http://raa.ruby-lang.org/project/http-access2/">[RAA:http-access2]</a> (2.0.5) (required for SSL)</dt>
+<dd>Yet another HTTP client implementation by NaHi.
+It's not required when you don't use SSL, but it's recommended to use.
+The author always runs and checks soap4r with http-access2.</dd>
+
+<dt class="path"><a href="http://raa.ruby-lang.org/project/uconv/">[RAA:uconv]</a> (0.4.10) (not required but needed if your Ruby doesn't have iconv module and you need UTF-8 encoded Japanese chars)</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.
+</dd>
+
+</dl>
+
+<h3><span class="content">for ruby-1.6.8</span></h3>
+
+<dl>
+<dt class="path"><a href="http://raa.ruby-lang.org/project/webrick/">[RAA:webrick]</a> (1.3.1)</dt>
+<dd>TCP server toolkit by Gotoyuzo.</dd>
+
+<dt class="path"><a href="http://raa.ruby-lang.org/project/http-access2/">[RAA:http-access2]</a> (2.0.5)</dt>
+<dd>Yet another HTTP client implementation by NaHi.</dd>
+
+<dt class="path"><a href="http://raa.ruby-lang.org/project/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/project/date2/">[RAA:date2]</a> (3.2)</dt>
+<dd>Date and DateTime implementation by Todayoshi Funaba.</dd>
+
+<dt class="path"><a href="http://raa.ruby-lang.org/project/uconv/">[RAA:uconv]</a> (0.4.10) (required for UTF-8 handling)</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.
+</dd>
+
+</dl>
+
+<h2 id="samples" name="samples"><span class="content">6. Samples</span></h2>
+
+<p>
+Samples are in sample/ directory of distribution.
+Some samples try to connect to public servers.
+Set environment variable SOAP_USE_PROXY and HTTP_PROXY if you are in a firewall and you have
+http proxy to the internet like;
+</p>
+<pre class="path">
+$ export SOAP_USE_PROXY=on
+$ export HTTP_PROXY=http://myproxyserver:8080
+  or
+$ setenv SOAP_USE_PROXY on
+$ setenv HTTP_PROXY http://myproxyserver:8080
+</pre>
+
+<h3><span class="content">basic/ ... basic samples</span></h3>
+
+    <dl>
+      <dt class="path">babelfish.rb</dt>
+      <dd>a SOAP client sample to connect to a babelfish server.</dd>
+      <dt class="path">whois.rb</dt>
+      <dd>a SOAP client sample to connect to a whois server.</dd>
+      <dt class="path">flickr.rb</dt>
+      <dd>a SOAP client sample to connect to the flickr SOAP server and extract data from XML response.</dd>
+      <dt class="path">yahooNewsSearch.rb</dt>
+      <dd>a HTTP client sample to connect to the Yahoo news search REST service and extract data from XML response.</dd>
+
+      <dt class="path">helloworld/</dt>
+      <dd>a SOAP server and client sample of 'Hello World'.
+          To run the server;
+<pre class="path">
+$ ./server.rb
+</pre>
+          And to connect to the server, run the client;
+<pre class="path">
+$ ./client.rb
+</pre>
+      </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.
+        <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">wsdl_helloworld/</dt>
+      <dd>A sample 'Hello World' SOAP client and server which utilize WSDL.
+      See wsdl_helloworld/README for more detail</dd>
+    </dl>
+
+<h3><span class="content">payload/ ... various payload configuration</span></h3>
+
+    <dl>
+      <dt class="path">basicauth/</dt>
+      <dd>BasicAuth server and client sample.</dd>
+
+      <dt class="path">cookies/</dt>
+      <dd>HTTP-Cookies server and client sample.</dd>
+
+      <dt class="path">ssl/</dt>
+      <dd>SSL SOAP server and client samples.
+        <dl>
+          <dt class="path">sslserver.rb</dt>
+          <dd>SSL server sample which hosts "hello world" service.
+            This server uses SSL server certificate in files/ directory
+            (SSL client should check this certificate for SSL server
+            authentication).</dd>
+          <dt class="path">sslserver_noauth.rb</dt>
+          <dd>This server generates SSL server certificate
+            at runtime.  No security.</dd>
+          <dt class="path">sslserver_require_clientauth.rb</dt>
+          <dd>This server users SSL server certificate in files/ directory
+            and requires SSL client authentication (clients must
+            have SSL client certificate and send it to the server).</dd>
+          <dt class="path">sslclient.rb</dt>
+          <dd>SSL client sample which calls "hello world" service via HTTPS.
+            This client checks SSL server certificate sent from SSL server.</dd>
+          <dt class="path">sslclient_require_noserverauth.rb</dt>
+          <dd>This client does not check SSL server certificate.
+            No security.</dd>
+          <dt class="path">sslclient_with_clientauth.rb</dt>
+          <dd>This client sends SSL client certificate in files/ directory
+            and checks SSL server certificate.</dd>
+        </dl>
+      </dd>
+
+      <dt class="path">gzipped/</dt>
+      <dd>gzipped content negotiation server and client sample.</dd>
+    </dl>
+
+<h3><span class="content">soapheader/ ... SOAPHeader configuration</span></h3>
+
+    <dl>
+      <dt class="path">authheader/</dt>
+      <dd>It contains a sample to utilize SOAP Header handler.  Send
+        userid/passwd and receive sessionid via SOAP Header</dd>
+
+      <dt class="path">soapext_basicauth/</dt>
+      <dd>It contains a sample to do BasicAuth in SOAPHeader.  (http://soap-authentication.org/basic/2001/10/)</dd>
+    </dl>
+
+<h3><span class="content">attachment/ ... SOAP with Attachment (SwA)</span></h3>
+
+    <dl>
+      <dt class="path">swa/</dt>
+      <dd>SOAP server and client sample of SwA (SOAP with Attachments).</dd>
+
+      <dt class="path">complexmime/</dt>
+      <dd>SOAP server and client sample of Complex Type + SwA</dd>
+    </dl>
+
+<h3><span class="content">howto/ ... various other configuration</span></h3>
+
+    <dl>
+      <dt class="path">as_xml/</dt>
+      <dd>Sample client to send a request with XML, and receive a response as XML.</dd>
+
+      <dt class="path">base64/</dt>
+      <dd>Sample client to send/receive base64 data.</dd>
+
+      <dt class="path">documentliteral/</dt>
+      <dd>Sample client and server of document/literal service.  See README.txt in this directory to run this sample.</dd>
+
+      <dt class="path">filter/</dt>
+      <dd>Sample client and server of filtering request/response before sending/receiving.</dd>
+
+      <dt class="path">scopesample/</dt>
+      <dd>SOAP server sample which shows a different behavior of SOAP server scope settings; Request scope vs Application scope.
+        sample/soap/scopesample/servant.rb is a servant which holds push-ed
+        object that can be pop-ed afterward.
+        See sample/soap/scopesample/server.rb how to define a servant as
+        a Request scope servant or an Application scope servant.
+        Application scope servant works as we expected because the servant
+        object is living from beginning to the time server terminated.
+        In contrast, request scope servant(s) does not work because a servant
+        object is created for each request.
+      </dd>
+
+      <dt class="path">styleuse/</dt>
+      <dd>Sample client and server of SOAP style and use combination, especially rpc/literal and document/encoded.</dd>
+
+      <dt class="path">wsdl_fault/</dt>
+      <dd>Sample client and server of handling SOAP fault specified in a WSDL.  See wsdl_fault/README.txt for more detail.</dd>
+
+      <dt class="path">wsdl_hash/</dt>
+      <dd>Sample client and server of sending/receiving Hash struct defined in a WSDL.</dd>
+    </dl>
+
+<h3><span class="content">marshal/ ... object &lt;-&gt; XML marshalling</span></h3>
+
+    <dl>
+      <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">customfactory.rb</dt>
+      <dd>Sample program for customizing mapping registry.</dd>
+
+      <dt class="path">enum/</dt>
+      <dd>Sample program to demonstrate how xsd2ruby.rb works.</dd>
+    </dl>
+
+<h3><span class="content">showcase/ ... showcase sample to demonstrate</span></h3>
+
+    <dl>
+      <dt class="path">raa2.4/</dt>
+      <dd>sample/soap/raa2.4/sample.rb is a sample client to retrieve project
+        information on RAA.  It uses raaDriver.rb which is generated by
+        wsdl2ruby.rb from WSDL at
+        <a href="http://www.ruby-lang.org/xmlns/soap/interface/RAA/0.0.4/">http://www.ruby-lang.org/xmlns/soap/interface/RAA/0.0.4/</a>.
+        You'll find wsdlDriver.rb in sample/wsdl/raa2.4/wsdlDriver.rb which
+        loads the WSDL at runtime to connect.</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">googleSearch/</dt>
+      <dd>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>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">noaa/</dt>
+      <dd>Sample client of National Weather Service digital weather forecast data service at http://weather.gov/</dd>
+
+      <dt class="path">raa2.4/</dt>
+      <dd>sample/wsdl/raa2.4/wsdlDriver.rb is a sample client to retrieve
+        project information on RAA.  It loads WSDL file 
+        <a href="http://www.ruby-lang.org/xmlns/soap/interface/RAA/0.0.4/">http://www.ruby-lang.org/xmlns/soap/interface/RAA/0.0.4/</a>
+        at <strong>runtime</strong>.
+        You'll find a sample client at sample/soap/raa2.4/sample.rb
+        which connects RAA using pre-generated service definitions
+        (not loads WSDL at runtime).</dd>
+
+      <dt class="path">googleAdwords/</dt>
+      <dd>Sample client of Google AdWords service.  
+        CAUTION: I don't have an account of AdWords so the sample code is NOT
+        tested.  Please tell me (nahi@ruby-lang.org) if you will get good/bad
+        result in communicating with AdWords Server.</dd>
+
+      <dt class="path">amazonEC/</dt>
+      <dd>Sample client of AWSECommerce service.
+        CAUTION: I don't have an account of AWSECommerce so the sample code is
+        NOT tested.  Please tell me (nahi@ruby-lang.org) if you will get
+        good/bad result in communicating with AWSECommerce Server.</dd>
+    </dl>
+
+<p>
+There are more samples in this directory.
+</p>
+
+<h2 id="resources" name="resources"><span class="content">7. Resources</span></h2>
+
+<dl>
+<dt class="path"><a href="http://dev.ctor.org/soap4r">soap4r project page</a></dt>
+<dd>You can get the latest information and the latest development version of soap4r here.</dd>
+
+<dt class="path"><a href="http://raa.ruby-lang.org/project/soap4r">[RAA:soap4r]</a></dt>
+<dd>RAA meta information</dd>
+
+<dt class="path"><a href="http://groups.google.com/group/soap4r">soap4r-ml on Google Groups</a></dt>
+<dd>Feel free to join the list to ask any question and comment about soap4r.
+  You can browse messages archive.  Bear in mind that Google Groups is still
+  in [beta] stage.</dd>
+
+<dt class="path">Subversion repository</dt>
+<dd>Soap4r's svn repository is here: http://dev.ctor.org/svn/soap4r/ .
+  To checkout the latest soap4r module, try
+<pre>
+svn checkout http://dev.ctor.org/svn/soap4r/trunk soap4r
+</pre>
+  CVS repository of soap4r which was located at cvs.ruby-lang.org is pending since 2004-05-27. </dd>
+</dl>
+
+<h2 id="history" name="history"><span class="content">8. History</span></h2>
+
+<dl>
+<dt>1.5.6 - Jun 14, 2007</dt>
+<dd>Here are changes in 1.5.6 from 1.5.5.
-<ul><li>SOAP/Ruby mapping
-<ul><li>specify sending XML document over SOAP by REXML::Element or to_xmlproc -able object. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/21" title="send XML Document over SOAP (closed)">#21</a>)
@@ -219 +779 @@
-<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/329" title="property file and non UTF-8 encoding chars (closed)">#329</a>
-</li></ul></li></ul>
-
-<p>
-Thanks to all of soap4r-ml members and soap4r users for their support.
-And special thanks to following contributors;
-</p>
-<pre>
-'Aaron Pfeifer' for contributing a patch for safemethodname.
-'Andi Wundsam' for contributing a patch for net/http + no_proxy.
-'anonymous contributor from Wall St.' for contributing a MSSOAP + Excel sample.
-'Emil Marceta' for contributing a patch for one-way service support.
-'Ernie' for contributing a helloworld WSDL sample and WSDL service feature of HTTPServer.
-'Felipe Contreras' for contributing an union + memberType sample and patches for missing 'require'.
-'Greg Lappen' for contributing an eBaySvc sample.
-'Ger Apeldoorn' for contributing a sample of complex type + MIME attachment.
-'Jamie Herre' for contributing a SwA implementation.
-'John Anderson' for contributing a patch for handling gzipped HTTP content.
-'Junichi Uekawa' for contributing a HTTP redirection patch for net/http.
-'Kent Sibilev' for contributing a patch for correct extraattr handling of SOAPHeaderItem.
-'Leoš Bitto' for contributing a patch for XML pretty print.
-'Michael Neumann' for contributing an original implementation of standaloneServer.
-'Oliver M. Bolzer' for contributing a patch for net/http + SSL.
-'Owen Fraser-Green' for contributing a patch for MIME CRLF handling.
-'Patrick Chanezon' for contributing a patch for wsdl2ruby classdef name option.
-'Peter Gardfjäll' for contributing a patch for wsdl:fault handling.
-'Sandi Metz' for contributing a patch for SwA in document/literal service.
-'SHINAGAWA, Norihide' for contributing a patch for emx platform.
-'Tadayoshi Funaba' for contributing a patch for date/time XMLSchema datatypes.
-'UENO Katsuhiro' for xmlscan implementation.
-'Walter Korman' for contributing soap4r.gemspec and a workaround patch for gem's require problem.
-'wrex' for contributing a patch for soap4r to work with SalesForce service.
-</pre>
-
-<h2 id="install" name="install"><span class="content">2. Install</span></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 and directories in lib 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>Tests.  It also contains useful sample scripts for servers and clients.
-<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>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-