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

root/tags/RELEASE_1_5_7/RELEASE_en.html

Revision 1888, 102.2 kB (checked in by nahi, 1 year ago)
  • updated release note.
  • Version 1.5.7
  • 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: Jul 16, 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.7
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 Version 1.5.7 mainly intends to fix regression problems introduced in 1.5.6.
56 Here are changes in 1.5.7 from 1.5.6.
57 </p>
58 <ul><li>Environment
59 <ul><li>soap4r gem depends on httpclient &gt;= 2.1.0. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/379" title="let soap4r gem depends on httpclient &gt;= 2.1.0 (closed)">#379</a>)
60 </li><li>let soap4r http clients (SOAP::RPC::Driver and WSDL/XSD importers) do not check soap_use_proxy environment variable and use only http_proxy/HTTP_PROXY and no_proxy/NO_PROXY envvars for proxy configuration.  no need to set 'soap_use_proxy=on' envvar anymore.  But to avoid proxy injection problem, when a library is used on CGI environment (with checking REQUEST_METHOD envvar existence), soap4r http clients use cgi_http_proxy/CGI_HTTP_PROXY envvar instead of http_proxy/HTTP_PROXY. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/378" title="change HTTP_PROXY/NO_PROXY envvar behavior to follow httpclient (closed)">#378</a>)
61 </li></ul></li></ul><ul><li>SOAP/Ruby mapping
62 <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>)
63 </li><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>)
64
65 </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>)
66 </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>)
67 </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>)
68 </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>)
69 </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>)
70
71 </li></ul></li></ul><ul><li>SOAP
72 <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>)
73 </li><li>allow to customize default ns definition of SOAP Envelope. SOAPGenerator.new gets option hash as 'opt' and treats opt[:default_ns] as a XSD::NS which stores default ns definition of SOAP Envelope. See how it works in test/soap/test_custom_ns.rb. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/380" title="default XSD::NS for SOAPGenerator (closed)">#380</a>)
74
75 </li></ul></li></ul><ul><li>Payload
76 <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>)
77 </li><li>added 'protocol.http.auth' option to set authentication information for both BasicAuth and DigestAuth. with the latest httpclient (formerly known as 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>)
78
79 </li></ul></li></ul><ul><li>WSDL
80 <ul><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>)
81 </li><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>)
82 </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>)
83 </li></ul></li></ul>
84
85 <p>
86 Thanks to all of soap4r-ml members and soap4r users for their support.
87 And special thanks to following contributors;
88 </p>
89 <pre>
90 'Aaron Pfeifer' for contributing a patch for safemethodname.
91 'Andi Wundsam' for contributing a patch for net/http + no_proxy.
92 'anonymous contributor from Wall St.' for contributing a MSSOAP + Excel sample.
93 'Emil Marceta' for contributing a patch for one-way service support.
94 'Ernie' for contributing a helloworld WSDL sample and WSDL service feature of HTTPServer.
95 'Felipe Contreras' for contributing an union + memberType sample and patches for missing 'require'.
96 'Greg Lappen' for contributing an eBaySvc sample.
97 'Ger Apeldoorn' for contributing a sample of complex type + MIME attachment.
98 'Jamie Herre' for contributing a SwA implementation.
99 'John Anderson' for contributing a patch for handling gzipped HTTP content.
100 'Junichi Uekawa' for contributing a HTTP redirection patch for net/http.
101 'Kent Sibilev' for contributing a patch for correct extraattr handling of SOAPHeaderItem.
102 'Leoš Bitto' for contributing a patch for XML pretty print.
103 'Michael Neumann' for contributing an original implementation of standaloneServer.
104 'Oliver M. Bolzer' for contributing a patch for net/http + SSL.
105 'Owen Fraser-Green' for contributing a patch for MIME CRLF handling.
106 'Patrick Chanezon' for contributing a patch for wsdl2ruby classdef name option.
107 'Peter Gardfjäll' for contributing a patch for wsdl:fault handling.
108 'Sandi Metz' for contributing a patch for SwA in document/literal service.
109 'SHINAGAWA, Norihide' for contributing a patch for emx platform.
110 'Tadayoshi Funaba' for contributing a patch for date/time XMLSchema datatypes.
111 'UENO Katsuhiro' for xmlscan implementation.
112 'Walter Korman' for contributing soap4r.gemspec and a workaround patch for gem's require problem.
113 'wrex' for contributing a patch for soap4r to work with SalesForce service.
114 </pre>
115
116 <h2 id="install" name="install"><span class="content">2. Install</span></h2>
117
118 <p>
119 At first, see <a href="#dependencies">Dependencies</a> section.
120 You may need to install some extra packages.
121 Next, get the archived file of SOAP4R and extract it, then simply try;
122 </p>
123 <pre class="path">
124 $ ruby install.rb
125 </pre>
126
127 <p>
128 Necessary files will be installed to suitable directory.
129 </p>
130
131 <p>
132 Files and directories in lib directory are SOAP4R library program itself.
133 </p>
134
135 <dl>
136 <dt class="path">lib/</dt>
137 <dd>Libraries.</dd>
138
139 <dt class="path">sample/</dt>
140 <dd>SOAP4R samples.
141 See <a href="#samples">Samples</a> section.</dd>
142
143 <dt class="path">test/</dt>
144 <dd>Tests.  It also contains useful sample scripts for servers and clients.
145 <br/>
146 test/interopR2/ directory includes Clients/Server for
147 <a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
148 Followings are advanced examples to use complex type transmit,
149 sending base64 encoded string, multi-dimensional array, and so on.
150 <ul>
151 <li>test/interopR2/server.rb is a RPC Server side implementation.</li>
152 <li>test/interopR2/client.rb is a RPC Client side implementation.</li>
153 <li>test/interopR2/base.rb includes common definitions for client/server.</li>
154 </ul>
155 </dd>
156 </dl>
157
158 <h2 id="uninstall" name="uninstall"><span class="content">3. Uninstall</span></h2>
159
160 <p>
161 Simply delete installed files.
162 </p>
163
164 <h2 id="whats" name="whats"><span class="content">4. What is SOAP4R?</span></h2>
165
166 <p>
167 'SOAP4R' is an implementation of
168 <a href="http://www.w3.org/TR/SOAP/">SOAP 1.1 (W3C Note)</a>.
169 </p>
170
171 <p>
172 Comments, information such as interoperability between SOAP4R and another implementation are welcomed.
173 Feel free sending mail to
174 <a href="mailto:nahi@ruby-lang.org" class="path">nahi@ruby-lang.org</a>.
175 </p>
176
177 <h2 id="dependencies" name="dependencies"><span class="content">5. Dependencies</span></h2>
178
179 <p>
180 SOAP4R is written in <a href="http://www.ruby-lang.org">Ruby</a> and aims to use with Ruby application.
181 You have to install ruby itself.  Tested against the following ruby versions.
182 </p>
183
184 <ul>
185   <li>ruby-1.8.5</li>
186   <li>ruby-1.8.5 patchlevel 52</li>
187   <li>ruby-1.8.6</li>
188   <li>ruby-1.8.6 patchlevel 36</li>
189 </ul>
190
191 <p>
192 SOAP4R depends on following Ruby modules in
193 <a href="http://raa.ruby-lang.org">RAA</a>.
194 You also have to install these modules to use SOAP4R.
195 </p>
196
197 <dl>
198 <dt class="path"><a href="http://raa.ruby-lang.org/project/httpclient/">[RAA:httpclient]</a> (2.1.0 or later)</dt>
199 <dd>Yet another HTTP client implementation by NaHi.
200 httpclient is formerly known as http-access2.</dd>
201
202 <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>
203 <dd>by Yoshida Masato.
204 It is requred when you want automatic CES conversion between
205 SJIS &lt;-&gt; UTF8 and EUC &lt;-&gt; UTF8.
206 Note: SJIS &lt;-&gt; EUC uses NKF module which is in standard distribution.
207 </dd>
208
209 </dl>
210
211 <h2 id="samples" name="samples"><span class="content">6. Samples</span></h2>
212
213 <p>
214 Samples are in sample/ directory of distribution.
215 Some samples try to connect to public servers.
216 Set environment variable HTTP_PROXY if you are in a firewall and you have
217 http proxy to the internet like;
218 </p>
219 <pre class="path">
220 $ export HTTP_PROXY=http://myproxyserver:8080
221   or
222 $ setenv HTTP_PROXY http://myproxyserver:8080
223 </pre>
224
225 <h3><span class="content">basic/ ... basic samples</span></h3>
226
227     <dl>
228       <dt class="path">babelfish.rb</dt>
229       <dd>a SOAP client sample to connect to a babelfish server.</dd>
230       <dt class="path">whois.rb</dt>
231       <dd>a SOAP client sample to connect to a whois server.</dd>
232       <dt class="path">flickr.rb</dt>
233       <dd>a SOAP client sample to connect to the flickr SOAP server and extract data from XML response.</dd>
234       <dt class="path">yahooNewsSearch.rb</dt>
235       <dd>a HTTP client sample to connect to the Yahoo news search REST service and extract data from XML response.</dd>
236
237       <dt class="path">helloworld/</dt>
238       <dd>a SOAP server and client sample of 'Hello World'.
239           To run the server;
240 <pre class="path">
241 $ ./server.rb
242 </pre>
243           And to connect to the server, run the client;
244 <pre class="path">
245 $ ./client.rb
246 </pre>
247       </dd>
248
249       <dt class="path">calc/</dt>
250       <dd>Calc service contains 2 servers and 2 clients.
251         calc.rb is hosted by server.rb, calc2.rb is hosted by server2.rb.
252         client.rb is for server.rb, client2.rb is for server2.rb.
253         <dl>
254           <dt>calc.rb</dt>
255           <dd>Calc server definition using module and module methods.
256             This module responds 'add', 'sub', 'multi' and 'div'.
257           </dd>
258           <dt>server.rb</dt>
259           <dd>Standalone server.
260             It requires calc.rb and serve module methods of this module.
261             To run this server;
262 <pre class="path">
263 $ ./server.rb
264 </pre>
265           </dd>
266           <dt>server.cgi</dt>
267           <dd>CGI version.
268             To run this server, copy server.cgi and calc.rb to suitable
269             directory of your WWW server.
270           </dd>
271           <dt>client.rb</dt>
272           <dd>It connects to server.rb or server.cgi,
273             and hit methods served by calc.rb.
274             To run the client;
275 <pre class="path">
276 $ ./client.rb
277 </pre>
278             Is it stacked?  Did you run the server.rb?<br/>
279             Turn logger and wireDumpDev in its source on to see logs and wire
280             dumps of SOAP transport.
281           </dd>
282           <dt>calc2.rb</dt>
283           <dd>Calc server definition using class and instance methods.
284             An instance of this class holds its value.  Methods 'set' and 'get'
285             is to set/get the value.
286             It also responds to '+', '-', '*', and '/'.
287           </dd>
288           <dt>server2.rb</dt>
289           <dd>It requires calc2.rb and creates an instance of CalcService2
290             that responds all SOAP requests.
291             Since '+', '-' and so on of calc2.rb are not valid name as an
292             element in XML instance, this sample register the method '+' as
293             'add', '-' as 'sub', and so on.
294           </dd>
295           <dt>server2.cgi</dt>
296           <dd>CGI version.
297             To run this server, copy server2.cgi and calc2.rb to suitable
298             directory of your WWW server.
299           </dd>
300           <dt>client2.rb</dt>
301           <dd>It connects to server2.rb or server2.cgi.
302             Set a value at first and call methods like 'puts objAtServer + 2'.
303           </dd>
304         </dl>
305       </dd>
306
307       <dt class="path">exchange/</dt>
308       <dd>A sample to retrieve the currency rate from public SOAP service.
309         <dl>
310           <dt>iExchange.rb</dt>
311           <dd>It includes common definitions for client and server of
312             Exchange service.  Including only a definition of namespace URI of
313             this service.</dd>
314           <dt>exchange.rb</dt>
315           <dd>Definition of servant class ExchangeService which returns the
316             currency rate after connecting to another site by SOAP to get the
317             real rate.
318             So that this class is the SOAP server for local client and
319             is also a SOAP client for public server.
320             An instance of this class is hosted by server.rb.
321             The instance responds to only 'getRate' which receives two country
322             code such as 'USA' and 'Japan'.</dd>
323           <dt>server.rb</dt>
324           <dd>It requires exchange.rb and creates an instance of
325             ExchangeService that responds all SOAP requests.
326             To run this server;
327 <pre class="path">
328 $ ./server.rb
329 </pre>
330           </dd>
331           <dt>server.cgi</dt>
332           <dd>CGI version.  To run this server, copy server.cgi and exchange.rb
333             to suitable directory of your WWW server.</dd>
334           <dt>client.rb</dt>
335           <dd>It connects to server.rb.  Turn logger and wireDumpDev in its
336             source on to see logs and wire dumps of SOAP transport.
337             To run the client;
338 <pre class="path">
339 $ ./client.rb
340 </pre>
341           </dd>
342         </dl>
343       </dd>
344
345       <dt class="path">sampleStruct/</dt>
346       <dd>A sample to transmit complex structured object which has recursive
347         object reference.
348         <dl>
349           <dt>iSampleStruct.rb</dt>
350           <dd>It includes common definitions for client and server of
351             SampleStruct service.  Definition of SampleStruct class and
352             namespace URI of this service.</dd>
353           <dt>sampleStruct.rb</dt>
354           <dd>Definition of servant class SampleStructService.
355             An instance of this class is hosted by server.rb.
356             The instance responds to only 'hi' which receives a SampleStruct
357             and wraps it in the new instance of SampleStruct to return .</dd>
358           <dt>server.rb</dt>
359           <dd>It requires sampleStruct.rb and creates an instance of
360             SampleStructService that responds all SOAP requests.
361             To run this server;
362 <pre class="path">
363 $ ./server.rb
364 </pre>
365           </dd>
366           <dt>server.cgi</dt>
367           <dd>CGI version.  To run this server, copy server.cgi and
368             sampleStruct.rb to suitable directory of your WWW server.</dd>
369           <dt>client.rb</dt>
370           <dd>It connects to server.rb.  Turn logger and wireDumpDev in its
371             source on to see logs and wire dumps of SOAP transport.
372             To run the client;
373 <pre class="path">
374 $ ./client.rb
375 </pre>
376           </dd>
377         </dl>
378       </dd>
379
380       <dt class="path">wsdl_helloworld/</dt>
381       <dd>A sample 'Hello World' SOAP client and server which utilize WSDL.
382       See wsdl_helloworld/README for more detail</dd>
383     </dl>
384
385 <h3><span class="content">payload/ ... various payload configuration</span></h3>
386
387     <dl>
388       <dt class="path">basicauth/</dt>
389       <dd>BasicAuth server and client sample.</dd>
390
391       <dt class="path">cookies/</dt>
392       <dd>HTTP-Cookies server and client sample.</dd>
393
394       <dt class="path">ssl/</dt>
395       <dd>SSL SOAP server and client samples.
396         <dl>
397           <dt class="path">sslserver.rb</dt>
398           <dd>SSL server sample which hosts "hello world" service.
399             This server uses SSL server certificate in files/ directory
400             (SSL client should check this certificate for SSL server
401             authentication).</dd>
402           <dt class="path">sslserver_noauth.rb</dt>
403           <dd>This server generates SSL server certificate
404             at runtime.  No security.</dd>
405           <dt class="path">sslserver_require_clientauth.rb</dt>
406           <dd>This server users SSL server certificate in files/ directory
407             and requires SSL client authentication (clients must
408             have SSL client certificate and send it to the server).</dd>
409           <dt class="path">sslclient.rb</dt>
410           <dd>SSL client sample which calls "hello world" service via HTTPS.
411             This client checks SSL server certificate sent from SSL server.</dd>
412           <dt class="path">sslclient_require_noserverauth.rb</dt>
413           <dd>This client does not check SSL server certificate.
414             No security.</dd>
415           <dt class="path">sslclient_with_clientauth.rb</dt>
416           <dd>This client sends SSL client certificate in files/ directory
417             and checks SSL server certificate.</dd>
418         </dl>
419       </dd>
420
421       <dt class="path">gzipped/</dt>
422       <dd>gzipped content negotiation server and client sample.</dd>
423     </dl>
424
425 <h3><span class="content">soapheader/ ... SOAPHeader configuration</span></h3>
426
427     <dl>
428       <dt class="path">authheader/</dt>
429       <dd>It contains a sample to utilize SOAP Header handler.  Send
430         userid/passwd and receive sessionid via SOAP Header</dd>
431
432       <dt class="path">soapext_basicauth/</dt>
433       <dd>It contains a sample to do BasicAuth in SOAPHeader.  (http://soap-authentication.org/basic/2001/10/)</dd>
434     </dl>
435
436 <h3><span class="content">attachment/ ... SOAP with Attachment (SwA)</span></h3>
437
438     <dl>
439       <dt class="path">swa/</dt>
440       <dd>SOAP server and client sample of SwA (SOAP with Attachments).</dd>
441
442       <dt class="path">complexmime/</dt>
443       <dd>SOAP server and client sample of Complex Type + SwA</dd>
444     </dl>
445
446 <h3><span class="content">howto/ ... various other configuration</span></h3>
447
448     <dl>
449       <dt class="path">as_xml/</dt>
450       <dd>Sample client to send a request with XML, and receive a response as XML.</dd>
451
452       <dt class="path">base64/</dt>
453       <dd>Sample client to send/receive base64 data.</dd>
454
455       <dt class="path">documentliteral/</dt>
456       <dd>Sample client and server of document/literal service.  See README.txt in this directory to run this sample.</dd>
457
458       <dt class="path">filter/</dt>
459       <dd>Sample client and server of filtering request/response before sending/receiving.</dd>
460
461       <dt class="path">scopesample/</dt>
462       <dd>SOAP server sample which shows a different behavior of SOAP server scope settings; Request scope vs Application scope.
463         sample/soap/scopesample/servant.rb is a servant which holds push-ed
464         object that can be pop-ed afterward.
465         See sample/soap/scopesample/server.rb how to define a servant as
466         a Request scope servant or an Application scope servant.
467         Application scope servant works as we expected because the servant
468         object is living from beginning to the time server terminated.
469         In contrast, request scope servant(s) does not work because a servant
470         object is created for each request.
471       </dd>
472
473       <dt class="path">styleuse/</dt>
474       <dd>Sample client and server of SOAP style and use combination, especially rpc/literal and document/encoded.</dd>
475
476       <dt class="path">wsdl_fault/</dt>
477       <dd>Sample client and server of handling SOAP fault specified in a WSDL.  See wsdl_fault/README.txt for more detail.</dd>
478
479       <dt class="path">wsdl_hash/</dt>
480       <dd>Sample client and server of sending/receiving Hash struct defined in a WSDL.</dd>
481     </dl>
482
483 <h3><span class="content">marshal/ ... object &lt;-&gt; XML marshalling</span></h3>
484
485     <dl>
486       <dt class="path">digraph.rb</dt>
487       <dd>A sample of SOAP marshalling/unmarshalling.
488         It creates a digraph that contains multi-ref-ed nodes at first
489         and marshals this object to get serialized XML instance.
490         Then reads and unmarshals this XML instance to recover a object
491         which has the same links among nodes in the digraph.
492       </dd>
493
494       <dt class="path">customfactory.rb</dt>
495       <dd>Sample program for customizing mapping registry.</dd>
496
497       <dt class="path">enum/</dt>
498       <dd>Sample program to demonstrate how xsd2ruby.rb works.</dd>
499     </dl>
500
501 <h3><span class="content">showcase/ ... showcase sample to demonstrate</span></h3>
502
503     <dl>
504       <dt class="path">raa2.4/</dt>
505       <dd>sample/soap/raa2.4/sample.rb is a sample client to retrieve project
506         information on RAA.  It uses raaDriver.rb which is generated by
507         wsdl2ruby.rb from WSDL at
508         <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>.
509         You'll find wsdlDriver.rb in sample/wsdl/raa2.4/wsdlDriver.rb which
510         loads the WSDL at runtime to connect.</dd>
511
512       <dt class="path">icd/</dt>
513       <dd>A client for
514         <a href="http://www.iwebmethod.net/">Insider's Computer Dictionary Web Service</a>.
515         This service is implemented with ASP.NET so that it's also a sample of
516         a client which connects to ASP.NET.
517         CAUTION: this sample contains non-ascii chars in its source and dumped
518         results.
519         <dl>
520           <dt>IICD.rb</dt>
521           <dd>Class(type) definitions for this server.</dd>
522           <dt>icd.rb</dt>
523           <dd>Client implementation.  To run the client;
524 <pre class="path">
525 $ ./icd.rb
526 </pre>
527           </dd>
528         </dl>
529       </dd>
530
531       <dt class="path">googleSearch/</dt>
532       <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>
533
534       <dt class="path">amazon/</dt>
535       <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>
536
537       <dt class="path">noaa/</dt>
538       <dd>Sample client of National Weather Service digital weather forecast data service at http://weather.gov/</dd>
539
540       <dt class="path">raa2.4/</dt>
541       <dd>sample/wsdl/raa2.4/wsdlDriver.rb is a sample client to retrieve
542         project information on RAA.  It loads WSDL file
543         <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>
544         at <strong>runtime</strong>.
545         You'll find a sample client at sample/soap/raa2.4/sample.rb
546         which connects RAA using pre-generated service definitions
547         (not loads WSDL at runtime).</dd>
548
549       <dt class="path">googleAdwords/</dt>
550       <dd>Sample client of Google AdWords service. 
551         CAUTION: I don't have an account of AdWords so the sample code is NOT
552         tested.  Please tell me (nahi@ruby-lang.org) if you will get good/bad
553         result in communicating with AdWords Server.</dd>
554
555       <dt class="path">amazonEC/</dt>
556       <dd>Sample client of AWSECommerce service.
557         CAUTION: I don't have an account of AWSECommerce so the sample code is
558         NOT tested.  Please tell me (nahi@ruby-lang.org) if you will get
559         good/bad result in communicating with AWSECommerce Server.</dd>
560     </dl>
561
562 <p>
563 There are more samples in this directory.
564 </p>
565
566 <h2 id="resources" name="resources"><span class="content">7. Resources</span></h2>
567
568 <dl>
569 <dt class="path"><a href="http://dev.ctor.org/soap4r">soap4r project page</a></dt>
570 <dd>You can get the latest information and the latest development version of soap4r here.</dd>
571
572 <dt class="path"><a href="http://raa.ruby-lang.org/project/soap4r">[RAA:soap4r]</a></dt>
573 <dd>RAA meta information</dd>
574
575 <dt class="path"><a href="http://groups.google.com/group/soap4r">soap4r-ml on Google Groups</a></dt>
576 <dd>Feel free to join the list to ask any question and comment about soap4r.
577   You can browse messages archive.  Bear in mind that Google Groups is still
578   in [beta] stage.</dd>
579
580 <dt class="path">Subversion repository</dt>
581 <dd>Soap4r's svn repository is here: http://dev.ctor.org/svn/soap4r/ .
582   To checkout the latest soap4r module, try
583 <pre>
584 svn checkout http://dev.ctor.org/svn/soap4r/trunk soap4r
585 </pre>
586   CVS repository of soap4r which was located at cvs.ruby-lang.org is pending since 2004-05-27. </dd>
587 </dl>
588
589 <h2 id="history" name="history"><span class="content">8. History</span></h2>
590
591 <dl>
592 <dt>1.5.6 - Jun 14, 2007</dt>
593 <dd>Here are changes in 1.5.6 from 1.5.5.
594 <ul><li>SOAP/Ruby mapping
595 <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>)
596 </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>)
597 </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>)
598 </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>)
599 </li><li>let document/literal service proxy generated by
600 WSDLDriverFactory accept key-value pair array of array ([['k1', 'v1'],
601 ...]) 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>)
602 </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>)
603 </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>)
604 </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>)
605 </li><li>method overloading support. allow to define methods which have
606 same name and different signatures, and let Router invoke a method
607 according to SOAPAction. you need to define methods with different
608 SOAPAction. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/233" title="Method overloading and generated drivers (closed)">#233</a>)
609 </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>)
610 </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>)
611 </li><li>do not validate CES of String by default to avoid consuming
612 memory. let XML processor check it instead. (you can turn it on by
613 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>)
614 </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>)
615 </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>)
616 </li><li>defined omit element / xsi:nil="true" elemet control. nil
617 means xsi:nil="true" for encoded service and nil means element omission
618 for literal service. pass SOAPNil.new to pass xsi:nil="true" for
619 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>)
620 </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>)
621 </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>)
622 </li><li>SOAPElement.from_obj(obj): allow to set XML attribute. this
623 method is called when you pass a Hash or [['key1', 'value1'], ...] to
624 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>)
625 </li></ul></li></ul><ul><li>Payload
626 <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>)
627 </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>)
628 </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>)
629 </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>)
630 </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>)
631 </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>)
632 </li></ul></li></ul><ul><li>SOAP format
633 <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>)
634 </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>)
635 </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>)
636 </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>)
637 </li></ul></li></ul><ul><li>WSDL
638 <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>)
639 </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>)
640 </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>)
641 </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>)
642 </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>)
643 </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>)
644 </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>)
645 </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>)
646 </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>)
647 </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>)
648 </li><li>moved @@schema_* things in classdef definition generated by
649 wsdl2ruby.rb to mapping registry. Mapping registries for each classdef
650 are defined in independent file and required from driver and server.
651 NOTE: old classdef files should still work but it should be
652 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>)
653 </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>)
654 </li></ul></li></ul><ul><li>Samples
655 <ul><li>add a demo how to call from Excel a simple soap service running
656 in apache (sample/soap/mssoap/) Thanks, an 'anonymous contributor from
657 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>)
658 </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>)
659 </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>)
660 </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>)
661 </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>)
662 </li></ul></li></ul><ul><li>misc
663 <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>)
664 </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>)
665 </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>)
666 </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>)
667 </li></ul></li></ul><ul><li>Bug fixes
668 <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>,
669 <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>,
670 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/187" title="Axis enumerations and soap4r (closed)">#187</a>,
671 <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>,
672 <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>,
673 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/220" title="'.' in Method names produces an exception (closed)">#220</a>,
674 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/224" title="huge memory usage with the Ebay API (closed)">#224</a>,
675 <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>,
676 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/226" title="a problem about extraattr when using SOAP::SOAPHeaderItem (closed)">#226</a>,
677 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/228" title="@@schema_element does not work in rpc service (closed)">#228</a>,
678 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/229" title="Incorrect obj2soap mapping (Case-Sensitivity) (closed)">#229</a>,
679 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/230" title="arrayType default namespace seems wrong (closed)">#230</a>,
680 <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>,
681 <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>,
682 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/242" title="handling anonymous class crashes under Ruby/1.9 (closed)">#242</a>,
683 <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>,
684 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/268" title="Allow safe method names with =, ?, !, or self. (closed)">#268</a>,
685 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/289" title="unqualified element generated from Hash parameter (closed)">#289</a>,
686 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/302" title="soap4r will redefine &quot;class&quot; (closed)">#302</a>,
687 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/311" title="Bad extraattr in Envelope, Body and Header (closed)">#311</a>,
688 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/312" title="Generator not working with HeaderItem childs. (closed)">#312</a>,
689 <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>,
690 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/328" title="xsd:date + WSDL generated stub (closed)">#328</a>,
691 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/333" title="[PATCH] MappingRegistryCreator missing require (closed)">#333</a>,
692 <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>
693 </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>,
694 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/215" title="improved end-of-line handling withing MIME messages (closed)">#215</a>,
695 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/236" title="netHttpClient.rb + no_proxy bug (closed)">#236</a>,
696 <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>
697 </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>
698 </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>,
699 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/152" title="add_elements2stubobj -- elename may not be set (closed)">#152</a>,
700 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/158" title="wsdl2ruby fails to generate a class definition (closed)">#158</a>,
701 <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>,
702 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/163" title="WSDL2Ruby generates module definition for simpleType enumeration twice (closed)">#163</a>,
703 <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>,
704 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/170" title="wsdl2ruby.rb cannot handle WSDL using soapenc:* types (closed)">#170</a>,
705 <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>,
706 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/189" title="WSDLLiteralRegistry wrongly decodes empty string and nil to  ... (closed)">#189</a>,
707 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/191" title="Problem with the documentliteral/echo.wsdl (closed)">#191</a>,
708 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/194" title="extending types seems to confuse wsdl2rb (closed)">#194</a>,
709 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/199" title="Abstract WSDL definition(no binding) causes NameError (closed)">#199</a>,
710 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/201" title="undefined method `namespace' for nil:NilClass (NoMethodError) from  ... (closed)">#201</a>,
711 <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>,
712 <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>,
713 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/216" title="Case-Sensitivity in WSDL Driver (closed)">#216</a>,
714 <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>,
715 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/231" title="classDefCreator fails with simpleContent extension (closed)">#231</a>,
716 <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>,
717 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/239" title="Possible patch to wsdl/soap/mappingRegistryCreator.rb (closed)">#239</a>,
718 <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>,
719 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/245" title="schema import location is not inherited (closed)">#245</a>,
720 <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>,
721 <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>,
722 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/258" title="PayPal WSDL generates an error (closed)">#258</a>,
723 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/260" title="'form=&quot;unqualified&quot;' (closed)">#260</a>,
724 <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>,
725 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/263" title="patch for #262 (closed)">#263</a>,
726 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/267" title="Missing 'wsdl/soap/literalMappingRegistryCreator' in driverCreator.rb (closed)">#267</a>,
727 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/271" title="wsdl2ruby.rb generates duplicated class definitions (closed)">#271</a>,
728 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/272" title="choice definition breakage in encoded service (closed)">#272</a>,
729 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/273" title="wsdl2ruby.rb --classdef argument not explained in usage (closed)">#273</a>,
730 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/275" title="problem with receiving subclasses using wsdl2ruby (closed)">#275</a>,
731 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/284" title="wsdl2rb produces incomplete mapping (closed)">#284</a>,
732 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/285" title="illegal mapping definition about a type 'xsd:schema' (closed)">#285</a>,
733 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/300" title="Problem in Port Init (closed)">#300</a>,
734 <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>,
735 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/306" title="String subclass is generated wrongly from simpleContent (closed)">#306</a>,
736 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/309" title="Bug in complexContent.rb (closed)">#309</a>,
737 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/313" title="wsdl2ruby exception with Google Adwords AdService.xml (closed)">#313</a>,
738 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/317" title="value cannot be resolved (closed)">#317</a>,
739 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/322" title="xsd2ruby generates BadURIError (closed)">#322</a>,
740 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/325" title="part: value cannot be resolved (RuntimeError) (closed)">#325</a>,
741 <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>,
742 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/327" title="wsdl2ruby: fatal - undefined method `namespace' for  ... (closed)">#327</a>,
743 <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>,
744 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/337" title="wsdl2ruby produces code that overrides system classes (closed)">#337</a>,
745 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/342" title="EncodingStyle not supported (closed)">#342</a>,
746 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/344" title="ref + min/maxOccurs does not work (closed)">#344</a>,
747 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/348" title="XSD::ValueSpaceError when SOAP response contains empty elements (closed)">#348</a>,
748 <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>,
749 <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>,
750 <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>
751 </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>,
752 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/192" title="GoogleAdwords Sample doesn't work (closed)">#192</a>,
753 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/251" title="typo: 'depricated' in wsdlDriver.rb (closed)">#251</a>,
754 <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>,
755 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/282" title="wsdl2ruby.rb argument order dependency (closed)">#282</a>,
756 <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/329" title="property file and non UTF-8 encoding chars (closed)">#329</a>
757 </li></ul></li></ul>
758 </dd>
759
760 <dt>1.5.5 - Sep 15, 2005</dt>
761 <dd> Here are changes in 1.5.5 from 1.5.4.
762 <ul><li>SOAP
763 <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>)
764 <pre class="wiki">TemporaryNamespace = 'http://www.w3.org/2003/05/soap-envelope'
765 @client.options[&#34;soap.envelope.requestnamespace&#34;] = TemporaryNamespace
766 @client.options[&#34;soap.envelope.responsenamespace&#34;] = TemporaryNamespace
767 @client.do_proc(...)
768 </pre>
769 </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>)
770
771 </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>)
772 <pre class="wiki">external CES ::= CES used in Ruby object of client and server
773 internal CES ::= CES used in SOAP/OM
774 </pre>
775 </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>)
776 </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>)
777 </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>)
778 </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>)
779
780 </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>)
781 </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>)
782 </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>)
783 </li></ul></li><li>WSDL
784 <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>)
785 </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>)
786
787 </li><li>re-implemented local element qualify/unqual