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

root/tags/RELEASE_1_3_3/RELEASE_en.html

Revision 184, 14.7 kB (checked in by nakahiro, 7 years ago)

Document for 1.3.3

  • 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: June 21, 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.3
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 Feedback from
55 <a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
56 and Michael Neumann.  Thanks!
57 </p>
58
59 <ul>
60 <li>Added SOAP4R Installer by Michael Neumann.  Thanks!</li>
61 <li>Types changed:
62   <ul>
63     <li>Boolean: Accepts 1 and 0 in addition to true and falue.</li>
64     <li>Float: handles single-precision 32-bit floating point.
65         Ruby's float is doule-precision.</li>
66     <li>Double: Added.  Mapped to Ruby's Float.</li>
67     <li>DateTime: Added TZ support.</li>
68     <li>Long: Added.</li>
69     <li>Int: Changed class hierarchy; derived from Long now.</li>
70     <li>Array: Added 'position' and 'offset' support.</li>
71     <li>Array: Added M-D Array support.</li>
72     <li>Decimal: Added but it's incomplete now.</li>
73   </ul>
74 </li>
75 <li>Illegal error message when a type not found in SOAP-ENC.</li>
76 <li>Tries to transmit \r safely.  To be checked...</li>
77 <li>Parse Fault items like 'faultcode' as same as Body ie. href/id.</li>
78 <li>rpcUtils.rb was completely re-written.
79   <ul>
80     <li>Added mappingRegistry interface.</li>
81     <li>Changed soap2obj and obj2soap's interface.</li>
82     <li>Bignum might be int or integer.  It's dependent on platform.
83         Changed to check range  -2147483648~+2147483647 itself.</li>
84     <li>ary2md: Added.  Converting Array ((of Array)...) to M-D Array.</li>
85     <li>struct2obj: Illegal dependency on ordering of Struct#members.  Fixed.</li>
86     <li>Ruby's Array should be converted to SOAP's Array of anyType.  Fixed.</li>
87   </ul>
88 </li>
89 <li>Dump HTTP header even when an error was raised.</li>
90 </ul>
91
92 <h2 id="install" name="install">2. Install</h2>
93
94 <p>
95 Simply, get the archived file and extract it.
96 Files in lib/soap are SOAP4R library program itself.
97 To use this library, copy the directory lib/soap as 'soap' to suitable directory and require it like 'require &quot;soap/...&quot;' since there is no installer yet.
98 </p>
99
100 <p>
101 To play with SOAP4R, you also have copy redistributed files below in redist/ to suitable directory.
102 </p>
103
104 <dl>
105 <dt class="path">date3.rb</dt>
106 <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>
107
108 <dt class="path">parsedate3.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">uri.rb</dt>
112 <dd>by Koshimizu-san (<a href="http://www02.so-net.ne.jp/~greentea/ruby/uri/">http://www02.so-net.ne.jp/~greentea/ruby/uri/</a>)</dd>
113 </dl>
114
115 <p>
116 Files in archive:
117 </p>
118
119 <dl>
120 <dt class="path">lib/soap/</dt>
121 <dd>SOAP4R library program.</dd>
122
123 <dt class="path">sample/</dt>
124 <dd>Sample program using SOAP4R.</dd>
125
126 <dt class="path">sample/apacheClient.rb</dt>
127 <dd>SOAP-RPC client sample.
128 It connects with demonstration server programs stockquote and addressbook in Apache-SOAP.
129 You have to install Apache-SOAP and deploy demostration programs.<br />
130 To execute;
131 <pre class="path">
132 ./apacheClient.rb http://localhsot:2020/xml-soap/rpcrouter/rpcrouter.jsp
133 </pre>
134 </dd>
135
136 <dt class="path">sample/apacheServer.rb</dt>
137 <dd>SOAP-RPC CGI server sample emulates Apache-SOAP sample such as AddressBook.
138 Interfaces such as getQuote and getAddressFromName are defined.
139 Only interfaces, no implementation.</dd>
140
141 <dt class="path">sample/RAA/*</dt>
142 <dd>SOAP-RPC client samples.
143 <ul>
144 <li>soap4r.rb, soap4rApp.rb: Ruby program using SOAP4R</li>
145 <li>xmlrpc4r.rb: Ruby program using xmlrpc4r</li>
146 <li>pocketSOAP.js: JScript program using pocketSOAP</li>
147 <li>SOAP::Lite.pl: Perl program using SOAP::Lite for Perl</li>
148 </ul>
149 There programs connect with testing RAA server on www.ruby-lang.org.
150 Since the server is under testing phase so stable operation is not expected.</dd>
151
152 <dt class="path">test/</dt>
153 <dd>Clients/Server for
154 <a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a></dd>
155
156 <dt class="path">redist/</dt>
157 <dd>Redistributed programs which SOAP4R is using.
158 I would appriciate to authors of these programs.
159 </dd>
160
161 <dt class="path">redist/archive/</dt>
162 <dd>Archives.
163 Follow the term of each archive to use these programs.
164 </dd>
165 </dl>
166
167 <h2 id="uninstall" name="uninstall">3. Uninstall</h2>
168
169 <p>
170 Delete created files at installation.
171 </p>
172
173 <h2 id="whats" name="whats">4. What is SOAP4R?</h2>
174
175 <p>
176 'SOAP4R' is a Ruby library program to handle
177 <a href="http://www.w3.org/TR/SOAP/">Simple Object Access Protocol (SOAP) 1.1 (W3C Note)</a>.
178 </p>
179
180 <p>
181 Comments, information such as interoperability between SOAP4R and another implementation are welcomed.
182 Feel free sending mail to
183 <a href="mailto:nakahiro@sarion.co.jp" class="path">nakahiro@sarion.co.jp</a>.
184 </p>
185
186 <h2 id="dependencies" name="dependencies">5. Dependencies</h2>
187
188 <p>
189 SOAP4R depends on below programs:
190 </p>
191
192 <ul>
193 <li>SOAP4R is a
194 <a href="http://www.ruby-lang.org">Ruby</a>
195 library program.
196 You have to install Ruby itself.
197 Ruby/1.6 series are required.
198 It does not works on 1.4 series because of class variable.</li>
199
200 <li>SOAP4R delegates XML related processing to
201 <a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=NQXML">NQXML module</a>.
202 You have to install NQXML module.</li>
203
204 <li>To play with SOAP-RPC client sample, you have to install
205 <a href="http://xml.apache.org/soap/">Apache SOAP</a>.
206 </li>
207 </ul>
208
209 <h2 id="restrictions" name="restrictions">6. Restrictions</h2>
210
211 <p>
212 The following features of the
213 <a href="http://www.w3.org/TR/SOAP/">SOAP 1.1 (W3C Note)</a>
214 spec are <strong>NOT</strong> currently supported:
215 </p>
216
217 <ul>
218 <li style="margin-top: 2ex;">SOAP Envelope
219 <ul>
220 <li>SOAP actor attribute</li>
221 <li>SOAP mustUnderstand attribute</li>
222 <li>SOAP Fault Codes</li>
223 </ul></li>
224 <li style="margin-top: 2ex;">SOAP Encoding
225 <ul>
226 <li>encoding/decoding using XML Schema;
227 Only xsi:type in SOAP Encoding is checked</li>
228 <li>Marshalling references to href/id (Unmarshalling is OK)</li>
229 </ul></li>
230 <li style="margin-top: 2ex;">Othres
231 <ul>
232 <li>Transport binding except HTTP server(CGI) and client</li>
233 <li>HTTP Extension Framework (M-POST)</li>
234 <li>Content-Type is 'text/xml';
235 Does not support 'charset='.
236 </li>
237 </ul></li>
238 </ul>
239
240 <h2 id="history" name="history">7. History</h2>
241
242 <dl>
243 <dt>1.3.3 - July 4, 2001</dt>
244 <dd>Feedback from
245 <a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
246 and Michael Neumann.  Thanks!
247 <ul>
248 <li>Added SOAP4R Installer by Michael Neumann.  Thanks!</li>
249 <li>Types changed:
250   <ul>
251     <li>Boolean: Accepts 1 and 0 in addition to true and falue.</li>
252     <li>Float: handles single-precision 32-bit floating point.
253         Ruby's float is doule-precision.</li>
254     <li>Double: Added.  Mapped to Ruby's Float.</li>
255     <li>DateTime: Added TZ support.</li>
256     <li>Long: Added.</li>
257     <li>Int: Changed class hierarchy; derived from Long now.</li>
258     <li>Array: Added 'position' and 'offset' support.</li>
259     <li>Array: Added M-D Array support.</li>
260     <li>Decimal: Added but it's incomplete now.</li>
261   </ul>
262 </li>
263 <li>Illegal error message when a type not found in SOAP-ENC.</li>
264 <li>Tries to transmit \r safely.  To be checked...</li>
265 <li>Parse Fault items like 'faultcode' as same as Body ie. href/id.</li>
266 <li>rpcUtils.rb was completely re-written.
267   <ul>
268     <li>Added mappingRegistry interface.</li>
269     <li>Changed soap2obj and obj2soap's interface.</li>
270     <li>Bignum might be int or integer.  It's dependent on platform.
271         Changed to check range  -2147483648~+2147483647 itself.</li>
272     <li>ary2md: Added.  Converting Array ((of Array)...) to M-D Array.</li>
273     <li>struct2obj: Illegal dependency on ordering of Struct#members.  Fixed.</li>
274     <li>Ruby's Array should be converted to SOAP's Array of anyType.  Fixed.</li>
275   </ul>
276 </li>
277 <li>Dump HTTP header even when an error was raised.</li>
278 </ul></dd>
279
280 <dt>1.3.2 - June 21, 2001</dt>
281 <dd>Feedback from
282 <a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
283
284 <ul>
285 <li>&quot;nil='1'&quot; should be &quot;nil='true'&quot; in 2001 schema
286 whereas &quot;null='1'&quot; in 1999 schema.  Fixed.</li>
287 <li>SOAP Array was not typed with xsi:type.</li>
288 <li>Fixed serialization root handling algorithm.</li>
289 <li>Supported kind of SOAP-ENC:String style typed element.</li>
290 <li>Default namespace was not derived to child element.  Fixed.</li>
291 <li>Support default encodingStyle.</li>
292 <li>Added support for void type (SOAP::RPCUtils::SOAPVoid).</li>
293 </ul></dd>
294
295 <dt>1.3.1 - May 30, 2001</dt>
296 <dd>Feedback from
297 <a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
298
299 <ul>
300 <li>Heading and trailing whtespaces in Base64 string could not be processed.  Fixed.</li>
301 <li>Illegal typeNamespace of SOAP's base64 type.  Fixed.</li>
302 <li>Added NaN, INF, -INF support of Float type.</li>
303 <li>Extracted xsd:1999 type support to XMLSchemaDatatypes1999.rb.  Use it with 'require &quot;soap/XMLSchemaDatatypes1999&quot;'.</li>
304 <li>Added 'root' attribute support.</li>
305 <li>Return status 500 when Fault.</li>
306 </ul></dd>
307
308 <dt>1.3.0 - May 20, 2001</dt>
309 <dd><ul>
310 <li>Adopted
311 <a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=NQXML">NQXML module</a>
312 instead of XMLParser module extensively.
313 (You can implement your SOAP parser with XMLParser module.
314 See the last part of lib/soap/parser.rb)
315 <ul>
316 <li>Use NQXML's streamingParser or tokenizer instead of XMLParser's DOMParser for unmarshalling.</li>
317 <li>Use NQXML's document instead of XMLParser's DOM for marshalling.</li>
318 </ul></li>
319 <li>Passed major(?) part of inteoperability test in
320 <a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
321 See test/interop/README.txt.</li>
322 <li>Changed module namespace.  SOAPFoo -> SOAP::Foo.</li>
323 <li>Added float datatype support.</li>
324 <li>Changed dateTime marshalling format.  No timezone was added to marshalled string  because SOAP4R does not support timezone now.</li>
325 </ul></dd>
326
327 <dt>1.2.0 - March 30, 2001</dt>
328 <dd>Checked interoperability with
329 <a href="http://xml.apache.org/soap/">Apache-SOAP</a>,
330 <a href="http://www.pocketsoap.com">pocketSOAP/0.91</a>,
331 <a href="http://www.geocities.com/paulclinger/soap.html">SOAP::Lite for Perl</a>,
332 and <a href="http://www.develop.com/soap/">SOAP/Perl/0.28</a>.
333 It seems to work good except SOAP/Perl/0.28.
334
335 <ul>
336 <li>Added href/id unmarshalling support.
337 (href/id marshalling has not been supported yet)</li>
338 <li>Added SOAP's base64 type support.</li>
339 <li>SOAPTimeInstant -&gt; SOAPDateTime.  Following XML Schema PR.</li>
340 <li>SOAPStruct can have multiple accessor which have same name.
341 Should I separate it from original SOAPStruct?</li>
342 <li>Unknown attribute in Header Item raised an exception.  Omitted.</li>
343 <li>Router can handle methods which belong to different namespace.</li>
344 <li>Added an option to allow unqualified SOAP element.</li>
345 <li>Added Apache's Map type support.  Ruby's Hash are mapped to it now.
346 (Ruby's Hash marshalled by 1.1 processor in the old way can be unmarshalled,
347 but 1.2 processor marshals it in the new way and 1.1 processor does not
348 unmarshals it into Hash.  Incompatibility between SOAP4R/1.2 and 1.1)</li>
349 <li>Unknown type 'unknown:SOAPStruct' was incorrectly unmarshalled into SOAPStruct.  Fixed.</li>
350 <li>Added utility methods map! and members to SOAPArray and SOAPStruct.</li>
351 <li>Added methods request, response, and fault to SOAPBody.</li>
352 </ul></dd>
353
354 <dt>1.1.0 - March 23, 2001</dt>
355 <dd>Made many changes.
356 Since it is tested only for my limited use, please be careful to use.
357 Any comments especially "cannot connect to XXX implementation" are welcomed.
358 Feel free sending mail to
359 <a href="mailto:nakahiro@sarion.co.jp" class="path">nakahiro@sarion.co.jp</a>.
360
361 <ul>
362 <li>Added RPC server support.</li>
363 <li>Divided RPC client/server implementation from core.</li>
364 <li>Added Date, Hash type support. (Unknown type is converted to Struct as usual)</li>
365 <li>Adopted Date in date3.rb by Funaba-san instead of Time as TimeInstant.</li>
366 <li>Many encoding/decoding bugs around SOAPArray and SOAPStruct were fixed.</li>
367 </ul></dd>
368
369 <dt>1.0.2 - November 11, 2000</dt>
370 <dd>Since the previous package dated, refreshes some points.
371 <ul>
372 <li>Ruby: ruby 1.6.x</li>
373 <li>uri.rb: 4.22</li>
374 <li>sample: xml-soap/2.0</li>
375 </ul></dd>
376
377 <dt>1.0.1 - July 27, 2000</dt>
378 <dd>Handles SOAP/1.1 arrays.
379 1.0.0 cannot handles SOAP/1.1 arrays...
380 Bare in mind there still be many
381 <a href="#restrictions">restrictions</a>
382 around SOAP arrays.</dd>
383
384 <dt>1.0.0 - July 17, 2000</dt>
385 <dd>It is the initial released version of SOAP4R. :-)</dd>
386 </dl>
387
388 <h2 id="author" name="author">8. Author</h2>
389
390 <dl>
391 <dt>Name</dt>
392 <dd>NAKAMURA, Hiroshi (aka NaHi or nakahiro)</dd>
393
394 <dt>E-mail</dt>
395 <dd><a href="mailto:nakahiro@sarion.co.jp" class="path">nakahiro@sarion.co.jp</a></dd>
396
397 <dt>URL</dt>
398 <dd><a href="http://www.jin.gr.jp/~nahi/" class="path">http://www.jin.gr.jp/~nahi/</a> (Japanese)</dd>
399 </dl>
400
401 <h2 id="copyright" name="copyright">9. Copyright</h2>
402
403 <p style="text-align: center;">
404 SOAP4R<br />
405 Copyright &copy; 2000, 2001 NAKAMURA, Hiroshi.
406 </p>
407
408 <p>
409 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.
410 </p>
411
412 <p>
413 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.
414 See the GNU General Public License(the file named `COPYING') for more details.
415 </p>
416
417 <p>
418 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.
419 </p>
420
421 </div>
422
423 <hr />
424
425 <div class="footer">
426 <address>
427 <a href="http://www.jin.gr.jp/~nahi/Ruby/SOAP4R/">SOAP4R</a>.<br />
428 Copyright &copy; 2000, 2001
429 <a href="http://www.jin.gr.jp/~nahi/">NAKAMURA, Hiroshi</a>.
430 </address>
431 </div>
432 </body>
433 </html>
Note: See TracBrowser for help on using the browser.