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

root/tags/RELEASE_1_3_5/RELEASE_en.html

Revision 266, 18.0 kB (checked in by nakahiro, 7 years ago)

Documents for 1.3.5.

  • Property svn:eol-style set to native
  • Property svn:executable set to *
  • 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=ISO-8859-1" />
8 <meta http-equiv="Content-Style-Type" content="text/css" />
9 <link rev="MADE" href="mailto:nakahiro@sarion.co.jp" />
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: July 14, 2001<br />
22 Created: July 17, 2000
23 </p>
24 </div>
25
26 <hr />
27
28 <div class="main">
29 <h2>0. In this document...</h2>
30
31 <p>
32 This is Release Notes of SOAP4R.
33 </p>
34
35 <p>
36 Target SOAP4R version: SOAP4R/1.3.5
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="#restrictions">Restrictions</a></li>
46 <li><a href="#history">History</a></li>
47 <li><a href="#author">Author</a></li>
48 <li><a href="#copyright">Copyright</a></li>
49 </ol>
50
51 <h2 id="changes" name="changes">1. Changes</h2>
52
53 <p>
54 Many feedbacks from Michael Neumann.
55 I much appreciate valuable comments to him.
56 Thanks!
57 </p>
58
59 <ul>
60 <li>Changed using URI library: uri -&gt; URb.</li>
61 <li>Types changed:
62   <ul>
63     <li>All: Triming data except XSDString before parsing it.</li>
64     <li>String: Regexp for XML Char check did not work under $KCODE = 'UTF8' condition.  Fixed.</li>
65     <li>Nil: 2001xsd:nil must not accept a value '1'.  1999xsd:null must not accept a value 'true' because these are not a boolean but only a flag for nil.  Fixed.</li>
66   </ul>
67 </li>
68
69 <li>Supported XML parser:
70   <ul>
71     <li>Added automatic CES conversion support for NQXMLParser.
72         (Depends on uconv module).
73         Set $KCODE for regexps used in NQXML parser.</li>
74     <li>Moved SOAPNQXML*Parser to nqxmlparser.rb.</li>
75   </ul>
76 </li>
77
78 <li>RPC related functions changed:</li>
79   <ul>
80     <li>Added marshalling/unmarshalling Ruby's object using SOAP Encoding.</li>
81     <li>Parallelize of signatures of 'addMethod': proxy.rb &lt;-&gt; rpcRouter.rb, driver.rb &lt;-&gt; cgistub.rb.</li>
82     <li>Void return if 'retval' is not defined.</li>
83     <li>Added SOAP's Long type to default mapping table.</li>
84   </ul>
85 </li>
86 </ul>
87
88 <h2 id="install" name="install">2. Install</h2>
89
90 <p>
91 Simply, get the archived file and extract it.  Then, try;
92 </p>
93
94 <pre>
95 &quot;ruby install.rb&quot;
96 </pre>
97
98 <p>
99 Necessary files will be installed to suitable directory.
100 </p>
101
102 <p>
103 Files in lib/soap directory are SOAP4R library program itself.
104 Followings are redistributed files in redist/.
105 </p>
106
107 <dl>
108 <dt class="path">date3.rb</dt>
109 <dd>by Funaba-san (<a href="http://www.kt.rim.or.jp/~tadf/ruby-en.html">http://www.kt.rim.or.jp/~tadf/ruby-en.html</a>)</dd>
110
111 <dt class="path">parsedate3.rb</dt>
112 <dd>by Funaba-san (<a href="http://www.kt.rim.or.jp/~tadf/ruby-en.html">http://www.kt.rim.or.jp/~tadf/ruby-en.html</a>)</dd>
113
114 <dt class="path">URb</dt>
115 <dd>by akira yamada-san: <a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=URb">[RAA:URb]</a></dd>
116 </dl>
117
118 <p>
119 Files in archive:
120 </p>
121
122 <dl>
123 <dt class="path">lib/soap/</dt>
124 <dd>SOAP4R library program.</dd>
125
126 <dt class="path">test/</dt>
127 <dd>Clients/Server for
128 <a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
129 Because of no documents or &quot;How-to&quot; things there,
130 test/interopR2/server.cgi is a must RPC Server side sample to check.
131 test/interopR2/client*.rb is a must RPC Client side sample to check.
132 test/interopR2/base.rb includes common definitions for client/server side.
133 </dd>
134
135 <dt class="path">sample/</dt>
136 <dd>Sample program using SOAP4R.</dd>
137
138 <dt class="path">sample/apacheClient.rb</dt>
139 <dd>SOAP-RPC client sample.
140 It connects with demonstration server programs stockquote and addressbook in Apache-SOAP.
141 You have to install Apache-SOAP and deploy demostration programs.<br />
142 To execute;
143 <pre class="path">
144 ./apacheClient.rb http://localhsot:2020/xml-soap/rpcrouter/rpcrouter.jsp
145 </pre>
146 </dd>
147
148 <dt class="path">sample/RAA/*</dt>
149 <dd>SOAP-RPC client samples.
150 <ul>
151 <li>soap4r.rb, soap4rApp.rb: Ruby program using SOAP4R</li>
152 <li>xmlrpc4r.rb: Ruby program using xmlrpc4r</li>
153 <li>pocketSOAP.js: JScript program using pocketSOAP</li>
154 <li>SOAP::Lite.pl: Perl program using SOAP::Lite for Perl</li>
155 </ul>
156 There programs connect with testing RAA server on www.ruby-lang.org.
157 Since the server is under testing phase so stable operation is not expected.</dd>
158
159 <dt class="path">redist/</dt>
160 <dd>Redistributed programs which SOAP4R is using.
161 I would appriciate to authors of these programs.
162 </dd>
163
164 <dt class="path">redist/archive/</dt>
165 <dd>Archives.
166 Follow the term of each archive to use these programs.
167 </dd>
168 </dl>
169
170 <h2 id="uninstall" name="uninstall">3. Uninstall</h2>
171
172 <p>
173 Delete created files at installation.
174 </p>
175
176 <pre>
177 ruby -rrbconfig -e 'include Config; puts CONFIG[&quot;sitedir&quot;] + &quot;/&quot; + CONFIG[&quot;MAJOR&quot;] + &quot;.&quot; + CONFIG[&quot;MINOR&quot;]'
178 </pre>
179
180 <p>
181 should dump the installation root directory.
182 Here, check &quot;soap&quot; directory and filename of files in &quot;redist&quot; directory.
183 </p>
184
185 <h2 id="whats" name="whats">4. What is SOAP4R?</h2>
186
187 <p>
188 'SOAP4R' is a Ruby library program to handle
189 <a href="http://www.w3.org/TR/SOAP/">Simple Object Access Protocol (SOAP) 1.1 (W3C Note)</a>.
190 </p>
191
192 <p>
193 Comments, information such as interoperability between SOAP4R and another implementation are welcomed.
194 Feel free sending mail to
195 <a href="mailto:nakahiro@sarion.co.jp" class="path">nakahiro@sarion.co.jp</a>.
196 </p>
197
198 <h2 id="dependencies" name="dependencies">5. Dependencies</h2>
199
200 <p>
201 SOAP4R depends on below programs:
202 </p>
203
204 <ul>
205 <li>SOAP4R is a
206 <a href="http://www.ruby-lang.org">Ruby</a>
207 library program.
208 You have to install Ruby itself.
209 Ruby/1.6 series are required.
210 It does not works on 1.4 series because of class variable.</li>
211
212 <li>SOAP4R delegates XML related processing to
213 <a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=NQXML">NQXML module</a>.
214 You have to install NQXML module.</li>
215
216 <li>To play with SOAP-RPC client sample, you have to install
217 <a href="http://xml.apache.org/soap/">Apache SOAP</a>.
218 </li>
219 </ul>
220
221 <h2 id="restrictions" name="restrictions">6. Restrictions</h2>
222
223 <p>
224 The following features of the
225 <a href="http://www.w3.org/TR/SOAP/">SOAP 1.1 (W3C Note)</a>
226 spec are <strong>NOT</strong> currently supported:
227 </p>
228
229 <ul>
230 <li style="margin-top: 2ex;">SOAP Envelope
231 <ul>
232 <li>SOAP actor attribute</li>
233 <li>SOAP mustUnderstand attribute</li>
234 <li>SOAP Fault Codes</li>
235 </ul></li>
236 <li style="margin-top: 2ex;">SOAP Encoding
237 <ul>
238 <li>encoding/decoding using XML Schema;
239 Only xsi:type in SOAP Encoding is checked</li>
240 <li>Marshalling references to href/id (Unmarshalling is OK)</li>
241 </ul></li>
242 <li style="margin-top: 2ex;">Othres
243 <ul>
244 <li>Transport binding except HTTP server(CGI) and client</li>
245 <li>HTTP Extension Framework (M-POST)</li>
246 </ul></li>
247 </ul>
248
249 <h2 id="history" name="history">7. History</h2>
250
251 <dl>
252 <dt>1.3.5 - July 14, 2001</dt>
253 <dd>Many feedbacks from Michael Neumann.
254 I much appreciate valuable comments to him.
255 Thanks!
256
257 <ul>
258 <li>Changed using URI library: uri -&gt; URb.</li>
259 <li>Types changed:
260   <ul>
261     <li>All: Triming data except XSDString before parsing it.</li>
262     <li>String: Regexp for XML Char check did not work under $KCODE = 'UTF8' condition.  Fixed.</li>
263     <li>Nil: 2001xsd:nil must not accept a value '1'.  1999xsd:null must not accept a value 'true' because these are not a boolean but only a flag for nil.  Fixed.</li>
264   </ul>
265 </li>
266
267 <li>Supported XML parser:
268   <ul>
269     <li>Added automatic CES conversion support for NQXMLParser.
270         (Depends on uconv module).
271         Set $KCODE for regexps used in NQXML parser.</li>
272     <li>Moved SOAPNQXML*Parser to nqxmlparser.rb.</li>
273   </ul>
274 </li>
275
276 <li>RPC related functions changed:</li>
277   <ul>
278     <li>Added marshalling/unmarshalling Ruby's object using SOAP Encoding.</li>
279     <li>Parallelize of signatures of 'addMethod': proxy.rb &lt;-&gt; rpcRouter.rb, driver.rb &lt;-&gt; cgistub.rb.</li>
280     <li>Void return if 'retval' is not defined.</li>
281     <li>Added SOAP's Long type to default mapping table.</li>
282   </ul>
283 </li>
284 </ul></dd>
285
286 <dt>1.3.4.2 - July 11, 2001</dt>
287 <dd>SOAP4R/1.3.4 was once packed in July 10, 2001.
288 But, thanks to MNeumann and knu,
289 I found I had forgotten to pack 'redist' directory with it.
290 I added some fix from developing version and repack it as 1.3.4.2.
291 Sorry for frequently release...
292 <br/><br/>
293
294 Feedback from
295 <a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
296 and Michael Neumann.  Thanks!
297
298 <ul>
299 <li>Added in 1.3.4.2:
300   <ul>
301     <li>Type Decimal: Silly bug fixed.  0.0001 was converted to 0.1</li>
302     <li>CGIStub returns HTTP status 500 when returning SOAP Fault.
303         Returned 200 because I don't like this spec., but SOAP/1.2 W3C WD
304         9 July 2001 have adopted it.  Hmm...</li>
305     <li>RPC client(driver.rb): Exception#set_backtrace was omitted when transmitting exception by SOAP Fault.</li>
306   </ul>
307 </li>
308 <li>Types changed:
309   <ul>
310     <li>Array: Incomplete sparse array support.  Fixed.</li>
311     <li>Date: Added.</li>
312     <li>Time: Added.</li>
313     <li>DateTime: Added precision of time support.</li>
314     <li>String: Default data should not be nil but ''.</li>
315     <li>Nil: Attribute value of xsi:nil might be '1' instead of 'true'.  Fixed.</li>
316   </ul>
317 </li>
318
319 <li>Supported XML parser:
320   <ul>
321     <li>Added SOAPXMLParser and SOAPSAXDriver for XMLParser which uses expat.
322         You can get the module from RAA: <a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=XMLParser">XMLParser module</a>.<br/>
323         To use XMLParser -&gt; add &quot;require 'soap/xmlparser'&quot;.<br/>
324         To use SAX driver of XMLParser -&gt; add &quot;require 'soap/saxdriver'&quot;.<br/>
325         To use NQXMLParser -&gt; nothing to do.<br/>
326         FYI:
327         <ul>
328           <li>XMLParser version is faster than others</li>
329           <li>SAXDriver version is extremely slow</li>
330           <li>NQXMLParser version is somewhat slower than XMLParser version</li>
331           <li>XMLParser is a Ruby extension module; To use it, you must compile and install it.</li>
332           <li>So far, automatic code conversion support is for XMLParser and SAXDriver.  See below.</li>
333         </ul>
334     </li>
335     <li>Added automatic CES conversion support: UTF-8 &lt;-&gt; EUC, SJIS.
336         Requires Uconv module.  Works with XMLParser module only now.</li>
337     <li>Added XMLDecl for CES.</li>
338   </ul>
339 </ul></dd>
340
341 <dt>1.3.3 - July 4, 2001</dt>
342 <dd>Feedback from
343 <a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
344 and Michael Neumann.  Thanks!
345 <ul>
346 <li>Added SOAP4R Installer by Michael Neumann.  Thanks!</li>
347 <li>Types changed:
348   <ul>
349     <li>Boolean: Accepts 1 and 0 in addition to true and falue.</li>
350     <li>Float: handles single-precision 32-bit floating point.
351         Ruby's float is doule-precision.</li>
352     <li>Double: Added.  Mapped to Ruby's Float.</li>
353     <li>DateTime: Added TZ support.</li>
354     <li>Long: Added.</li>
355     <li>Int: Changed class hierarchy; derived from Long now.</li>
356     <li>Array: Added 'position' and 'offset' support.</li>
357     <li>Array: Added M-D Array support.</li>
358     <li>Decimal: Added but it's incomplete now.</li>
359   </ul>
360 </li>
361 <li>Illegal error message when a type not found in SOAP-ENC.</li>
362 <li>Tries to transmit \r safely.  To be checked...</li>
363 <li>Parse Fault items like 'faultcode' as same as Body ie. href/id.</li>
364 <li>rpcUtils.rb was completely re-written.
365   <ul>
366     <li>Added mappingRegistry interface.</li>
367     <li>Changed soap2obj and obj2soap's interface.</li>
368     <li>Bignum might be int or integer.  It's dependent on platform.
369         Changed to check range  -2147483648~+2147483647 itself.</li>
370     <li>ary2md: Added.  Converting Array ((of Array)...) to M-D Array.</li>
371     <li>struct2obj: Illegal dependency on ordering of Struct#members.  Fixed.</li>
372     <li>Ruby's Array should be converted to SOAP's Array of anyType.  Fixed.</li>
373   </ul>
374 </li>
375 <li>Dump HTTP header even when an error was raised.</li>
376 </ul></dd>
377
378 <dt>1.3.2 - June 21, 2001</dt>
379 <dd>Feedback from
380 <a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
381
382 <ul>
383 <li>&quot;nil='1'&quot; should be &quot;nil='true'&quot; in 2001 schema
384 whereas &quot;null='1'&quot; in 1999 schema.  Fixed.</li>
385 <li>SOAP Array was not typed with xsi:type.</li>
386 <li>Fixed serialization root handling algorithm.</li>
387 <li>Supported kind of SOAP-ENC:String style typed element.</li>
388 <li>Default namespace was not derived to child element.  Fixed.</li>
389 <li>Support default encodingStyle.</li>
390 <li>Added support for void type (SOAP::RPCUtils::SOAPVoid).</li>
391 </ul></dd>
392
393 <dt>1.3.1 - May 30, 2001</dt>
394 <dd>Feedback from
395 <a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
396
397 <ul>
398 <li>Heading and trailing whtespaces in Base64 string could not be processed.  Fixed.</li>
399 <li>Illegal typeNamespace of SOAP's base64 type.  Fixed.</li>
400 <li>Added NaN, INF, -INF support of Float type.</li>
401 <li>Extracted xsd:1999 type support to XMLSchemaDatatypes1999.rb.  Use it with 'require &quot;soap/XMLSchemaDatatypes1999&quot;'.</li>
402 <li>Added 'root' attribute support.</li>
403 <li>Return status 500 when Fault.</li>
404 </ul></dd>
405
406 <dt>1.3.0 - May 20, 2001</dt>
407 <dd><ul>
408 <li>Adopted
409 <a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=NQXML">NQXML module</a>
410 instead of XMLParser module extensively.
411 (You can implement your SOAP parser with XMLParser module.
412 See the last part of lib/soap/parser.rb)
413 <ul>
414 <li>Use NQXML's streamingParser or tokenizer instead of XMLParser's DOMParser for unmarshalling.</li>
415 <li>Use NQXML's document instead of XMLParser's DOM for marshalling.</li>
416 </ul></li>
417 <li>Passed major(?) part of inteoperability test in
418 <a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
419 See test/interop/README.txt.</li>
420 <li>Changed module namespace.  SOAPFoo -> SOAP::Foo.</li>
421 <li>Added float datatype support.</li>
422 <li>Changed dateTime marshalling format.  No timezone was added to marshalled string  because SOAP4R does not support timezone now.</li>
423 </ul></dd>
424
425 <dt>1.2.0 - March 30, 2001</dt>
426 <dd>Checked interoperability with
427 <a href="http://xml.apache.org/soap/">Apache-SOAP</a>,
428 <a href="http://www.pocketsoap.com">pocketSOAP/0.91</a>,
429 <a href="http://www.geocities.com/paulclinger/soap.html">SOAP::Lite for Perl</a>,
430 and <a href="http://www.develop.com/soap/">SOAP/Perl/0.28</a>.
431 It seems to work good except SOAP/Perl/0.28.
432
433 <ul>
434 <li>Added href/id unmarshalling support.
435 (href/id marshalling has not been supported yet)</li>
436 <li>Added SOAP's base64 type support.</li>
437 <li>SOAPTimeInstant -&gt; SOAPDateTime.  Following XML Schema PR.</li>
438 <li>SOAPStruct can have multiple accessor which have same name.
439 Should I separate it from original SOAPStruct?</li>
440 <li>Unknown attribute in Header Item raised an exception.  Omitted.</li>
441 <li>Router can handle methods which belong to different namespace.</li>
442 <li>Added an option to allow unqualified SOAP element.</li>
443 <li>Added Apache's Map type support.  Ruby's Hash are mapped to it now.
444 (Ruby's Hash marshalled by 1.1 processor in the old way can be unmarshalled,
445 but 1.2 processor marshals it in the new way and 1.1 processor does not
446 unmarshals it into Hash.  Incompatibility between SOAP4R/1.2 and 1.1)</li>
447 <li>Unknown type 'unknown:SOAPStruct' was incorrectly unmarshalled into SOAPStruct.  Fixed.</li>
448 <li>Added utility methods map! and members to SOAPArray and SOAPStruct.</li>
449 <li>Added methods request, response, and fault to SOAPBody.</li>
450 </ul></dd>
451
452 <dt>1.1.0 - March 23, 2001</dt>
453 <dd>Made many changes.
454 Since it is tested only for my limited use, please be careful to use.
455 Any comments especially "cannot connect to XXX implementation" are welcomed.
456 Feel free sending mail to
457 <a href="mailto:nakahiro@sarion.co.jp" class="path">nakahiro@sarion.co.jp</a>.
458
459 <ul>
460 <li>Added RPC server support.</li>
461 <li>Divided RPC client/server implementation from core.</li>
462 <li>Added Date, Hash type support. (Unknown type is converted to Struct as usual)</li>
463 <li>Adopted Date in date3.rb by Funaba-san instead of Time as TimeInstant.</li>
464 <li>Many encoding/decoding bugs around SOAPArray and SOAPStruct were fixed.</li>
465 </ul></dd>
466
467 <dt>1.0.2 - November 11, 2000</dt>
468 <dd>Since the previous package dated, refreshes some points.
469 <ul>
470 <li>Ruby: ruby 1.6.x</li>
471 <li>uri.rb: 4.22</li>
472 <li>sample: xml-soap/2.0</li>
473 </ul></dd>
474
475 <dt>1.0.1 - July 27, 2000</dt>
476 <dd>Handles SOAP/1.1 arrays.
477 1.0.0 cannot handles SOAP/1.1 arrays...
478 Bare in mind there still be many
479 <a href="#restrictions">restrictions</a>
480 around SOAP arrays.</dd>
481
482 <dt>1.0.0 - July 17, 2000</dt>
483 <dd>It is the initial released version of SOAP4R. :-)</dd>
484 </dl>
485
486 <h2 id="author" name="author">8. Author</h2>
487
488 <dl>
489 <dt>Name</dt>
490 <dd>NAKAMURA, Hiroshi (aka NaHi or nakahiro)</dd>
491
492 <dt>E-mail</dt>
493 <dd><a href="mailto:nakahiro@sarion.co.jp" class="path">nakahiro@sarion.co.jp</a></dd>
494
495 <dt>URL</dt>
496 <dd><a href="http://www.jin.gr.jp/~nahi/" class="path">http://www.jin.gr.jp/~nahi/</a> (Japanese)</dd>
497 </dl>
498
499 <h2 id="copyright" name="copyright">9. Copyright</h2>
500
501 <p style="text-align: center;">
502 SOAP4R<br />
503 Copyright &copy; 2000, 2001 NAKAMURA, Hiroshi.
504 </p>
505
506 <p>
507 This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
508 </p>
509
510 <p>
511 This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
512 See the GNU General Public License(the file named `COPYING') for more details.
513 </p>
514
515 <p>
516 You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
517 </p>
518
519 </div>
520
521 <hr />
522
523 <div class="footer">
524 <address>
525 <a href="http://www.jin.gr.jp/~nahi/Ruby/SOAP4R/">SOAP4R</a>.<br />
526 Copyright &copy; 2000, 2001
527 <a href="http://www.jin.gr.jp/~nahi/">NAKAMURA, Hiroshi</a>.
528 </address>
529 </div>
530 </body>
531 </html>
Note: See TracBrowser for help on using the browser.