Welcome to the "trac"-ing site of soap4r!
[soap4r] [httpclient] [openpgp4u] [pkcs1] [logger] [csv] [vtr]

root/tags/RELEASE_1_5_6/RELEASE_en.html

Revision 1849, 97.7 kB (checked in by nahi, 1 year ago)
  • save as utf-8 encoding
  • Property svn:eol-style set to native
  • Property svn:keywords set to author date id revision
Line 
1 <?xml version="1.0"?>
2 <!DOCTYPE html
3     PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
4     "DTD/xhtml1-strict.dtd">
5 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
6 <head>
7 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
8 <meta http-equiv="Content-Style-Type" content="text/css" />
9 <link rev="MADE" href="mailto:nahi@ruby-lang.org" />
10 <link rel="StyleSheet" href="rubyStyle.css" type="text/css" media="screen" />
11 <title>Release Notes - SOAP4R</title>
12 </head>
13 <body>
14
15 <div class="header">
16 <h1>
17 Release Notes - SOAP4R
18 </h1>
19
20 <p class="status">
21 Last modified: Jun 14, 2007<br />
22 Created: July 17, 2000
23 </p>
24 </div>
25
26 <hr />
27
28 <div class="main">
29 <h2><span class="content">0. In this document...</span></h2>
30
31 <p>
32 This is Release Notes of SOAP4R.
33 </p>
34
35 <p>
36 Target SOAP4R version: SOAP4R/1.5.6
37 </p>
38
39 <ol>
40 <li><a href="#changes">Changes</a></li>
41 <li><a href="#install">Install</a></li>
42 <li><a href="#uninstall">Uninstall</a></li>
43 <li><a href="#whats">What is SOAP4R?</a></li>
44 <li><a href="#dependencies">Dependencies</a></li>
45 <li><a href="#samples">Samples</a></li>
46 <li><a href="#resources">Resources</a></li>
47 <li><a href="#history">History</a></li>
48 <li><a href="#author">Author</a></li>
49 <li><a href="#copyright">Copyright</a></li>
50 </ol>
51
52 <h2 id="changes" name="changes"><span class="content">1. Changes</span></h2>
53
54 <p>
55 Here are changes in 1.5.6 from 1.5.5.
56 </p>
57 <ul><li>SOAP/Ruby mapping
58 <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>)
59 </li><li>encode or decode of single basetype parameter according to type definition in rpc/encoded service. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/14" title="wsdlRouter: return value must be converted to the specified element name (closed)">#14</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/98" title="param_def for rpc service (closed)">#98</a>)
60 </li><li>determining rpc method paramaters and outputs at runtime with MethodDefCreator" rel="nofollow">MethodDefCreator#{collect_rpcparameter|collect_documentparameter} (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/142" title="Determining rpc method paramaters and outputs at runtime (closed)">#142</a>)
61 </li><li>support an array element name other than 'item' in document/literal service. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/150" title="SOAP::FaultError - Index was outside the bounds of the array (closed)">#150</a>)
62 </li><li>let document/literal service proxy generated by
63 WSDLDriverFactory accept key-value pair array of array ([['k1', 'v1'],
64 ...]) as same as a hash ({'k1' =&gt; 'v1', ...}). (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/156" title="consider to add ordering support for simple Ruby &lt;-&gt; XML interface (closed)">#156</a>)
65 </li><li>allow an XSD::QName as a value of extraattr such as &lt;elename xmlns:n1="urn:valuenamespace"&gt;n1:value&lt;/elename&gt;. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/157" title="QName as a value (closed)">#157</a>)
66 </li><li>SwA and doc/lit service. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/165" title="SwA and doc/lit service (closed)">#165</a>)
67 </li><li>allow to define an empty SOAP Body service.  Thanks, emil.  (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/174" title="Minor change in SOAP::RPC::Driver.add_document_method (closed)">#174</a>)
68 </li><li>method overloading support. allow to define methods which have
69 same name and different signatures, and let Router invoke a method
70 according to SOAPAction. you need to define methods with different
71 SOAPAction. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/233" title="Method overloading and generated drivers (closed)">#233</a>)
72 </li><li>let Driver#generate_explicit_type work for ltieral service, too. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/234" title="generate_explicit_type for ltieral service (closed)">#234</a>)
73 </li><li>get the raw XML from the response.  you get a result as an XML string when you set Driver#return_response_as_xml = true.  (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/250" title="get the raw XML from the response (closed)">#250</a>)
74 </li><li>do not validate CES of String by default to avoid consuming
75 memory. let XML processor check it instead. (you can turn it on by
76 XSD::XSDString.strict_ces_check = true) (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/265" title="String encoding validation (closed)">#265</a>)
77 </li><li>allow SOAP::Mapping::Object to dump/load with marshal_dump/marshal_load. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/266" title="SOAP::Mapping::Object: 'singleton can't be dumped' (closed)">#266</a>)
78 </li><li>handle CDATA correctly with xmlscan and rexml (only xmlparser worked). (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/332" title="CDATA in response (closed)">#332</a>)
79 </li><li>defined omit element / xsi:nil="true" elemet control. nil
80 means xsi:nil="true" for encoded service and nil means element omission
81 for literal service. pass SOAPNil.new to pass xsi:nil="true" for
82 literal service. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/343" title="omit element / xsi:nil=&quot;true&quot; elemet control (closed)">#343</a>)
83 </li><li>one-way service support. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/200" title="one-way service support (`dump_method': undefined method `soapbody_use'  ... (closed)">#200</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/346" title="oneway service + WSDLDriverFactory (closed)">#346</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/347" title="Onewy service should return 202 Accepted / service client should accept it (closed)">#347</a>)
84 </li><li>offer clearly defined message interceptor API. see test/soap/filter for more detail. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/350" title="offer clearly defined message interceptor API (chain) (closed)">#350</a>)
85 </li><li>SOAPElement.from_obj(obj): allow to set XML attribute. this
86 method is called when you pass a Hash or [['key1', 'value1'], ...] to
87 literal service so you can easily add XML attribute to a request. see <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/331" title="attributes with namespaces (closed)">#331</a> for more detail. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/331" title="attributes with namespaces (closed)">#331</a>)
88 </li></ul></li></ul><ul><li>Payload
89 <ul><li>merged a patch from Ernie that enables httpserver to serve WSDL. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/161" title="merge a patch that enables httpserver to serve WSDL (closed)">#161</a>)
90 </li><li>allow user to set own streamhandler of a SOAP::RPC::Driver. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/180" title="Create a request and pipe it to another program (closed)">#180</a>)
91 </li><li>let Driver#test_loopback_response work under soap4r + net/http. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/181" title="Driver#test_loopback_response under soap4r + net/http (closed)">#181</a>)
92 </li><li>allow to define basic_auth parameters with property file. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/198" title="define basic_auth with property file (closed)">#198</a>)
93 </li><li>follow HTTP redirection even with net/http. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/280" title="Follow HTTP redirection even with net/http (closed)">#280</a>)
94 </li><li>[ruby-Bugs-7532] make SOAP::HTTPStreamHandler handle gzipped content.  Thanks, John Anderson.  (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/310" title="[ ruby-Bugs-7532 ] patch to make SOAP::HTTPStreamHandler handle gzipped  ... (closed)">#310</a>)
95 </li></ul></li></ul><ul><li>SOAP format
96 <ul><li>SOAP actor name can be set through HeaderHandler. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/19" title="actor support (closed)">#19</a>)
97 </li><li>support xsd:token and xsd:language. Thanks, Jirka Pech. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/252" title="Complete implementation of data types (xsd, soap) (closed)">#252</a>)
98 </li><li>let XSD::QName immutable. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/274" title="let XSD::QName immutable (closed)">#274</a>)
99 </li><li>allow Header::Handler to access SOAPHeader from inside of on_outbound. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/354" title="sending Empty SOAPHeader (closed)">#354</a>)
100 </li></ul></li></ul><ul><li>WSDL
101 <ul><li>support &lt;xsd:list&gt; of &lt;xsd:simpleType&gt;. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/3" title="&lt;xsd:list&gt; of &lt;xsd:simpleType&gt; (closed)">#3</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/248" title="String should be allowed xsd:list of xsd:simpleType (closed)">#248</a>)
102 </li><li>support &lt;xsd:union&gt; of memberTypes. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/6" title="&lt;xsd:union&gt; of memberTypes (closed)">#6</a>)
103 </li><li>support &lt;xsd:extension&gt; for &lt;xsd:complexContent&gt;. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/72" title="&lt;xsd:extension&gt; support for &lt;xsd:complexContent&gt; (closed)">#72</a>)
104 </li><li>support &lt;any&gt;. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/148" title="SForce sample:  how to create? (closed)">#148</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/155" title="&lt;any&gt; support (closed)">#155</a>)
105 </li><li>support &lt;xsd:restriction&gt; for &lt;xsd:complexContent&gt;. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/167" title="&lt;xsd:restriction&gt; support for &lt;xsd:complexContent&gt; (closed)">#167</a>)
106 </li><li>support &lt;choice&gt;. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/168" title="&lt;choice&gt; support (closed)">#168</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/205" title="sequence of choice not supported (was Unable to parse wsdl) (closed)">#205</a>)
107 </li><li>support simpleContent + attribute extension. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/176" title="simpleContent + attribute extension (closed)">#176</a>)
108 </li><li>generate Array classdef for maxOccurs="unbounded" element. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/182" title="classdef generation of element(untyped) array (closed)">#182</a>)
109 </li><li>support minLength and maxLength attributes. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/185" title="support minLength and maxLength attributes (closed)">#185</a>)
110 </li><li>support abstract attribute of complexTypes. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/195" title="wsdl2rb should not ignore the &quot;abstract&quot; attribute of complexTypes (closed)">#195</a>)
111 </li><li>moved @@schema_* things in classdef definition generated by
112 wsdl2ruby.rb to mapping registry. Mapping registries for each classdef
113 are defined in independent file and required from driver and server.
114 NOTE: old classdef files should still work but it should be
115 re-generated by new wsdl2ruby.rb. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/175" title="move @@schema_* things to MappingRegistry (closed)">#175</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/267" title="Missing 'wsdl/soap/literalMappingRegistryCreator' in driverCreator.rb (closed)">#267</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/270" title="respect ruby namespaces (closed)">#270</a>)
116 </li><li>support wsdl:fault definitions.  Thanks, Peter Gardfjall. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/319" title="[PATCH] correct handling of wsdl:fault definitions (closed)">#319</a>)
117 </li></ul></li></ul><ul><li>Samples
118 <ul><li>add a demo how to call from Excel a simple soap service running
119 in apache (sample/soap/mssoap/) Thanks, an 'anonymous contributor from
120 Wall St.' (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/143" title="a self contained example how to setup apache web server to service a wsdl  ... (closed)">#143</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/154" title="add a demo how to call from Excel a simple soap service running in apache (closed)">#154</a>)
121 </li><li>a sample to send an integer as Long type. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/160" title="add a sample to send an integer as Long type (closed)">#160</a>)
122 </li><li>an eBaySvc sample by Greg. Thanks! (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/183" title="add eBaySvc sample by Greg (closed)">#183</a>)
123 </li><li>basicauth client + server sample. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/249" title="basicauth server sample (closed)">#249</a>)
124 </li><li>cookie client + server sample. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/321" title="client + cookie sample (closed)">#321</a>)
125 </li></ul></li></ul><ul><li>misc
126 <ul><li>add a --prefix option in install.rb. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/255" title="support for a --prefix option in install.rb (closed)">#255</a>)
127 </li><li>warn misusage of lib/wsdl/soap/wsdl2ruby.rb. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/339" title="warn misusage of lib/wsdl/soap/wsdl2ruby.rb (closed)">#339</a>)
128 </li><li>wsdl2ruby --classdef could have an optional classname argument. Thanks, P@.  (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/173" title="wsdl2ruby --classdef could have an optional classname argument  (closed)">#173</a>)
129 </li><li>putting the classes that support a web service into a service-specific module.  check --module_path (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/279" title="putting the classes that support a web service into a service-specific  ... (closed)">#279</a>)
130 </li></ul></li></ul><ul><li>Bug fixes
131 <ul><li>SOAP/Ruby mapping: <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/184" title="undefined method `each' for  #&lt;SOAP::SOAPString:0x405d8eec&gt;  ... (closed)">#184</a>,
132 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/186" title="xml document with a class tag seems to cause infinite loop (closed)">#186</a>,
133 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/187" title="Axis enumerations and soap4r (closed)">#187</a>,
134 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/188" title="AWSECommerceService client sample raises &quot;unknown class/module: Header&quot; (closed)">#188</a>,
135 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/190" title="salesforce.com - undefined string maps to #&lt;SOAP::Mapping::Object:0x...&gt;  ... (closed)">#190</a>,
136 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/220" title="'.' in Method names produces an exception (closed)">#220</a>,
137 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/224" title="huge memory usage with the Ebay API (closed)">#224</a>,
138 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/225" title="`struct2soap': You have a nil object when you didn't expect it! (closed)">#225</a>,
139 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/226" title="a problem about extraattr when using SOAP::SOAPHeaderItem (closed)">#226</a>,
140 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/228" title="@@schema_element does not work in rpc service (closed)">#228</a>,
141 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/229" title="Incorrect obj2soap mapping (Case-Sensitivity) (closed)">#229</a>,
142 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/230" title="arrayType default namespace seems wrong (closed)">#230</a>,
143 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/238" title="rpc serialize + @@schema_element definition in class causes mapping error:  ... (closed)">#238</a>,
144 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/241" title="do not dump XML attribute which value is nil (closed)">#241</a>,
145 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/242" title="handling anonymous class crashes under Ruby/1.9 (closed)">#242</a>,
146 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/254" title="parameter is not submitted if &quot;name&quot; attribute contains uppercase  ... (closed)">#254</a>,
147 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/268" title="Allow safe method names with =, ?, !, or self. (closed)">#268</a>,
148 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/289" title="unqualified element generated from Hash parameter (closed)">#289</a>,
149 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/302" title="soap4r will redefine &quot;class&quot; (closed)">#302</a>,
150 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/311" title="Bad extraattr in Envelope, Body and Header (closed)">#311</a>,
151 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/312" title="Generator not working with HeaderItem childs. (closed)">#312</a>,
152 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/316" title="false children get dropped and not added to SOAP request (closed)">#316</a>,
153 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/328" title="xsd:date + WSDL generated stub (closed)">#328</a>,
154 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/333" title="[PATCH] MappingRegistryCreator missing require (closed)">#333</a>,
155 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/336" title="Element must have no character or element information item [children] (closed)">#336</a>
156 </li><li>Payload: <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/172" title="Converter not found: X_ISO_8859_1 -&gt; UTF8  ... (closed)">#172</a>,
157 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/215" title="improved end-of-line handling withing MIME messages (closed)">#215</a>,
158 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/236" title="netHttpClient.rb + no_proxy bug (closed)">#236</a>,
159 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/264" title="intermittent error: &quot;get_status must be called at the beginning of a  ... (closed)">#264</a>
160 </li><li>SOAP format: <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/177" title="SOAP Fault Codes support (closed)">#177</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/237" title="cannot parse xml:lang etc in SOAP response (closed)">#237</a>
161 </li><li>WSDL: <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/151" title="soap4r-1_5_5 wsdl2ruby.rb fails (elementFormDefault (closed)">#151</a>,
162 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/152" title="add_elements2stubobj -- elename may not be set (closed)">#152</a>,
163 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/158" title="wsdl2ruby fails to generate a class definition (closed)">#158</a>,
164 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/162" title="parameters are set to nil in request SOAP envelope (closed)">#162</a>,
165 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/163" title="WSDL2Ruby generates module definition for simpleType enumeration twice (closed)">#163</a>,
166 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/169" title="wsdl2ruby should support proxy when wsdl location is a URL (closed)">#169</a>,
167 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/170" title="wsdl2ruby.rb cannot handle WSDL using soapenc:* types (closed)">#170</a>,
168 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/178" title="wsdl2ruby.rb may generate illegal derived class definition for  ... (closed)">#178</a>,
169 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/189" title="WSDLLiteralRegistry wrongly decodes empty string and nil to  ... (closed)">#189</a>,
170 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/191" title="Problem with the documentliteral/echo.wsdl (closed)">#191</a>,
171 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/194" title="extending types seems to confuse wsdl2rb (closed)">#194</a>,
172 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/199" title="Abstract WSDL definition(no binding) causes NameError (closed)">#199</a>,
173 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/201" title="undefined method `namespace' for nil:NilClass (NoMethodError) from  ... (closed)">#201</a>,
174 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/203" title="classes not defined for simple types using restriction base (closed)">#203</a>,
175 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/204" title="when xsd: is not specified wsdl2ruby generates a wrong method (closed)">#204</a>,
176 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/216" title="Case-Sensitivity in WSDL Driver (closed)">#216</a>,
177 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/227" title="undefined method `ports' for nil:NilClass (NoMethodError) in wsdl2ruby.rb (closed)">#227</a>,
178 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/231" title="classDefCreator fails with simpleContent extension (closed)">#231</a>,
179 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/232" title="WSDLLiteralRegistry fails to map XML instance to Array: element override (closed)">#232</a>,
180 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/239" title="Possible patch to wsdl/soap/mappingRegistryCreator.rb (closed)">#239</a>,
181 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/240" title="accessing doc-lit service returns [response] only in Ruby/1.9 (closed)">#240</a>,
182 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/245" title="schema import location is not inherited (closed)">#245</a>,
183 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/246" title="not all portType are bound in the given WSDL (closed)">#246</a>,
184 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/247" title="name attribute of wsdl:operation should not be qualified (closed)">#247</a>,
185 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/258" title="PayPal WSDL generates an error (closed)">#258</a>,
186 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/260" title="'form=&quot;unqualified&quot;' (closed)">#260</a>,
187 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/262" title="no parameters generated in classes for extensions in complex types (closed)">#262</a>,
188 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/263" title="patch for #262 (closed)">#263</a>,
189 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/267" title="Missing 'wsdl/soap/literalMappingRegistryCreator' in driverCreator.rb (closed)">#267</a>,
190 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/271" title="wsdl2ruby.rb generates duplicated class definitions (closed)">#271</a>,
191 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/272" title="choice definition breakage in encoded service (closed)">#272</a>,
192 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/273" title="wsdl2ruby.rb --classdef argument not explained in usage (closed)">#273</a>,
193 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/275" title="problem with receiving subclasses using wsdl2ruby (closed)">#275</a>,
194 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/284" title="wsdl2rb produces incomplete mapping (closed)">#284</a>,
195 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/285" title="illegal mapping definition about a type 'xsd:schema' (closed)">#285</a>,
196 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/300" title="Problem in Port Init (closed)">#300</a>,
197 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/304" title="Marshalling of simple data types ends up with the wrong data type in Ruby (closed)">#304</a>,
198 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/306" title="String subclass is generated wrongly from simpleContent (closed)">#306</a>,
199 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/309" title="Bug in complexContent.rb (closed)">#309</a>,
200 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/313" title="wsdl2ruby exception with Google Adwords AdService.xml (closed)">#313</a>,
201 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/317" title="value cannot be resolved (closed)">#317</a>,
202 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/322" title="xsd2ruby generates BadURIError (closed)">#322</a>,
203 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/325" title="part: value cannot be resolved (RuntimeError) (closed)">#325</a>,
204 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/326" title="inheritance hierarchy not maintained from wsdl, problems with complexType  ... (closed)">#326</a>,
205 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/327" title="wsdl2ruby: fatal - undefined method `namespace' for  ... (closed)">#327</a>,
206 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/335" title="issues when generating a mapping registry, specifically; a literal mapping  ... (closed)">#335</a>,
207 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/337" title="wsdl2ruby produces code that overrides system classes (closed)">#337</a>,
208 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/342" title="EncodingStyle not supported (closed)">#342</a>,
209 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/344" title="ref + min/maxOccurs does not work (closed)">#344</a>,
210 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/348" title="XSD::ValueSpaceError when SOAP response contains empty elements (closed)">#348</a>,
211 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/349" title="ClassDefCreator must sort complextypes: base class first, derived classes  ... (closed)">#349</a>,
212 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/352" title="abstract type is added to the Mapping Registry, which causes malfunction (closed)">#352</a>,
213 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/353" title="private method `sub' called for #&lt;XSD::QName:...XMLSchema}anyType&gt;  ... (closed)">#353</a>
214 </li><li>misc: <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/153" title="warnings in test such as: WSDLDriverFactory#create_driver is depricated.   ... (closed)">#153</a>,
215 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/192" title="GoogleAdwords Sample doesn't work (closed)">#192</a>,
216 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/251" title="typo: 'depricated' in wsdlDriver.rb (closed)">#251</a>,
217 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/277" title="rubygems xml parser fallback broken due to rubygems 'require' bug (closed)">#277</a>,
218 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/282" title="wsdl2ruby.rb argument order dependency (closed)">#282</a>,
219 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/329" title="property file and non UTF-8 encoding chars (closed)">#329</a>
220 </li></ul></li></ul>
221
222 <p>
223 Thanks to all of soap4r-ml members and soap4r users for their support.
224 And special thanks to following contributors;
225 </p>
226 <pre>
227 'Aaron Pfeifer' for contributing a patch for safemethodname.
228 'Andi Wundsam' for contributing a patch for net/http + no_proxy.
229 'anonymous contributor from Wall St.' for contributing a MSSOAP + Excel sample.
230 'Emil Marceta' for contributing a patch for one-way service support.
231 'Ernie' for contributing a helloworld WSDL sample and WSDL service feature of HTTPServer.
232 'Felipe Contreras' for contributing an union + memberType sample and patches for missing 'require'.
233 'Greg Lappen' for contributing an eBaySvc sample.
234 'Ger Apeldoorn' for contributing a sample of complex type + MIME attachment.
235 'Jamie Herre' for contributing a SwA implementation.
236 'John Anderson' for contributing a patch for handling gzipped HTTP content.
237 'Junichi Uekawa' for contributing a HTTP redirection patch for net/http.
238 'Kent Sibilev' for contributing a patch for correct extraattr handling of SOAPHeaderItem.
239 'Leoš Bitto' for contributing a patch for XML pretty print.
240 'Michael Neumann' for contributing an original implementation of standaloneServer.
241 'Oliver M. Bolzer' for contributing a patch for net/http + SSL.
242 'Owen Fraser-Green' for contributing a patch for MIME CRLF handling.
243 'Patrick Chanezon' for contributing a patch for wsdl2ruby classdef name option.
244 'Peter Gardfjäll' for contributing a patch for wsdl:fault handling.
245 'Sandi Metz' for contributing a patch for SwA in document/literal service.
246 'SHINAGAWA, Norihide' for contributing a patch for emx platform.
247 'Tadayoshi Funaba' for contributing a patch for date/time XMLSchema datatypes.
248 'UENO Katsuhiro' for xmlscan implementation.
249 'Walter Korman' for contributing soap4r.gemspec and a workaround patch for gem's require problem.
250 'wrex' for contributing a patch for soap4r to work with SalesForce service.
251 </pre>
252
253 <h2 id="install" name="install"><span class="content">2. Install</span></h2>
254
255 <p>
256 At first, see <a href="#dependencies">Dependencies</a> section.
257 You may need to install some extra packages.
258 Next, get the archived file of SOAP4R and extract it, then simply try;
259 </p>
260 <pre class="path">
261 $ ruby install.rb
262 </pre>
263
264 <p>
265 Necessary files will be installed to suitable directory.
266 </p>
267
268 <p>
269 Files and directories in lib directory are SOAP4R library program itself.
270 </p>
271
272 <dl>
273 <dt class="path">lib/</dt>
274 <dd>Libraries.</dd>
275
276 <dt class="path">sample/</dt>
277 <dd>SOAP4R samples.
278 See <a href="#samples">Samples</a> section.</dd>
279
280 <dt class="path">test/</dt>
281 <dd>Tests.  It also contains useful sample scripts for servers and clients.
282 <br/>
283 test/interopR2/ directory includes Clients/Server for
284 <a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
285 Followings are advanced examples to use complex type transmit,
286 sending base64 encoded string, multi-dimensional array, and so on.
287 <ul>
288 <li>test/interopR2/server.rb is a RPC Server side implementation.</li>
289 <li>test/interopR2/client.rb is a RPC Client side implementation.</li>
290 <li>test/interopR2/base.rb includes common definitions for client/server.</li>
291 </ul>
292 </dd>
293 </dl>
294
295 <h2 id="uninstall" name="uninstall"><span class="content">3. Uninstall</span></h2>
296
297 <p>
298 Simply delete installed files.
299 </p>
300
301 <h2 id="whats" name="whats"><span class="content">4. What is SOAP4R?</span></h2>
302
303 <p>
304 'SOAP4R' is an implementation of
305 <a href="http://www.w3.org/TR/SOAP/">SOAP 1.1 (W3C Note)</a>.
306 </p>
307
308 <p>
309 Comments, information such as interoperability between SOAP4R and another implementation are welcomed.
310 Feel free sending mail to
311 <a href="mailto:nahi@ruby-lang.org" class="path">nahi@ruby-lang.org</a>.
312 </p>
313
314 <h2 id="dependencies" name="dependencies"><span class="content">5. Dependencies</span></h2>
315
316 <p>
317 SOAP4R is written in <a href="http://www.ruby-lang.org">Ruby</a> and
318 aims to use with Ruby application.
319 You have to install Ruby itself.
320 Ruby/1.6 series or later is required.
321 </p>
322 <ul>
323   <li>ruby-1.8.6</li>
324   <li>ruby-1.6.8</li>
325 </ul>
326
327 <p>
328 SOAP4R depends on following Ruby modules in
329 <a href="http://raa.ruby-lang.org">RAA</a>.
330 You also have to install these modules to use SOAP4R.
331 </p>
332
333 <h3><span class="content">for ruby-1.8.6</span></h3>
334
335 <dl>
336 <dt class="path"><a href="http://raa.ruby-lang.org/project/http-access2/">[RAA:http-access2]</a> (2.0.5) (required for SSL)</dt>
337 <dd>Yet another HTTP client implementation by NaHi.
338 It's not required when you don't use SSL, but it's recommended to use.
339 The author always runs and checks soap4r with http-access2.</dd>
340
341 <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>
342 <dd>by Yoshida Masato.
343 It is requred when you want automatic CES conversion between
344 SJIS &lt;-&gt; UTF8 and EUC &lt;-&gt; UTF8.
345 Note: SJIS &lt;-&gt; EUC uses NKF module which is in standard distribution.
346 </dd>
347
348 </dl>
349
350 <h3><span class="content">for ruby-1.6.8</span></h3>
351
352 <dl>
353 <dt class="path"><a href="http://raa.ruby-lang.org/project/webrick/">[RAA:webrick]</a> (1.3.1)</dt>
354 <dd>TCP server toolkit by Gotoyuzo.</dd>
355
356 <dt class="path"><a href="http://raa.ruby-lang.org/project/http-access2/">[RAA:http-access2]</a> (2.0.5)</dt>
357 <dd>Yet another HTTP client implementation by NaHi.</dd>
358
359 <dt class="path"><a href="http://raa.ruby-lang.org/project/devel-logger/">[RAA:devel-logger]</a> (1.1.0)</dt>
360 <dd>Logging utility by NaHi.</dd>
361
362 <dt class="path"><a href="http://raa.ruby-lang.org/project/date2/">[RAA:date2]</a> (3.2)</dt>
363 <dd>Date and DateTime implementation by Todayoshi Funaba.</dd>
364
365 <dt class="path"><a href="http://raa.ruby-lang.org/project/uconv/">[RAA:uconv]</a> (0.4.10) (required for UTF-8 handling)</dt>
366 <dd>by Yoshida Masato.
367 It is requred when you want automatic CES conversion between
368 SJIS &lt;-&gt; UTF8 and EUC &lt;-&gt; UTF8.
369 Note: SJIS &lt;-&gt; EUC uses NKF module which is in standard distribution.
370 </dd>
371
372 </dl>
373
374 <h2 id="samples" name="samples"><span class="content">6. Samples</span></h2>
375
376 <p>
377 Samples are in sample/ directory of distribution.
378 Some samples try to connect to public servers.
379 Set environment variable SOAP_USE_PROXY and HTTP_PROXY if you are in a firewall and you have
380 http proxy to the internet like;
381 </p>
382 <pre class="path">
383 $ export SOAP_USE_PROXY=on
384 $ export HTTP_PROXY=http://myproxyserver:8080
385   or
386 $ setenv SOAP_USE_PROXY on
387 $ setenv HTTP_PROXY http://myproxyserver:8080
388 </pre>
389
390 <h3><span class="content">basic/ ... basic samples</span></h3>
391
392     <dl>
393       <dt class="path">babelfish.rb</dt>
394       <dd>a SOAP client sample to connect to a babelfish server.</dd>
395       <dt class="path">whois.rb</dt>
396       <dd>a SOAP client sample to connect to a whois server.</dd>
397       <dt class="path">flickr.rb</dt>
398       <dd>a SOAP client sample to connect to the flickr SOAP server and extract data from XML response.</dd>
399       <dt class="path">yahooNewsSearch.rb</dt>
400       <dd>a HTTP client sample to connect to the Yahoo news search REST service and extract data from XML response.</dd>
401
402       <dt class="path">helloworld/</dt>
403       <dd>a SOAP server and client sample of 'Hello World'.
404           To run the server;
405 <pre class="path">
406 $ ./server.rb
407 </pre>
408           And to connect to the server, run the client;
409 <pre class="path">
410 $ ./client.rb
411 </pre>
412       </dd>
413
414       <dt class="path">calc/</dt>
415       <dd>Calc service contains 2 servers and 2 clients.
416         calc.rb is hosted by server.rb, calc2.rb is hosted by server2.rb.
417         client.rb is for server.rb, client2.rb is for server2.rb.
418         <dl>
419           <dt>calc.rb</dt>
420           <dd>Calc server definition using module and module methods.
421             This module responds 'add', 'sub', 'multi' and 'div'.
422           </dd>
423           <dt>server.rb</dt>
424           <dd>Standalone server.
425             It requires calc.rb and serve module methods of this module.
426             To run this server;
427 <pre class="path">
428 $ ./server.rb
429 </pre>
430           </dd>
431           <dt>server.cgi</dt>
432           <dd>CGI version.
433             To run this server, copy server.cgi and calc.rb to suitable
434             directory of your WWW server.
435           </dd>
436           <dt>client.rb</dt>
437           <dd>It connects to server.rb or server.cgi,
438             and hit methods served by calc.rb.
439             To run the client;
440 <pre class="path">
441 $ ./client.rb
442 </pre>
443             Is it stacked?  Did you run the server.rb?<br/>
444             Turn logger and wireDumpDev in its source on to see logs and wire
445             dumps of SOAP transport.
446           </dd>
447           <dt>calc2.rb</dt>
448           <dd>Calc server definition using class and instance methods.
449             An instance of this class holds its value.  Methods 'set' and 'get'
450             is to set/get the value.
451             It also responds to '+', '-', '*', and '/'.
452           </dd>
453           <dt>server2.rb</dt>
454           <dd>It requires calc2.rb and creates an instance of CalcService2
455             that responds all SOAP requests.
456             Since '+', '-' and so on of calc2.rb are not valid name as an
457             element in XML instance, this sample register the method '+' as
458             'add', '-' as 'sub', and so on.
459           </dd>
460           <dt>server2.cgi</dt>
461           <dd>CGI version.
462             To run this server, copy server2.cgi and calc2.rb to suitable
463             directory of your WWW server.
464           </dd>
465           <dt>client2.rb</dt>
466           <dd>It connects to server2.rb or server2.cgi.
467             Set a value at first and call methods like 'puts objAtServer + 2'.
468           </dd>
469         </dl>
470       </dd>
471
472       <dt class="path">exchange/</dt>
473       <dd>A sample to retrieve the currency rate from public SOAP service.
474         <dl>
475           <dt>iExchange.rb</dt>
476           <dd>It includes common definitions for client and server of
477             Exchange service.  Including only a definition of namespace URI of
478             this service.</dd>
479           <dt>exchange.rb</dt>
480           <dd>Definition of servant class ExchangeService which returns the
481             currency rate after connecting to another site by SOAP to get the
482             real rate.
483             So that this class is the SOAP server for local client and
484             is also a SOAP client for public server.
485             An instance of this class is hosted by server.rb.
486             The instance responds to only 'getRate' which receives two country
487             code such as 'USA' and 'Japan'.</dd>
488           <dt>server.rb</dt>
489           <dd>It requires exchange.rb and creates an instance of
490             ExchangeService that responds all SOAP requests.
491             To run this server;
492 <pre class="path">
493 $ ./server.rb
494 </pre>
495           </dd>
496           <dt>server.cgi</dt>
497           <dd>CGI version.  To run this server, copy server.cgi and exchange.rb
498             to suitable directory of your WWW server.</dd>
499           <dt>client.rb</dt>
500           <dd>It connects to server.rb.  Turn logger and wireDumpDev in its
501             source on to see logs and wire dumps of SOAP transport.
502             To run the client;
503 <pre class="path">
504 $ ./client.rb
505 </pre>
506           </dd>
507         </dl>
508       </dd>
509
510       <dt class="path">sampleStruct/</dt>
511       <dd>A sample to transmit complex structured object which has recursive
512         object reference.
513         <dl>
514           <dt>iSampleStruct.rb</dt>
515           <dd>It includes common definitions for client and server of
516             SampleStruct service.  Definition of SampleStruct class and
517             namespace URI of this service.</dd>
518           <dt>sampleStruct.rb</dt>
519           <dd>Definition of servant class SampleStructService.
520             An instance of this class is hosted by server.rb.
521             The instance responds to only 'hi' which receives a SampleStruct
522             and wraps it in the new instance of SampleStruct to return .</dd>
523           <dt>server.rb</dt>
524           <dd>It requires sampleStruct.rb and creates an instance of
525             SampleStructService that responds all SOAP requests.
526             To run this server;
527 <pre class="path">
528 $ ./server.rb
529 </pre>
530           </dd>
531           <dt>server.cgi</dt>
532           <dd>CGI version.  To run this server, copy server.cgi and
533             sampleStruct.rb to suitable directory of your WWW server.</dd>
534           <dt>client.rb</dt>
535           <dd>It connects to server.rb.  Turn logger and wireDumpDev in its
536             source on to see logs and wire dumps of SOAP transport.
537             To run the client;
538 <pre class="path">
539 $ ./client.rb
540 </pre>
541           </dd>
542         </dl>
543       </dd>
544
545       <dt class="path">wsdl_helloworld/</dt>
546       <dd>A sample 'Hello World' SOAP client and server which utilize WSDL.
547       See wsdl_helloworld/README for more detail</dd>
548     </dl>
549
550 <h3><span class="content">payload/ ... various payload configuration</span></h3>
551
552     <dl>
553       <dt class="path">basicauth/</dt>
554       <dd>BasicAuth server and client sample.</dd>
555
556       <dt class="path">cookies/</dt>
557       <dd>HTTP-Cookies server and client sample.</dd>
558
559       <dt class="path">ssl/</dt>
560       <dd>SSL SOAP server and client samples.
561         <dl>
562           <dt class="path">sslserver.rb</dt>
563           <dd>SSL server sample which hosts "hello world" service.
564             This server uses SSL server certificate in files/ directory
565             (SSL client should check this certificate for SSL server
566             authentication).</dd>
567           <dt class="path">sslserver_noauth.rb</dt>
568           <dd>This server generates SSL server certificate
569             at runtime.  No security.</dd>
570           <dt class="path">sslserver_require_clientauth.rb</dt>
571           <dd>This server users SSL server certificate in files/ directory
572             and requires SSL client authentication (clients must
573             have SSL client certificate and send it to the server).</dd>
574           <dt class="path">sslclient.rb</dt>
575           <dd>SSL client sample which calls "hello world" service via HTTPS.
576             This client checks SSL server certificate sent from SSL server.</dd>
577           <dt class="path">sslclient_require_noserverauth.rb</dt>
578           <dd>This client does not check SSL server certificate.
579             No security.</dd>
580           <dt class="path">sslclient_with_clientauth.rb</dt>
581           <dd>This client sends SSL client certificate in files/ directory
582             and checks SSL server certificate.</dd>
583         </dl>
584       </dd>
585
586       <dt class="path">gzipped/</dt>
587       <dd>gzipped content negotiation server and client sample.</dd>
588     </dl>
589
590 <h3><span class="content">soapheader/ ... SOAPHeader configuration</span></h3>
591
592     <dl>
593       <dt class="path">authheader/</dt>
594       <dd>It contains a sample to utilize SOAP Header handler.  Send
595         userid/passwd and receive sessionid via SOAP Header</dd>
596
597       <dt class="path">soapext_basicauth/</dt>
598       <dd>It contains a sample to do BasicAuth in SOAPHeader.  (http://soap-authentication.org/basic/2001/10/)</dd>
599     </dl>
600
601 <h3><span class="content">attachment/ ... SOAP with Attachment (SwA)</span></h3>
602
603     <dl>
604       <dt class="path">swa/</dt>
605       <dd>SOAP server and client sample of SwA (SOAP with Attachments).</dd>
606
607       <dt class="path">complexmime/</dt>
608       <dd>SOAP server and client sample of Complex Type + SwA</dd>
609     </dl>
610
611 <h3><span class="content">howto/ ... various other configuration</span></h3>
612
613     <dl>
614       <dt class="path">as_xml/</dt>
615       <dd>Sample client to send a request with XML, and receive a response as XML.</dd>
616
617       <dt class="path">base64/</dt>
618       <dd>Sample client to send/receive base64 data.</dd>
619
620       <dt class="path">documentliteral/</dt>
621       <dd>Sample client and server of document/literal service.  See README.txt in this directory to run this sample.</dd>
622
623       <dt class="path">filter/</dt>
624       <dd>Sample client and server of filtering request/response before sending/receiving.</dd>
625
626       <dt class="path">scopesample/</dt>
627       <dd>SOAP server sample which shows a different behavior of SOAP server scope settings; Request scope vs Application scope.
628         sample/soap/scopesample/servant.rb is a servant which holds push-ed
629         object that can be pop-ed afterward.
630         See sample/soap/scopesample/server.rb how to define a servant as
631         a Request scope servant or an Application scope servant.
632         Application scope servant works as we expected because the servant
633         object is living from beginning to the time server terminated.
634         In contrast, request scope servant(s) does not work because a servant
635         object is created for each request.
636       </dd>
637
638       <dt class="path">styleuse/</dt>
639       <dd>Sample client and server of SOAP style and use combination, especially rpc/literal and document/encoded.</dd>
640
641       <dt class="path">wsdl_fault/</dt>
642       <dd>Sample client and server of handling SOAP fault specified in a WSDL.  See wsdl_fault/README.txt for more detail.</dd>
643
644       <dt class="path">wsdl_hash/</dt>
645       <dd>Sample client and server of sending/receiving Hash struct defined in a WSDL.</dd>
646     </dl>
647
648 <h3><span class="content">marshal/ ... object &lt;-&gt; XML marshalling</span></h3>
649
650     <dl>
651       <dt class="path">digraph.rb</dt>
652       <dd>A sample of SOAP marshalling/unmarshalling.
653         It creates a digraph that contains multi-ref-ed nodes at first
654         and marshals this object to get serialized XML instance.
655         Then reads and unmarshals this XML instance to recover a object
656         which has the same links among nodes in the digraph.
657       </dd>
658
659       <dt class="path">customfactory.rb</dt>
660       <dd>Sample program for customizing mapping registry.</dd>
661
662       <dt class="path">enum/</dt>
663       <dd>Sample program to demonstrate how xsd2ruby.rb works.</dd>
664     </dl>
665
666 <h3><span class="content">showcase/ ... showcase sample to demonstrate</span></h3>
667
668     <dl>
669       <dt class="path">raa2.4/</dt>
670       <dd>sample/soap/raa2.4/sample.rb is a sample client to retrieve project
671         information on RAA.  It uses raaDriver.rb which is generated by
672         wsdl2ruby.rb from WSDL at
673         <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>.
674         You'll find wsdlDriver.rb in sample/wsdl/raa2.4/wsdlDriver.rb which
675         loads the WSDL at runtime to connect.</dd>
676
677       <dt class="path">icd/</dt>
678       <dd>A client for
679         <a href="http://www.iwebmethod.net/">Insider's Computer Dictionary Web Service</a>.
680         This service is implemented with ASP.NET so that it's also a sample of
681         a client which connects to ASP.NET.
682         CAUTION: this sample contains non-ascii chars in its source and dumped
683         results.
684         <dl>
685           <dt>IICD.rb</dt>
686           <dd>Class(type) definitions for this server.</dd>
687           <dt>icd.rb</dt>
688           <dd>Client implementation.  To run the client;
689 <pre class="path">
690 $ ./icd.rb
691 </pre>
692           </dd>
693         </dl>
694       </dd>
695
696       <dt class="path">googleSearch/</dt>
697       <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>
698
699       <dt class="path">amazon/</dt>
700       <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>
701
702       <dt class="path">noaa/</dt>
703       <dd>Sample client of National Weather Service digital weather forecast data service at http://weather.gov/</dd>
704
705       <dt class="path">raa2.4/</dt>
706       <dd>sample/wsdl/raa2.4/wsdlDriver.rb is a sample client to retrieve
707         project information on RAA.  It loads WSDL file
708         <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>
709         at <strong>runtime</strong>.
710         You'll find a sample client at sample/soap/raa2.4/sample.rb
711         which connects RAA using pre-generated service definitions
712         (not loads WSDL at runtime).</dd>
713
714       <dt class="path">googleAdwords/</dt>
715       <dd>Sample client of Google AdWords service. 
716         CAUTION: I don't have an account of AdWords so the sample code is NOT
717         tested.  Please tell me (nahi@ruby-lang.org) if you will get good/bad
718         result in communicating with AdWords Server.</dd>
719
720       <dt class="path">amazonEC/</dt>
721       <dd>Sample client of AWSECommerce service.
722         CAUTION: I don't have an account of AWSECommerce so the sample code is
723         NOT tested.  Please tell me (nahi@ruby-lang.org) if you will get
724         good/bad result in communicating with AWSECommerce Server.</dd>
725     </dl>
726
727 <p>
728 There are more samples in this directory.
729 </p>
730
731 <h2 id="resources" name="resources"><span class="content">7. Resources</span></h2>
732
733 <dl>
734 <dt class="path"><a href="http://dev.ctor.org/soap4r">soap4r project page</a></dt>
735 <dd>You can get the latest information and the latest development version of soap4r here.</dd>
736
737 <dt class="path"><a href="http://raa.ruby-lang.org/project/soap4r">[RAA:soap4r]</a></dt>
738 <dd>RAA meta information</dd>
739
740 <dt class="path"><a href="http://groups.google.com/group/soap4r">soap4r-ml on Google Groups</a></dt>
741 <dd>Feel free to join the list to ask any question and comment about soap4r.
742   You can browse messages archive.  Bear in mind that Google Groups is still
743   in [beta] stage.</dd>
744
745 <dt class="path">Subversion repository</dt>
746 <dd>Soap4r's svn repository is here: http://dev.ctor.org/svn/soap4r/ .
747   To checkout the latest soap4r module, try
748 <pre>
749 svn checkout http://dev.ctor.org/svn/soap4r/trunk soap4r
750 </pre>
751   CVS repository of soap4r which was located at cvs.ruby-lang.org is pending since 2004-05-27. </dd>
752 </dl>
753
754 <h2 id="history" name="history"><span class="content">8. History</span></h2>
755
756 <dl>
757 <dt>1.5.5 - Sep 15, 2005</dt>
758 <dd> Here are changes in 1.5.5 from 1.5.4.
759 <ul><li>SOAP
760 <ul><li>allow to configure an envelope namespace of SOAP request. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/124" title="configuable envelope namespace (closed)">#124</a>)
761 <pre class="wiki">TemporaryNamespace = 'http://www.w3.org/2003/05/soap-envelope'
762 @client.options[&#34;soap.envelope.requestnamespace&#34;] = TemporaryNamespace
763 @client.options[&#34;soap.envelope.responsenamespace&#34;] = TemporaryNamespace
764 @client.do_proc(...)
765 </pre>
766 </li><li>let SOAP request XML indent space configuable.  see "soap.envelope.no_indent" option. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/130" title="A server dislike indent spaces in XML instance (closed)">#130</a>)
767
768 </li><li>let external CES configuable.  ex. client["soap.mapping.external_ces"] = 'SJIS'.  $KCODE is used by default. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/133" title="let $KCODE free (closed)">#133</a>)
769 <pre class="wiki">external CES ::= CES used in Ruby object of client and server
770 internal CES ::= CES used in SOAP/OM
771 </pre>
772 </li><li>add iso-8859-1 external CES support. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/106" title="iso-8859-1 encoded response (closed)">#106</a>)
773 </li><li>fixed illegal 'qualified' handling of elements.  it caused ASP.NET inteoperability problem. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/144" title="soap4r and ASP.NET problems about 'qualified' (closed)">#144</a>)
774 </li><li>added 'soap.envelope.use_numeric_character_reference' (boolean) option to let query XML use numeric character reference in XML, not plain UTF-8 character.  GoogleSearch server seems to not allow plain UTF-8 character since 2005-08-15 update. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/147" title="GoogleWebSearch does not work with UTF-8 query (closed)">#147</a>)
775 </li><li>SOAP::Header::SimpleHeader (de)serialization throws an exception on SimpleHeader.on_(in|out)bound when header is a String.  so we could not use a simple single element headerItem.  fixed.  thanks to emil. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/129" title="SOAP::Header::SimpleHeader deserialization throws on ... (closed)">#129</a>)
776
777 </li><li>out parameter of rpc operation did not work.  (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/132" title="outparameter causes NameError (closed)">#132</a>)
778 </li><li>follow HTTP redirect only if using http-access2.  (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/125" title="follow http/https redirection (closed)">#125</a>) (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/145" title="an error from streamHandler.rb:37 that claims an uninitialized constant ... (closed)">#145</a>)
779 </li><li>add a workaround for importing an WSDL whose path begins with drive letter.  (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/115" title="RuntimeError: Cannot connect to ... (closed)">#115</a>)
780 </li></ul></li><li>WSDL
781 <ul><li>SOAP Data which is defined as a simpletype was not mapped correctly to Ruby obj when using wsdl2ruby.rb generated classdef file. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/123" title="soap4r mapping problem when using google adwords api (closed)">#123</a>)
782 </li><li>rpc/literal support. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/118" title="soap encoding is used for rpc/literal services (closed)">#118</a>)
783
784 </li><li>re-implemented local element qualify/unqualify control.  handles elementFormDefault and form in WSDL.  (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/119" title="Cannot talk to doc/literal service which is has ... (closed)">#119</a>)
785 </li><li>Array of an element which has simpleType causes a crash. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/128" title="Array of a element which has simpleType causes a crash (closed)">#128</a>)
786 </li><li>prarmeterOrder may not contain return part so it can be shorter than parts size.  Thanks to Hugh.  (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/139" title="prarmeterOrder may not contain return part (closed)">#139</a>)
787 </li></ul></li><li>Samples
788 <ul><li>added BasicAuth client sample. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/117" title="add BasicAuth sample not only in test dir but also in sample dir (closed)">#117</a>)
789 </li><li>added Base64 client/server sample.
790 </li><li>added Flickr SOAP interface client sample. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/122" title="Flickr SOAP API support (closed)">#122</a>)
791
792 </li><li>added SalesForce client sample. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/135" title="how to set session id in SOAP header (sforce WSDL) (closed)">#135</a>)
793 </li><li>updated Thawte CA certificate for GoogleAdWords sample.
794 </li><li>updated a client script with the newer version made by Johan.  thanks!
795 </li><li>shortened long file names. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/120" title="long file name (closed)">#120</a>)
796 </li><li>fixed typo in authheader sample. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/129" title="SOAP::Header::SimpleHeader deserialization throws on ... (closed)">#129</a>)
797 </li><li>updated deprecated method usage.  (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/138" title="create_driver in sample should be replaced with create_rpc_driver (closed)">#138</a>)
798 </li></ul></li></ul>
799 </dd>
800
801 <dt>1.5.4 - May 13, 2005</dt>
802 <dd>This is version 1.5.4.
803 Version 1.5.3 is the module which is included in ruby-1.8.2,
804 and not released independently.
805 Following changes consist from 2 parts; Changes from 1.5.3 to 1.5.4,
806 and from 1.5.2 to 1.5.3.
807 <br/><br/>
808 Changes in 1.5.4 from 1.5.3
809 <br/><br/>
810 <ul>
811   <li>SOAP client and server
812     <ul>
813       <li>for both client side and server side
814         <ul>
815           <li>improved document/literal service support.  style(rpc, document)/use(encoding, literal) combination are all supported.  for the detail about combination, see test/soap/test_style.rb.</li>
816           <li>let WSDLEncodedRegistry#soap2obj map SOAP/OM to Ruby according to WSDL as well as obj2soap.</li>
817           <li>let SOAP::Mapping::Object handle XML attribu