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

root/tags/RELEASE_1_4_4_1/RELEASE_en.html

Revision 487, 37.1 kB (checked in by nahi, 7 years ago)

Doc for 1.4.4.1

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