RELEASE_en.html

Revision 582, 42.1 kB (checked in by nahi, 6 years ago)
For 1.4.7
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: September 20, 2002<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.4.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="#restrictions">Restrictions</a></li>
47	<li><a href="#resources">Resources</a></li>
48	<li><a href="#history">History</a></li>
49	<li><a href="#author">Author</a></li>
50	<li><a href="#copyright">Copyright</a></li>
51	</ol>
52
53	<h2 id="changes" name="changes">1. Changes</h2>
54
55	<p>
56	This version has these enhancements and bug fixes;
57	</p>
58	<ul>
59	<li>Includes WSDL4R initial release.
60	<ul>
61	<li>Bare in mind this is an alpha level code.
62	I wrote it halfway at half and a year ago,
63	and wrote the rest part in half and a day.
64	No comprehensive test, no strict syntax check, unfriendly error message, etc.
65	Try it if you want, and find bugs in it.</li>
66	<li>WSDL4R can run under XMLParser for now.
67	You might be able to let it run under NQXML/REXML if you know SAX
68	programming well. How XML processor is used under WSDL4R
69	is as same as under SOAP4R.</li>
70	</ul></li>
71	<li>Added xsd:short support.</li>
72	<li>::Float(double precision float in Ruby) is mapped to xsd:double now.
73	It was mapped to xsd:float.</li>
74	<li>Fixed a bug of year < 0 handling. B.C. 1 => -0001 in XMLSchema.</li>
75	<li>Fixed a bug of exception serialization. Custam mappingRegistry was not used.</li>
76	<li>Fixed a bug of regex for MediaType parsing.</li>
77	</ul>
78
79	<p>
80	CAUTION: This version requires
81	<a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=date2">[RAA:date2]</a> version 3.2 or later and
82	<a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=http-access2">[RAA:http-access2]</a> version G.
83	http-access2/G is released in this week.
84	Please make sure the versions you use.
85	</p>
86
87	<h2 id="install" name="install">2. Install</h2>
88
89	<p>
90	At first, see <a href="#dependencies">Dependencies</a> section.
91	You may need to install some extra packages.
92	Next, get the archived file of SOAP4R and extract it, then simply try;
93	</p>
94	<pre class="path">
95	$ ruby install.rb
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">GServer</dt>
109	<dd>by John W. Small: <a href="http://fairfax2.laser.net/~jsmall/rubycorner.html">http://fairfax2.laser.net/~jsmall/rubycorner.html</a></dd>
110
111	<dt class="path">httpserver.rb</dt>
112	<dd>by Michael Neumann: httpserver.rb in <a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=XML-RPC">[RAA:XML-RPC]</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>SOAP4R samples.
125	See <a href="#samples">Samples</a> section.</dd>
126
127	<dt class="path">test/</dt>
128	<dd>Clients/Server for
129	<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
130	Followings are advanced examples to use complex type transmit,
131	sending base64 encoded string, multi-dimensional array, and so on.
132	<ul>
133	<li>test/interopR2/server.cgi is a RPC Server side implementation.</li>
134	<li>test/interopR2/client*.rb is a RPC Client side implementation.</li>
135	<li>test/interopR2/base.rb includes common definitions for client/server.</li>
136	</ul>
137	</dd>
138
139	<dt class="path">redist/</dt>
140	<dd>Redistributed modules which SOAP4R uses.
141	I would appriciate to authors of these programs.
142	</dd>
143
144	</dl>
145
146	<h2 id="uninstall" name="uninstall">3. Uninstall</h2>
147
148	<p>
149	To uninstall;
150	</p>
151
152	<pre class="path">
153	$ ruby uninstall.rb
154	</pre>
155
156	<p>
157	Of cource, modules listed at <a href="#dependencies">Dependencies</a>
158	which you may install are not uninstalled.
159	</p>
160
161	<h2 id="whats" name="whats">4. What is SOAP4R?</h2>
162
163	<p>
164	'SOAP4R' is an implementation of
165	<a href="http://www.w3.org/TR/SOAP/">Simple Object Access Protocol (SOAP) 1.1 (W3C Note)</a>.
166	</p>
167
168	<p>
169	Comments, information such as interoperability between SOAP4R and another implementation are welcomed.
170	Feel free sending mail to
171	<a href="mailto:nakahiro@sarion.co.jp" class="path">nakahiro@sarion.co.jp</a>.
172	</p>
173
174	<h2 id="dependencies" name="dependencies">5. Dependencies</h2>
175
176	<p>
177	SOAP4R is written in <a href="http://www.ruby-lang.org">Ruby</a> and
178	aims to use with Ruby application.
179	You have to install Ruby itself.
180	Ruby/1.6 series are required.
181	It does not works on 1.4 series because it does not have class variable.
182	</p>
183
184	<p>
185	SOAP4R depends on following Ruby modules in
186	<a href="http://www.ruby-lang.org/en/raa.html">RAA</a>.
187	You also have to install these modules to use SOAP4R.
188	</p>
189
190	<dl>
191	<dt class="path">XML processor</dt>
192	<dd>SOAP4R requires a XML processor package installed.
193	For now, one of following XML processor must be installed
194	(SOAP4R automatically detects it in runtime).
195	<ul>
196	<li><a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=NQXML">[RAA:NQXML]</a></li>
197	<li><a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=XMLParser">[RAA:XMLParser]</a></li>
198	<li><a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=REXML">[RAA:REXML]</a> version 2.1.3 or later</li>
199	</ul></dd>
200
201	<dt class="path"><a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=date2">[RAA:date2]</a> version 3.2 or later</dt>
202	<dd>Date and DateTime implementation by Todayoshi Funaba.
203	Note: This module is scheduled to be included in standard distribution instead of lib/date.rb. Ruby/1.7 or later.</dd>
204
205	<dt class="path"><a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=Devel%3A%3ALogger">[RAA:Devel::Logger]</a></dt>
206	<dd>Logging utility by NaHi.</dd>
207
208	<dt class="path"><a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=http-access2">[RAA:http-access2]</a> version G or later</dt>
209	<dd>Yet another HTTP client implementation by NaHi.</dd>
210
211	<dt class="path"><a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=Uconv">[RAA:Uconv]</a> (optional)</dt>
212	<dd>by Yoshida Masato.
213	It is requred when you want automatic CES conversion between
214	SJIS <-> UTF8 and EUC <-> UTF8.
215	Note: SJIS <-> EUC uses NKF module which is in standard distribution.
216	I will support Iconv for more conversion set.
217	</dd>
218
219	<dt class="path"><a href="http://www.ruby-lang.org/~knu/cgi-bin/cvsweb.cgi/rough/lib/uri/">uri module</a> (for Ruby/1.6.6 or earlier)</dt>
220	<dd>by Yamada Akira.
221	Uri module is bundled in Ruby/1.6.7, Ruby/1.7 or later.
222	To use SOAP4R under Ruby/1.6.6, get uri module above and install it.
223	</dd>
224
225	</dl>
226
227	<h2 id="samples" name="samples">6. Samples</h2>
228
229	<p>
230	Samples are in sample/ directory of distribution.
231	Some samples try to connect to public servers.
232	Set environment variable HTTP_PROXY if you are in a firewall and you have
233	http proxy to the internet like;
234	</p>
235	<pre class="path">
236	$ export HTTP_PROXY=http://myproxyserver:8080
237	or
238	$ setenv HTTP_PROXY http://myproxyserver:8080
239	</pre>
240
241	<dl>
242	<dt class="path">babelfish.rb</dt>
243	<dd>A client for
244	<a href="http://www.xmethods.com/ve2/ViewListing.po?serviceid=14">BabelFish</a>
245	which namespace URI is 'urn:xmethodsBabelFish'.
246	<pre class="path">
247	$ ./babelfish.rb "Text to translate" [ translation pattern like 'en_fr' ]
248	</pre>
249	</dd>
250
251	<dt class="path">whois.rb</dt>
252	<dd>A client for
253	<a href="http://www.xmethods.com/ve2/ViewListing.po?serviceid=34">SQLData's WHOIS</a>
254	which namespace URI is 'http://www.SoapClient.com/xml/SQLDataSoap.xsd'.
255	<pre class="path">
256	$ ./whois.rb ruby-lang.org
257	</pre>
258	CAUTION: This WhoIs server does not handle non-ascii characters correctly.
259	Querying domain which entry contains Japanese or so will hang. Gee.
260	</dd>
261
262	<dt class="path">digraph.rb</dt>
263	<dd>A sample of SOAP marshalling/unmarshalling.
264	It creates a digraph that contains multi-ref-ed nodes at first
265	and marshals this object to get serialized XML instance.
266	Then reads and unmarshals this XML instance to recover a object
267	which has the same links among nodes in the digraph.
268	</dd>
269
270	<dt class="path">apacheClient.rb</dt>
271	<dd>SOAP-RPC client sample which connects with demonstration server;
272	stockquote and addressbook in Apache-SOAP.
273	You have to install Apache-SOAP and deploy demostration programs.<br />
274	To execute;
275	<pre class="path">
276	$ ./apacheClient.rb http://localhsot:2020/xml-soap/rpcrouter/rpcrouter.jsp
277	</pre>
278	</dd>
279
280	<dt class="path">Calc/</dt>
281	<dd>Calc service contains 2 servers and 2 clients.
282	calc.rb is hosted by server.rb, calc2.rb is hosted by server2.rb.
283	client.rb is for server.rb, client2.rb is for server2.rb.
284	<dl>
285	<dt>calc.rb</dt>
286	<dd>Calc server definition using module and module methods.
287	This module responds 'add', 'sub', 'multi' and 'div'.</dd>
288	<dt>server.rb</dt>
289	<dd>Standalone server.
290	It requires calc.rb and serve module methods of this module.
291	To run this server;
292	<pre class="path">
293	$ ./server.rb
294	</pre>
295	</dd>
296	<dt>server.cgi</dt>
297	<dd>CGI version.
298	To run this server, copy server.cgi and calc.rb to suitable directory
299	of your WWW server.
300	</dd>
301	<dt>client.rb</dt>
302	<dd>It connects to server.rb or server.cgi,
303	and hit methods served by calc.rb.
304	To run the client;
305	<pre class="path">
306	$ ./client.rb
307	</pre>
308	Is it stacked? Did you run the server.rb?<br/>
309	Turn logger and wireDumpDev in its source on to see logs and wire dumps of
310	SOAP transport.</dd>
311
312	<dt>calc2.rb</dt>
313	<dd>Calc server definition using class and instance methods.
314	An instance of this class holds its value. Methods 'set' and 'get' is to
315	set/get the value.
316	It also responds to '+', '-', '*', and '/'.
317	</dd>
318	<dt>server2.rb</dt>
319	<dd>It requires calc2.rb and creates an instance of CalcService2
320	that responds all SOAP requests.
321	Since '+', '-' and so on of calc2.rb are not valid name as an element
322	in XML instance,
323	this sample register the method '+' as 'add', '-' as 'sub', and so on.
324	</dd>
325	<dt>server2.cgi</dt>
326	<dd>CGI version.
327	To run this server, copy server2.cgi and calc2.rb to suitable directory
328	of your WWW server.
329	</dd>
330	<dt>client2.rb</dt>
331	<dd>It connects to server2.rb or server2.cgi.
332	Set a value at first and call methods like 'puts objAtServer + 2'.</dd>
333	</dl>
334	</dd>
335
336	<dt class="path">Exchange/</dt>
337	<dd>A sample to retrieve the currency rate from public SOAP service.</dd>
338	<dl>
339	<dt>iExchange.rb</dt>
340	<dd>It includes common definitions for client and server of
341	Exchange service.
342	Including only a definition of namespace URI of this service.</dd>
343	<dt>exchange.rb</dt>
344	<dd>Definition of servant class ExchangeService which returns the currency rate
345	after connecting to another site by SOAP to get the real rate.
346	So that this class is the SOAP server for local client and
347	is also a SOAP client for public server.
348	An instance of this class is hosted by server.rb.
349	The instance responds to only 'getRate' which receives two country code
350	such as 'USA' and 'Japan'.</dd>
351	<dt>server.rb</dt>
352	<dd>It requires exchange.rb and creates an instance of ExchangeService
353	that responds all SOAP requests.
354	To run this server;
355	<pre class="path">
356	$ ./server.rb
357	</pre>
358	</dd>
359	<dt>server.cgi</dt>
360	<dd>CGI version.
361	To run this server, copy server.cgi and exchange.rb to suitable directory
362	of your WWW server.
363	</dd>
364	<dt>client.rb</dt>
365	<dd>It connects to server.rb.
366	Turn logger and wireDumpDev in its source on to see logs and wire dumps of
367	SOAP transport.
368	To run the client;
369	<pre class="path">
370	$ ./client.rb
371	</pre>
372	</dd>
373	</dl>
374	</dd>
375
376	<dt class="path">SampleStruct/</dt>
377	<dd>A sample to transmit complex structured object which has recursive
378	object reference.
379	<dl>
380	<dt>iSampleStruct.rb</dt>
381	<dd>It includes common definitions for client and server of
382	SampleStruct service.
383	Definition of SampleStruct class and namespace URI of this service.</dd>
384	<dt>sampleStruct.rb</dt>
385	<dd>Definition of servant class SampleStructService.
386	An instance of this class is hosted by server.rb.
387	The instance responds to only 'hi' which receives a SampleStruct and wraps
388	it in the new instance of SampleStruct to return .</dd>
389	<dt>server.rb</dt>
390	<dd>It requires sampleStruct.rb and creates an instance of SampleStructService
391	that responds all SOAP requests.
392	To run this server;
393	<pre class="path">
394	$ ./server.rb
395	</pre>
396	</dd>
397	<dt>server.cgi</dt>
398	<dd>CGI version.
399	To run this server, copy server.cgi and sampleStruct.rb to suitable directory
400	of your WWW server.
401	</dd>
402	<dt>client.rb</dt>
403	<dd>It connects to server.rb.
404	Turn logger and wireDumpDev in its source on to see logs and wire dumps of
405	SOAP transport.
406	To run the client;
407	<pre class="path">
408	$ ./client.rb
409	</pre>
410	</dd>
411	</dl>
412	</dd>
413
414	<dt class="path">RAA/</dt>
415	<dd>SOAP-RPC client samples.
416	These programs connect to RAA SOAP Interface on www.ruby-lang.org.
417	<ul>
418	<li>soap4r.rb: Ruby program using SOAP4R</li>
419	<li>xmlrpc4r.rb: Ruby program using xmlrpc4r</li>
420	<li>pocketSOAP.js: JScript program using pocketSOAP</li>
421	<li>SOAP::Lite.pl: Perl program using SOAP::Lite for Perl</li>
422	</ul>
423	Since the server is (still) under testing phase so stable operation is not expected.</dd>
424
425	<dt class="path">webrick/</dt>
426	<dd>SOAP-RPC server samples which runs with WEBrick.
427	<ul>
428	<li>httpd.rb: HTTP server which soaplet.rb mounts to.
429	It is powered by WEBrick so you must install
430	<a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=WEBrick">[RAA:WEBrick]</a>
431	to run it.</li>
432	<li>soaplet.rb: A bricklet to add a SOAP function to WEBrick.
433	It hosts exchange.rb, sampleStruct.rb below, and it is mounted to httpd.rb
434	to serve ExchangeService and SampleStructService.</li>
435	<li>ExchangeService
436	<dl>
437	<dt>exchange.rb</dt>
438	<dd>A server class definition which returns the currency rate
439	after connecting to another site by SOAP to get the real rate.
440	An instance of this class is instanciated in httpd.rb and this instance
441	respond to each HTTP request.</dd>
442	<dt>exchangeClient.rb</dt>
443	<dd>A client to connect soaplet.rb via SOAP/HTTP to call exchange.rb.</dd>
444	<dt>iExchange.rb</dt>
445	<dd>Common class(type) definitions for server and client.</dd>
446	</dl>
447	</li>
448
449	<li>SampleStructService
450	<dl>
451	<dt>sampleStruct.rb</dt>
452	<dd>A server class definition which wraps a given struct
453	and returns it.
454	An instance of this class is instanciated in httpd.rb and this instance
455	respond to each HTTP request.</dd>
456	<dt>sampleStructClient.rb</dt>
457	<dd>A client to connect soaplet.rb via SOAP/HTTP to call sampleStruct.rb</dd>
458	<dt>iSampleStruct.rb</dt>
459	<dd>Common class(type) definitions for server and client.</dd>
460	</dl></li>
461	</ul>
462	Run the server;
463	<pre class="path">
464	$ ruby httpd.rb
465	</pre>
466	Then, run clients;
467	<pre class="path">
468	$ ruby sampleStruct.rb
469	$ ruby exchangeClient.rb
470	</pre>
471	Set 'logger' and 'wireDumpDev' in clients to see log and wiredumps of SOAP.
472	</dd>
473
474	<dt class="path">ICD</dt>
475	<dd>A client for
476	<a href="http://www.iwebmethod.net/">Insider's Computer Dictionary Web Service</a>.
477	This service is implemented with ASP.NET so that it's also a sample of
478	a client which connects to ASP.NET.
479	CAUTION: this sample contains non-ascii chars in its source and dumped results.
480	<dl>
481	<dt>IICD.rb</dt>
482	<dd>Class(type) definitions for this server.</dd>
483	<dt>icd.rb</dt>
484	<dd>Client implementation. To run the client;
485	<pre class="path">
486	$ ./icd.rb
487	</pre>
488	</dd>
489	</dl>
490	</dd>
491
492	<dt class="path">WSDemo</dt>
493	<dd>A sample of messaging client. Server side sample does not exist now...</dd>
494
495	<dt class="path">RWiki</dt>
496	<dd>A sample CGI server which receives a request via SOAP and dispatches it
497	to RWiki server via dRuby. Naive SOAP/dRuby bridge implementation.</dd>
498
499	</dl>
500
501	<h2 id="restrictions" name="restrictions">7. Restrictions</h2>
502
503	<p>
504	The following features of the
505	<a href="http://www.w3.org/TR/SOAP/">SOAP 1.1 (W3C Note)</a>
506	spec are <strong>NOT</strong> currently supported:
507	</p>
508
509	<ul>
510	<li style="margin-top: 2ex;">SOAP Envelope
511	<ul>
512	<li>SOAP actor attribute</li>
513	<li>SOAP mustUnderstand attribute</li>
514	<li>SOAP Fault Codes</li>
515	</ul></li>
516	<li style="margin-top: 2ex;">SOAP Encoding
517	<ul>
518	<li>encoding/decoding using XML Schema;
519	Only xsi:type in SOAP Encoding is checked</li>
520	</ul></li>
521	<li style="margin-top: 2ex;">Othres
522	<ul>
523	<li>Transport binding except HTTP server and client</li>
524	</ul></li>
525	</ul>
526
527	<h2 id="resources" name="resources">8. Resources</h2>
528
529	<dl>
530	<dt class="path"><a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=SOAP4R">[RAA:SOAP4R]</a></dt>
531	<dd>I will post a new release to RAA.
532	Check RAA to get a new stable (I hope) version.</dd>
533
534	<dt class="path"><a href="http://www.ruby-lang.org/~knu/cgi-bin/cvsweb.cgi/lib/soap4r/">CVS</a></dt>
535	<dd>There is the SOAP4R CVS repository in cvs.ruby-lang.org.
536	(Thanks to knu, the maintainer of cvs.ruby-lang.org.)
537	Check here to get most recent (but could be unstable) version.</dd>
538
539	<dt class="path"><a href="http://www.jin.gr.jp/~nahi/Ruby/SOAP4R/wiki.cgi">SOAP4R Wiki</a></dt>
540	<dd>There is a wiki for SOAP4R, running under
541	<a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=RWiki">[RAA:RWiki]</a>.
542	Feel free to add your comment there.
543	Any comments are welcomed. (as always)</dd>
544
545	<dt class="path"><a href="http://www.jin.gr.jp/~nahi/Ruby/SOAP4R/wiki.cgi?cmd=view;name=InteropResults">InteropResults</a></dt>
546	<dd>Test results of <a href="http://www.whitemesa.com/interop.htm">SOAPBuilders Interoperability Lab "Round 2"</a>.</dd>
547
548	</dl>
549
550	<h2 id="history" name="history">9. History</h2>
551
552	<dl>
553	<dt>1.4.7 - September 20, 2002</dt>
554	<dd>
555	This version has these enhancements and bug fixes;
556	<ul>
557	<li>Includes WSDL4R initial release.
558	<ul>
559	<li>Bare in mind this is an alpha level code.
560	I wrote it halfway at half and a year ago,
561	and wrote the rest part in half and a day.
562	No comprehensive test, no strict syntax check, unfriendly error message, etc.
563	Try it if you want, and find bugs in it.</li>
564	<li>WSDL4R can run under XMLParser for now.
565	You might be able to let it run under NQXML/REXML if you know SAX
566	programming well. How XML processor is used under WSDL4R
567	is as same as under SOAP4R.</li>
568	</ul></li>
569	<li>Added xsd:short support.</li>
570	<li>::Float(double precision float in Ruby) is mapped to xsd:double now.
571	It was mapped to xsd:float.</li>
572	<li>Fixed a bug of year < 0 handling. B.C. 1 => -0001 in XMLSchema.</li>
573	<li>Fixed a bug of exception serialization. Custam mappingRegistry was not used.</li>
574	<li>Fixed a bug of regex for MediaType parsing.</li>
575	</ul>
576	</dd>
577
578	<dt>1.4.5 - May 25, 2002</dt>
579	<dd>
580	This version has these enhancements;
581	<ul>
582	<li>Supports all primitive datatypes of XML Schema Part2 Datatypes except NOTATION.
583	Added types are Duration, gYearMonth, anyURI, QName and so on.</li>
584	<li>Runs much faster than earlier versions.
585	Some performance check and tuning has been done.</li>
586	<li>Supports all Ruby objects marshalling/unmarshalling
587	except some special objects. See below for more detail.</li>
588	</ul>
589
590	CAUTION: This version requires
591	<a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=date2">[RAA:date2]</a> version 3.2 or later and
592	<a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=http-access2">[RAA:http-access2]</a> version F.
593	Please make sure the versions you use.
594	<br/><br/>
595
596	Here is detail of change.
597	<dl>
598	<dt>Datatypes (XMLSchemaDatatypes.rb and baseData.rb)</dt>
599	<dd>
600	<ul>
601	<li>Added duration, gYearMonth, gYear, gMonthDay, gDay, gMonth, anyURI and QName datetypes.
602	All primitive datatypes in XML Schema Part 2 section 3.2 except NOTAION are supported now.</li>
603	<li>Modified XSDDataTime, XSDDate and XSDTime implementation. These use a DataTime as a data holder.</li>
604	<li>Follow date/3.2: date2.rb -> date.rb.</li>
605	<li>Changed to_s representations of single float and double float. Thanks to gotoken.</li>
606	<li>XSDFloat: Add '0' if given str ends with 'E'. Float( "-1.4E" ) might fail on some system.</li>
607	<li>Added SOAPRawString class. Given string is embedded into XML instance directly.
608	You can use this class to embed (numeric) character references manually.</li>
609	<li>Fixed UTF8 regexp bug. XSDString uses this regexp to check a given string.</li>
610	<li>Added UT for XMLSchemaDatatypes.rb. See test/xsd_ut.rb and test/baseData_ut.rb.</li>
611	</ul></dd>
612
613	<dt>SOAP <-> Ruby object mapping (mappingRegistry.rb and rpcUtils.rb)</dt>
614	<dd>
615	<ul>
616	<li>Exception raised from server side could not be mapped to specific exception. Fixed.</li>
617	<li>Refactoring to avoid *_eval. Reduced warnings.</li>
618	<li>Added Range marshalling support.</li>
619	<li>Regexp#options support under ruby/1.6.</li>
620	<li>Supports cyclic Range such as;
621	<pre>
622	class Foo
623	attr_accessor :foo
624	def succ; end
625	def <=>( rhs ); end
626	end
627
628	o1 = Foo.new
629	o2 = Foo.new
630	r = o1..o2
631	o1.foo = r
632
633	p SOAPMarshal.load( SOAPMarshal.dump( r ))
634	</pre></li>
635	<li>Supports some instance variable of ruby standard class.
636	But instance variable of Array, Hash, String, Float and Bignum are not supported because of restriction of SOAP encoding format...</li>
637	<li>Alias ::SOAPMarshal to ::SOAP::Marshal.</li>
638	<li>Added Marshal.load and Marshal.dump as aliases to Marshal.unmarshal and
639	Marshal.unmarshal.</li>
640	</ul></dd>
641
642	<dt>misc</dt>
643	<dd>
644	<ul>
645	<li>Dumps what parser is used when $DEBUG. Try 'ruby -d -rsoap/processor -e 0'</li>
646	<li>Added CGI samples in sample/.</li>
647	<li>Some performance check and tuning has been done on both client and server side.
648	One bottle neck is Kernel.methods which SOAP4R use(d) while mapping SOAP Data Model <-> Ruby object.
649	I replaced it with Object.respond_to? .
650	Another bottle neck of client side is delegate.rb which is used by http-access2.
651	Get <a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=http-access2">[RAA:http-access2]</a> version F.
652	</ul>
653	</dd>
654	</dl>
655	</dd>
656
657	<dt>1.4.4 - May 6, 2002</dt>
658	<dd>
659	This is a bug fix release.
660	Following users should update.
661	<ul>
662	<li>Users who use DateTime datatype.</li>
663	<li>Developers of SOAP client/server which works under multi-thread condition.</li>
664	<li>REXML users.</li>
665	</ul>
666	Fixed bugs.
667	<ul>
668	<li>XSDDataTime: Changed variable name usec to sec_frac. It's not a micro sec so name usec is misleading.</li>
669	<li>XSDTime: Fixed bugs in usec part.</li>
670	<li>date.rb in standard library and date2 version 3 conflicts because date2.rb is a successor of date.rb and not designed for dual use.
671	(ex. using a module which requires date.rb like DBI and another module which requires date2.rb).
672	Added a workaround for this.</li>
673	<li>SOAP::Processor was not MT-safe. Fixed.
674	Projected feature regards to MT are follows.
675	At least I hope so. Tell me if you find these wrong.
676	<ul>
677	<li>Driver: safe</li>
678	<li>Proxy: safe</li>
679	<li>Server: safe</li>
680	<li>CGIStub: safe</li>
681	<li>StandaloneServer: safe</li>
682	<li>RPCRouter: safe</li>
683	<li>StreamHandler: safe</li>
684	<li>Processor: safe</li>
685	<li>SOAPParser: unsafe</li>
686	<li>SOAPGenerator: unsafe</li>
687	<li>EncodingStyleHandler: unsafe</li>
688	</ul>
689	</li>
690	<li>SOAP4R/1.4.3 supports REXML/2.1.3 but it did not detect REXML processor automatically.</li>
691	</ul>
692	</dd>
693
694	<dt>1.4.3 - April 11, 2002</dt>
695
696	<dd>
697	<dl>
698	<dt>Attention to 1.4.2 or earlier users;</dt>
699	<dd>
700	<ul>
701	<li>Stopped redistributing packages in RAA from this release.
702	Please get <a href="#dependencies">required</a> packages from
703	<a href="http://www.ruby-lang.org/en/raa.html">RAA</a>
704	and install it.</li>
705	<li>It still does NOT support WSDL!</li>
706	</ul>
707	</dd>
708
709	<dt>New features</dt>
710	<dd>
711	<ul>
712	<li>Added REXML parser support.</li>
713	<li>Added uninstaller.</li>
714	<li>Re: samples
715	<ul>
716	<li>Added 3 new samples, Calc, Exchange, and SampleStruct.</li>
717	<li>Use environment variable HTTP_PROXY or http_proxy for http proxy.</li>
718	<li>Removed unreachable services.</li>
719	<li>RAA: Separate iRAA.rb into RAA.rb and iRAA.rb.</li>
720	<li>Added description about <a href="#samples">samples</a> to RELEASE_en.html.</li>
721	</ul>
722	<li>Changed String encoding handling among
723	Ruby object <-> SOAP Data Model <-> XML instance.
724	<ul>
725	<li>Ruby object: $KCODE.</li>
726	<li>SOAP Data Model: utf-8 if uconv module is installed, $KCODE if not.</li>
727	<li>XML instance: Client side use utf-8 if uconv module is installed,
728	$KCODE if not. Server side try to adjust the request encoding.</li>
729	<li>Use regexp instead of NKF.guess to check if the given String is EUC/SJIS or not.</li>
730	</ul>
731	</li>
732	<li>Added 'addServant' interface to server side. See sample/Calc/server.rb.</li>
733	<li>Added 'addMethodAs' interface to both server side and client side.
734	See sample/Calc/server2.rb.</li>
735	</ul>
736	</dd>
737
738	<dt>Changes</dt>
739	<dd>
740	<ul>
741	<li>Removed Japanese document.
742	I was tired of maintaining 2 separated documents.
743	Though my English is poor as you see, numbers of readers of my English document
744	should be more than one of my Japanese document.
745	Would you please tell me bug of my English composition and of course in the code?</li>
746	<li>Use
747	<a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=Devel%3A%3ALogger">[RAA:Devel::Logger]</a>
748	instead of
749	<a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=Application">[RAA:Application]</a>.
750	</li>
751	<li>Avoided using exception in soap2obj and reduced warnings in runtime.</li>
752	<li>XSDDateTime: Use date2 version 3 instead of date3.rb.
753	Date2 version 3 will be included in standard distribution of Ruby/1.8.</li>
754	<li>XSDDateTime: Added XSDDateTimeToTime module to extract a Time object from XSDDateTime, XSDDate and XSDTime.</li>
755	</ul>
756	</dd>
757
758	<dt>Bug fixes</dt>
759	<dd>
760	<ul>
761	<li>Set 'charset=' to content-type when sending back a SOAPFault.
762	It was not set.</li>
763	<li>XSDDateTime: Parsedate was not used. Removed.</li>
764	<li>Added constant Log as a canonical name of Devel::Logger for backward
765	compatibility of devel-logger.</li>
766	<li>Foo = Struct.new(:foo) and Foo = Struct.new("Foo", :foo) could not be
767	unmarshalled collectly. All members were unmarshalled as nil. Fixed.</li>
768	<li>Rescue ArgumentError(Unrecognized signal) in standaloneServer.rb for mswin32 ruby.</li>
769	</ul>
770	</dd>
771	</dl>
772	</dd>
773
774	<dt>1.4.2 - December 28, 2001</dt>
775	<dd>
776	Many changes around Ruby language mapping for SOAP.
777	I replaced DRb's marshalling format with SOAP marshalling and it passed
778	about all unit test packed in DRb package.
779	Only test failed was regards to packet size.
780	You might be able to use SOAP::Marshal.(un\|)marshal for serializing objects
781	instead of Marshal.(load\|dump).
782
783	<ul>
784	<li>Illegal decoding of a position-less element after position-ed element. Fixed.</li>
785	<li>Add Rubytype encoding/decoding support: Regexp, Class, Module and Symbol.</li>
786	<li>Added an option of MappingRegistry to raise an exception when unknown Struct.
787	The option is set 'false' by default so that same behaviour as before.</li>
788	</ul></dd>
789
790	<dt>1.4.1 - December 7, 2001</dt>
791	<dd>SOAP4R/1.4 contained many bugs (as usual...)
792	1.4.1 is a maintenance release. Some bugs are fixed.
793	Thanks to Michael Neumann.
794
795	<ul>
796	<li>instance_eval in SOAPStruct#add for adding accessor illegaly overrode important methods for SOAP4R such as name, name= and so on. Removed this instance_eval and rewrote other codes which did depend the code. Thanks to MNeumann for reporting it and giving a suggestion to fix it.</li>
797	<li>Fixed charset handling. Illegal charset was set when automatic XML processor detecting.</li>
798	<li>Removed unused code(self.decode) in element.rb.</li>
799	<li>Illegal constant access when SOAP format error. Fixed.</li>
800	<li>LiteralEncodingNamespace moved to SOAP module.</li>
801	</ul></dd>
802
803
804	<dt>1.4 - December 5, 2001</dt>
805	<dd><ul>
806	<li>Datatypes:
807	<ul>
808	<li>XSDFloat: Bug in rounding double float to single float. Fixed.</li>
809	<li>SOAPElement: Added for literal encoding.</li>
810	<li>Removed SOAP encoding functions from baseData. EncondingStyleHandler should decide how to encode SOAP data model. (ie. ASP.NET seems to have its own encoding style.)</li>
811	<li>SOAPHeaderItem: Changed interface for easy use.</li>
812	</ul></li>
813
814	<li>SOAP Encoding:
815	<ul>
816	<li>Encoding by itself, not using NQXML's tree object model.</li>
817	<li>At last, supported multi-ref encoding!</li>
818	<li>marshal.rb: Marshalling with Envelope and Body. To marshal multi-ref'd object, Body is needed. CAUTION: Not compatible between former implementation.</li>
819	<li>Add EncodingStyleHandlerLiteral and set it to default.</li>
820	<li>Renamed encoding.rb to encodingStyleHandler.rb.</li>
821	<li>Added ASP.NET encoding handler. ASP.NET seems to use literal encoding (by default) but it is easier with this encodingStyleHandler to access the service which is built with ASP.NET.</li>
822	<li>Changed element name escape.
823	<ul>
824	<li>:: <=> \.\.</li>
825	<li>[^a-zA-Z0-9_-] <=> \.[0-F][0-F]
826	</ul>
827	Limitation: Using SOAP4R's RPC function, you cannot use the name which contains '.' for method name, class/struct name, and accessor name. In Ruby world, it should not be a problem I believe.</li>
828	</ul></li>
829
830	<li>RPC related functions:
831	<ul>
832	<li>Driver: Added 'invoke' method for messaging.</li>
833	<li>Driver: Content of SOAPFault detail element is set in the exception which is thrown from SOAP Node to client application.</li>
834	<li>Processor: Changed Processor.(un\|)marshal interface. An instance of NS for parsing/generating XML instance is prepared in parser/generator.</li>
835	<li>mappingRegistry.rb is devided from rpcUtils.rb.</li>
836	</ul></li>
837	</ul></dd>
838
839
840	<dt>1.3.8 - October 4, 2001</dt>
841	<dd>Feedback from
842	<a href="http://www.whitemesa.com/interop.htm">SOAPBuilders Interoperability Lab "Round 2"</a>
843	and Michael Neumann. Thanks!
844
845	<ul>
846	<li>Datatypes:
847	<ul>
848	<li>XSDFloat: Creating float data from junk string such as "123.0junk" was
849	converted to 0.0. It should be avoided. Fixed.</li>
850	<li>XSDFloat: Fixed double -> single rounding code.</li>
851	</ul></li>
852
853	<li>RPC related functions:
854	<ul>
855	<li>Changed typename <=> NCName strategy. '::' <=> '.'</li>
856	<li>Added mappingRegistry argument to interfaces for SOAP object creation.</li>
857	</ul></li>
858
859	<li>Others:
860	<ul>
861	<li>Set faultstring '(No faultstring)' to SOAP Fault when empty faultstring element.</li>
862	<li>server.rb: Added mappingRegistry interface.</li>
863	<li>marshal.rb: Create NCName from typename.</li>
864	</ul></li>
865	</ul></dd>
866
867
868	<dt>1.3.7 - August 24, 2001</dt>
869	<dd>Feedback from
870	<a href="http://www.whitemesa.com/interop.htm">SOAPBuilders Interoperability Lab "Round 2"</a>
871	and Michael Neumann. Thanks!
872
873	<ul>
874	<li>Datatypes:
875	<ul>
876	<li>All datatypes try to keep nil correctly.</li>
877	<li>XSDInt/Integer/Long: to_i -> Integer() to detect format error.</li>
878	<li>XSDDateTime, XSDDate, XSDTime: Add trailing 'Z' to indicate UTC.</li>
879	<li>SOAPStruct: Accept untyped struct.</li>
880	<li>Map(Hash): Let <item> untyped.</li>
881	<li>Apache allows only 'item' in Map type.</li>
882	</ul></li>
883
884	<li>Stream handler:
885	<ul>
886	<li>Removed MPOST support.</li>
887	<li>ECONNRESET was not caught. Fixed.</li>
888	<li>Added timeout support.</li>
889	</ul></li>
890
891	<li>Others:
892	<ul>
893	<li>Changed using URI library: URb -> URI; following its name change.</li>
894	<li>Added NQXML/1.1.0 support. A XMLDecl now recognized as a XMLDecl, not a PI.</li>
895	</ul></li>
896	</ul></dd>
897
898	<dt>1.3.6 - July 27, 2001</dt>
899	<dd>Many feedbacks from Michael Neumann. Thanks!
900
901	<ul>
902	<li>hexBinary type: Added.</li>
903	<li>nil type: Should not be xsd:nil but xsi:nil.</li>
904	<li>Added StandaloneServer implementation. Thanks to Michael Neumann!</li>
905	<li>Illegal parsing of XMLDecl. Fixed.</li>
906	<li>RPC's 'inout' param was not supported. Fixed. Thanks to Michael Neumann!</li>
907	<li>URb::Generic#path returns '' when abs_path is empty (such as http://foo).
908	Added checking code.</li>
909	<li>Use http-access2 instead of original HTTP implementation. http-access2 supports HTTP/1.1's persistent connection.</li>
910	</ul></dd>
911
912	<dt>1.3.5 - July 14, 2001</dt>
913	<dd>Many feedbacks from Michael Neumann.
914	I much appreciate valuable comments to him.
915	Thanks!
916
917	<ul>
918	<li>Changed using URI library: uri -> URb.</li>
919	<li>Types changed:
920	<ul>
921	<li>All: Triming data except XSDString before parsing it.</li>
922	<li>String: Regexp for XML Char check did not work under $KCODE = 'UTF8' condition. Fixed.</li>
923	<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>
924	</ul>
925	</li>
926
927	<li>Supported XML parser:
928	<ul>
929	<li>Added automatic CES conversion support for NQXMLParser.
930	(Depends on uconv module).
931	Set $KCODE for regexps used in NQXML parser.</li>
932	<li>Moved SOAPNQXML*Parser to nqxmlparser.rb.</li>
933	</ul>
934	</li>
935
936	<li>RPC related functions changed:</li>
937	<ul>
938	<li>Added marshalling/unmarshalling Ruby's object using SOAP Encoding.</li>
939	<li>Parallelize of signatures of 'addMethod': proxy.rb <-> rpcRouter.rb, driver.rb <-> cgistub.rb.</li>
940	<li>Void return if 'retval' is not defined.</li>
941	<li>Added SOAP's Long type to default mapping table.</li>
942	</ul>
943	</li>
944	</ul></dd>
945
946	<dt>1.3.4.2 - July 11, 2001</dt>
947	<dd>SOAP4R/1.3.4 was once packed in July 10, 2001.
948	But, thanks to MNeumann and knu,
949	I found I had forgotten to pack 'redist' directory with it.
950	I added some fix from developing version and repack it as 1.3.4.2.
951	Sorry for frequently release...
952	<br/><br/>
953
954	Feedback from
955	<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
956	and Michael Neumann. Thanks!
957
958	<ul>
959	<li>Added in 1.3.4.2:
960	<ul>
961	<li>Type Decimal: Silly bug fixed. 0.0001 was converted to 0.1</li>
962	<li>CGIStub returns HTTP status 500 when returning SOAP Fault.
963	Returned 200 because I don't like this spec., but SOAP/1.2 W3C WD
964	9 July 2001 have adopted it. Hmm...</li>
965	<li>RPC client(driver.rb): Exception#set_backtrace was omitted when transmitting exception by SOAP Fault.</li>
966	</ul>
967	</li>
968	<li>Types changed:
969	<ul>
970	<li>Array: Incomplete sparse array support. Fixed.</li>
971	<li>Date: Added.</li>
972	<li>Time: Added.</li>
973	<li>DateTime: Added precision of time support.</li>
974	<li>String: Default data should not be nil but ''.</li>
975	<li>Nil: Attribute value of xsi:nil might be '1' instead of 'true'. Fixed.</li>
976	</ul>
977	</li>
978
979	<li>Supported XML parser:
980	<ul>
981	<li>Added SOAPXMLParser and SOAPSAXDriver for XMLParser which uses expat.
982	You can get the module from RAA: <a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=XMLParser">XMLParser module</a>.<br/>
983	To use XMLParser -> add "require 'soap/xmlparser'".<br/>
984	To use SAX driver of XMLParser -> add "require 'soap/saxdriver'".<br/>
985	To use NQXMLParser -> nothing to do.<br/>
986	FYI:
987	<ul>
988	<li>XMLParser version is faster than others</li>
989	<li>SAXDriver version is extremely slow</li>
990	<li>NQXMLParser version is somewhat slower than XMLParser version</li>
991	<li>XMLParser is a Ruby extension module; To use it, you must compile and install it.</li>
992	<li>So far, automatic code conversion support is for XMLParser and SAXDriver. See below.</li>
993	</ul>
994	</li>
995	<li>Added automatic CES conversion support: UTF-8 <-> EUC, SJIS.
996	Requires Uconv module. Works with XMLParser module only now.</li>
997	<li>Added XMLDecl for CES.</li>
998	</ul>
999	</ul></dd>
1000
1001	<dt>1.3.3 - July 4, 2001</dt>
1002	<dd>Feedback from
1003	<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
1004	and Michael Neumann. Thanks!
1005	<ul>
1006	<li>Added SOAP4R Installer by Michael Neumann. Thanks!</li>
1007	<li>Types changed:
1008	<ul>
1009	<li>Boolean: Accepts 1 and 0 in addition to true and falue.</li>
1010	<li>Float: handles single-precision 32-bit floating point.
1011	Ruby's float is doule-precision.</li>
1012	<li>Double: Added. Mapped to Ruby's Float.</li>
1013	<li>DateTime: Added TZ support.</li>
1014	<li>Long: Added.</li>
1015	<li>Int: Changed class hierarchy; derived from Long now.</li>
1016	<li>Array: Added 'position' and 'offset' support.</li>
1017	<li>Array: Added M-D Array support.</li>
1018	<li>Decimal: Added but it's incomplete now.</li>
1019	</ul>
1020	</li>
1021	<li>Illegal error message when a type not found in SOAP-ENC.</li>
1022	<li>Tries to transmit \r safely. To be checked...</li>
1023	<li>Parse Fault items like 'faultcode' as same as Body ie. href/id.</li>
1024	<li>rpcUtils.rb was completely re-written.
1025	<ul>
1026	<li>Added mappingRegistry interface.</li>
1027	<li>Changed soap2obj and obj2soap's interface.</li>
1028	<li>Bignum might be int or integer. It's dependent on platform.
1029	Changed to check range -2147483648~+2147483647 itself.</li>
1030	<li>ary2md: Added. Converting Array ((of Array)...) to M-D Array.</li>
1031	<li>struct2obj: Illegal dependency on ordering of Struct#members. Fixed.</li>
1032	<li>Ruby's Array should be converted to SOAP's Array of anyType. Fixed.</li>
1033	</ul>
1034	</li>
1035	<li>Dump HTTP header even when an error was raised.</li>
1036	</ul></dd>
1037
1038	<dt>1.3.2 - June 21, 2001</dt>
1039	<dd>Feedback from
1040	<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
1041
1042	<ul>
1043	<li>"nil='1'" should be "nil='true'" in 2001 schema
1044	whereas "null='1'" in 1999 schema. Fixed.</li>
1045	<li>SOAP Array was not typed with xsi:type.</li>
1046	<li>Fixed serialization root handling algorithm.</li>
1047	<li>Supported kind of SOAP-ENC:String style typed element.</li>
1048	<li>Default namespace was not derived to child element. Fixed.</li>
1049	<li>Support default encodingStyle.</li>
1050	<li>Added support for void type (SOAP::RPCUtils::SOAPVoid).</li>
1051	</ul></dd>
1052
1053	<dt>1.3.1 - May 30, 2001</dt>
1054	<dd>Feedback from
1055	<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
1056
1057	<ul>
1058	<li>Heading and trailing whtespaces in Base64 string could not be processed. Fixed.</li>
1059	<li>Illegal typeNamespace of SOAP's base64 type. Fixed.</li>
1060	<li>Added NaN, INF, -INF support of Float type.</li>
1061	<li>Extracted xsd:1999 type support to XMLSchemaDatatypes1999.rb. Use it with 'require "soap/XMLSchemaDatatypes1999"'.</li>
1062	<li>Added 'root' attribute support.</li>
1063	<li>Return status 500 when Fault.</li>
1064	</ul></dd>
1065
1066	<dt>1.3.0 - May 20, 2001</dt>
1067	<dd><ul>
1068	<li>Adopted
1069	<a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=NQXML">NQXML module</a>
1070	instead of XMLParser module extensively.
1071	(You can implement your SOAP parser with XMLParser module.
1072	See the last part of lib/soap/parser.rb)
1073	<ul>
1074	<li>Use NQXML's streamingParser or tokenizer instead of XMLParser's DOMParser for unmarshalling.</li>
1075	<li>Use NQXML's document instead of XMLParser's DOM for marshalling.</li>
1076	</ul></li>
1077	<li>Passed major(?) part of inteoperability test in
1078	<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
1079	See test/interop/README.txt.</li>
1080	<li>Changed module namespace. SOAPFoo -> SOAP::Foo.</li>
1081	<li>Added float datatype support.</li>
1082	<li>Changed dateTime marshalling format. No timezone was added to marshalled string because SOAP4R does not support timezone now.</li>
1083	</ul></dd>
1084
1085	<dt>1.2.0 - March 30, 2001</dt>
1086	<dd>Checked interoperability with
1087	<a href="http://xml.apache.org/soap/">Apache-SOAP</a>,
1088	<a href="http://www.pocketsoap.com">pocketSOAP/0.91</a>,
1089	<a href="http://www.geocities.com/paulclinger/soap.html">SOAP::Lite for Perl</a>,
1090	and <a href="http://www.develop.com/soap/">SOAP/Perl/0.28</a>.
1091	It seems to work good except SOAP/Perl/0.28.
1092
1093	<ul>
1094	<li>Added href/id unmarshalling support.
1095	(href/id marshalling has not been supported yet)</li>
1096	<li>Added SOAP's base64 type support.</li>
1097	<li>SOAPTimeInstant -> SOAPDateTime. Following XML Schema PR.</li>
1098	<li>SOAPStruct can have multiple accessor which have same name.
1099	Should I separate it from original SOAPStruct?</li>
1100	<li>Unknown attribute in Header Item raised an exception. Omitted.</li>
1101	<li>Router can handle methods which belong to different namespace.</li>
1102	<li>Added an option to allow unqualified SOAP element.</li>
1103	<li>Added Apache's Map type support. Ruby's Hash are mapped to it now.
1104	(Ruby's Hash marshalled by 1.1 processor in the old way can be unmarshalled,
1105	but 1.2 processor marshals it in the new way and 1.1 processor does not
1106	unmarshals it into Hash. Incompatibility between SOAP4R/1.2 and 1.1)</li>
1107	<li>Unknown type 'unknown:SOAPStruct' was incorrectly unmarshalled into SOAPStruct. Fixed.</li>
1108	<li>Added utility methods map! and members to SOAPArray and SOAPStruct.</li>
1109	<li>Added methods request, response, and fault to SOAPBody.</li>
1110	</ul></dd>
1111
1112	<dt>1.1.0 - March 23, 2001</dt>
1113	<dd>Made many changes.
1114	Since it is tested only for my limited use, please be careful to use.
1115	Any comments especially "cannot connect to XXX implementation" are welcomed.
1116	Feel free sending mail to
1117	<a href="mailto:nakahiro@sarion.co.jp" class="path">nakahiro@sarion.co.jp</a>.
1118
1119	<ul>
1120	<li>Added RPC server support.</li>
1121	<li>Divided RPC client/server implementation from core.</li>
1122	<li>Added Date, Hash type support. (Unknown type is converted to Struct as usual)</li>
1123	<li>Adopted Date in date3.rb by Funaba-san instead of Time as TimeInstant.</li>
1124	<li>Many encoding/decoding bugs around SOAPArray and SOAPStruct were fixed.</li>
1125	</ul></dd>
1126
1127	<dt>1.0.2 - November 11, 2000</dt>
1128	<dd>Since the previous package dated, refreshes some points.
1129	<ul>
1130	<li>Ruby: ruby 1.6.x</li>
1131	<li>uri.rb: 4.22</li>
1132	<li>sample: xml-soap/2.0</li>
1133	</ul></dd>
1134
1135	<dt>1.0.1 - July 27, 2000</dt>
1136	<dd>Handles SOAP/1.1 arrays.
1137	1.0.0 cannot handles SOAP/1.1 arrays...
1138	Bare in mind there still be many
1139	<a href="#restrictions">restrictions</a>
1140	around SOAP arrays.</dd>
1141
1142	<dt>1.0.0 - July 17, 2000</dt>
1143	<dd>It is the initial released version of SOAP4R. :-)</dd>
1144	</dl>
1145
1146	<h2 id="author" name="author">10. Author</h2>
1147
1148	<dl>
1149	<dt>Name</dt>
1150	<dd>NAKAMURA, Hiroshi (aka NaHi or nakahiro)</dd>
1151
1152	<dt>E-mail</dt>
1153	<dd><a href="mailto:nakahiro@sarion.co.jp" class="path">nakahiro@sarion.co.jp</a></dd>
1154
1155	<dt>URL</dt>
1156	<dd><a href="http://www.jin.gr.jp/~nahi/" class="path">http://www.jin.gr.jp/~nahi/</a> (Japanese)</dd>
1157	</dl>
1158
1159	<h2 id="copyright" name="copyright">11. Copyright</h2>
1160
1161	<p style="text-align: center;">
1162	SOAP4R<br />
1163	Copyright © 2000, 2001, 2002 NAKAMURA, Hiroshi.
1164	</p>
1165
1166	<p>
1167	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.
1168	</p>
1169
1170	<p>
1171	This progr