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

root/tags/RELEASE_1_3_2/RELEASE_en.html

Revision 141, 12.3 kB (checked in by nakahiro, 7 years ago)

Document for 1.3.2

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