Welcome to the "trac"-ing site of soap4r!
[soap4r] [httpclient] [openpgp4u] [pkcs1] [logger] [csv] [vtr]
Show
Ignore:
Timestamp:
11/03/03 00:49:17 (5 years ago)
Author:
nahi
Message:

Version: 1.5.1

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • trunk/RELEASE_en.html

    r948 r1032  
    1919 
    2020<p class="status"> 
    21 Last modified: September 13, 2003<br /> 
     21Last modified: November  3, 2003<br /> 
    2222Created: July 17, 2000 
    2323</p> 
    …… 
    3434 
    3535<p> 
    36 Target SOAP4R version: SOAP4R/1.5.0 
     36Target SOAP4R version: SOAP4R/1.5.1 
    3737</p> 
    3838 
    …… 
    5454 
    5555<p> 
    56 Thousands of lines are changed in this release 
    57 (*.rb in current SOAP4R distribution has 30kloc or over). 
    58 But the biggest change is coding convention, camelCase to non_camel_case. 
    59 Though I tried to keep compatibility between 1.5.0 and 1.4.8, but there's no 
    60 way to keep it at a few point.  If you'll find your code which was developed 
    61 for 1.4.8 does not run under 1.5.0, feel free to ask 
    62 <a href="mailto:nakahiro@sarion.co.jp">me</a> to solve the problem. 
    63 </p> 
    64 <ul> 
    65   <li>Dependency libraries; 
    66   <ul> 
    67     <li>Add net/http support.  Users can try sample SOAP clients without installing http-access2.  For actual usage, consider installing http-access2 for speed and thread-safe SOAP client.  CAUTION: Building SOAP CGI server needs http-access2 to be installed.</li> 
    68     <li>Soap4r standalone server requires webrick module to be installed instead of GServer.rb and httpserver.rb.</li> 
    69     <li>Supports iconv.  To use utf-8, you need to install iconv(included in ruby/1.8) or uconv.</li> 
    70     <li>Suspend NQXML XML parser support.</li> 
    71     <li>Remove REXML processor version check.  No longer needed.</li> 
    72     <li>Rewrite tests with test/unit.</li> 
     56Important news:  Soap4r library is included in ruby distribution after 
     57ruby/1.8.1.  You might not be need to install this package under ruby/1.8. 
     58The files this package includes and are not included in ruby/1.8 distribution 
     59are an application program (bin/wsdl2ruby) and some test codes. 
     60Consider to get this package if, 
     61</p> 
     62 
     63<ul> 
     64  <li>You need the WSDL to ruby (reads a WSDL file and generates stubs and Ruby class definitions) application, or</li> 
     65  <li>You want to use soap4r under ruby/1.6.</li> 
     66</ul> 
     67 
     68<ul> 
     69  <li>Features; 
     70  <ul> 
     71    <li>Sample updates; Update Amazon Web Service WSDL (v2 -&gt; v3), and update RAA WSDL(0.0.1 -&gt; 0.0.2). 
     72    <li>Supports ivars of basetype and extending modules marshalling with XML attribute. 
     73Using XML attribute to support ruby object dependent information, marshalled object keeps compatibility with SOAP spec. 
     74It shows the power of XML, extensibility.<br/> 
     75Now I think SOAP marshaller supports all kind of object graph which is supported by Ruby's original marshaller.</li> 
     76    <li>Better XML pretty printing. 
     77<pre> 
     78puts SOAPMarshal.dump(Person.new(&quot;NaHi&quot;, 33)) 
     79 
     80=&gt; 
     81 
     82&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot; ?&gt; 
     83&lt;env:Envelope xmlns:xsd=&quot;http://www.w3.org/2001/XMLSchema&quot; 
     84    xmlns:env=&quot;http://schemas.xmlsoap.org/soap/envelope/&quot; 
     85    xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;&gt; 
     86  &lt;env:Body&gt; 
     87    &lt;Person xmlns:n1=&quot;http://www.ruby-lang.org/xmlns/ruby/type/custom&quot; 
     88        xsi:type=&quot;n1:Person&quot; 
     89        env:encodingStyle=&quot;http://schemas.xmlsoap.org/soap/encoding/&quot;&gt; 
     90      &lt;age xsi:type=&quot;xsd:int&quot;&gt;33&lt;/age&gt; 
     91      &lt;name xsi:type=&quot;xsd:string&quot;&gt;NaHi&lt;/name&gt; 
     92    &lt;/Person&gt; 
     93  &lt;/env:Body&gt; 
     94&lt;/env:Envelope&gt; 
     95    </pre></li> 
    7396  </ul></li> 
    7497 
    75   <li>Features; 
    76   <ul> 
    77     <li>Efforts to support messaging with document/literal and ASP.NET interoperability.</li> 
    78     <li>Add document/literal messaging interface to wsdlDriver.rb.  See a very brief example in sample/soapbox/wsdlDriver.rb though I still didn't try to login to Jabber server..  Jabber folks?</li> 
    79     <li>XML pretty printing.</li> 
    80     <li>Better Ruby object mapping.  Rewrote RubytypeFactory to support more Ruby objects.  Tests in AMarshal(http://cvs.m17n.org/~akr/amarshal/) much helped it.  Thanks very much to Tanaka Akira-san.</li> 
    81     <li>SOAPMarshal accepts IO as an output device like Marshal#dump.</li> 
    82     <li>SOAPElement: constructor signature change.  Added extraattrs attribute.</li> 
    83     <li>XSDDateTimeImpl: to_time did not set usec.</li> 
    84     <li>StreamHandler: add reset method to shutdown a connection to a site.</li> 
     98  <li>Installation; 
     99  <ul> 
     100    <li>The previous version soap4r/1.5.0 required http-access2 to be installed to build CGI server, but no longer needed fot this purpose now. 
     101You can use almost all features of soap4r without http-access2, 
     102but for actual usage, consider installing http-access2 for speed and 
     103thread-safe SOAP client.</li> 
     104    <li>Under ruby/1.8, installer installs lib files to rubylibdir(e.g. /usr/local/lib/ruby/1.8) instead of sitelibdir(e.g. /usr/local/lib/ruby/site_ruby/1.8)</li> 
    85105  </ul></li> 
    86106 
    87   <li>Others; 
    88   <ul> 
    89     <li>Simplify installer and remove uninstaller.  Saving inventory file in src dir could be the problem.</li> 
    90     <li>Class/Module architecture relocation.</li> 
    91     <li>Changing coding convention to fit with Ruby's.  Added lib/soap/compat.rb which defines compatibility definitions for 1.4.8.  lib/soap/compat.rb warns when the library is loaded.</li> 
    92     <li>Many warnings raised under 1.8, caused by illegal references like XSD::XSDInt in typeMap.rb.  Soap4r defined toplevel::XSDInt.  Define XSD* classes in XSD module and introduce it to toplevel.</li> 
     107  <li>Bug fixes; 
     108  <ul> 
     109    <li>Do not introduce XSD constants to toplevel.</li> 
     110    <li>'NO_PROXY'/'no_proxy' env var was not supported under net/http.  Fixed.</li> 
     111    <li>Remove some ruby/1.8 dependent codes.  Should work fine under 1.6, too.</li> 
     112    <li>XSD::XSDString did not check its value space under $KCODE = 'NONE' env for example where iconv module is not installed.</li> 
     113    <li>XSD::XSDFloat, XSD::XSDDouble: add +/- sign explicitly when stringified and embedded into XML instance.  Ruby's sprintf may format -0.0 as "0.0" (no minus sign) depending on underlying C sprintf implementation.</li> 
    93114  </ul></li> 
    94115</ul> 
    …… 
    167188You have to install Ruby itself. 
    168189Ruby/1.6 series or later is required. 
    169 It does not works on 1.4 series because it does not have class variable. 
    170190</p> 
    171191 
    …… 
    179199<dt class="path">XML processor</dt> 
    180200<dd>SOAP4R requires a XML processor package installed. 
     201Note: ruby/1.8 includes REXML so you don't have to install extra XML parser library.<br/> 
    181202For now, one of following XML processor must be installed 
    182203(SOAP4R automatically detects it in runtime). 
    183 FYI: xmlscan and REXML are scheduled to be included in ruby/1.8's standard 
    184 distribution.  Version following each project is the version tested with soap4r. 
    185 <br/> 
    186 Note: ruby/1.8 includes REXML so you don't have to install extra XML parser library. 
    187204<ul> 
    188205<li><a href="http://raa.ruby-lang.org/list.rhtml?name=xmlscan">[RAA:xmlscan]</a> (0.2.3, 0.3.x)</li> 
    …… 
    193210 
    194211<dt class="path"><a href="http://raa.ruby-lang.org/list.rhtml?name=devel-logger">[RAA:devel-logger]</a> (1.1.0)</dt> 
    195 <dd>Logging utility by NaHi.</dd> 
     212<dd>Logging utility by NaHi.  ruby/1.8 includes this library so you don't have to re-install it.</dd> 
    196213 
    197214<dt class="path"><a href="http://raa.ruby-lang.org/list.rhtml?name=webrick">[RAA:webrick]</a> (1.3.1) (required for soap server)</dt> 
    …… 
    427444Since the server is (still) under testing phase so stable operation is not expected.</dd> 
    428445 
    429 <dt class="path">webrick/</dt> 
    430 <dd>SOAP-RPC server samples which runs with WEBrick. 
    431 <ul> 
    432 <li>httpd.rb: HTTP server which soaplet.rb mounts to. 
    433 It is powered by WEBrick so you must install 
    434 <a href="http://raa.ruby-lang.org/list.rhtml?name=webrick">[RAA:WEBrick]</a> 
    435 to run it.</li> 
    436 <li>soaplet.rb: A bricklet to add a SOAP function to WEBrick. 
    437 It hosts exchange.rb, sampleStruct.rb below, and it is mounted to httpd.rb 
    438 to serve ExchangeService and SampleStructService.</li> 
    439 <li>ExchangeService 
    440 <dl> 
    441 <dt>exchange.rb</dt> 
    442 <dd>A server class definition which returns the currency rate 
    443 after connecting to another site by SOAP to get the real rate. 
    444 An instance of this class is instanciated in httpd.rb and this instance 
    445 respond to each HTTP request.</dd> 
    446 <dt>exchangeClient.rb</dt> 
    447 <dd>A client to connect soaplet.rb via SOAP/HTTP to call exchange.rb.</dd> 
    448 <dt>iExchange.rb</dt> 
    449 <dd>Common class(type) definitions for server and client.</dd> 
    450 </dl> 
    451 </li> 
    452  
    453446<li>SampleStructService 
    454447<dl> 
    …… 
    554547 
    555548<dl> 
    556 <dt>1.5.0 - January 17, 2003</dt> 
     549<dt>1.5.1 - November  2, 2003</dt> 
     550<dd>Important news:  Soap4r library is included in ruby distribution after 
     551ruby/1.8.1.  You might not be need to install this package under ruby/1.8. 
     552The files this package includes and are not included in ruby/1.8 distribution 
     553are an application program (bin/wsdl2ruby) and some test codes. 
     554Consider to get this package if, 
     555<ul> 
     556  <li>You need the WSDL to ruby (reads a WSDL file and generates stubs and Ruby class definitions) application, or</li> 
     557  <li>You want to use soap4r under ruby/1.6.</li> 
     558</ul> 
     559 
     560<ul> 
     561  <li>Features; 
     562  <ul> 
     563    <li>Sample updates; Update Amazon Web Service WSDL (v2 -&gt; v3), and update RAA WSDL(0.0.1 -&gt; 0.0.2). 
     564    <li>Supports ivars of basetype and extending modules marshalling with XML attribute. 
     565Using XML attribute to support ruby object dependent information, marshalled object keeps compatibility with SOAP spec. 
     566It shows the power of XML, extensibility.<br/> 
     567Now I think SOAP marshaller supports all kind of object graph which is supported by Ruby's original marshaller.</li> 
     568    <li>Better XML pretty printing. 
     569<pre> 
     570puts SOAPMarshal.dump(Person.new(&quot;NaHi&quot;, 33)) 
     571 
     572=&gt; 
     573 
     574&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot; ?&gt; 
     575&lt;env:Envelope xmlns:xsd=&quot;http://www.w3.org/2001/XMLSchema&quot; 
     576    xmlns:env=&quot;http://schemas.xmlsoap.org/soap/envelope/&quot; 
     577    xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;&gt; 
     578  &lt;env:Body&gt; 
     579    &lt;Person xmlns:n1=&quot;http://www.ruby-lang.org/xmlns/ruby/type/custom&quot; 
     580        xsi:type=&quot;n1:Person&quot; 
     581        env:encodingStyle=&quot;http://schemas.xmlsoap.org/soap/encoding/&quot;&gt; 
     582      &lt;age xsi:type=&quot;xsd:int&quot;&gt;33&lt;/age&gt; 
     583      &lt;name xsi:type=&quot;xsd:string&quot;&gt;NaHi&lt;/name&gt; 
     584    &lt;/Person&gt; 
     585  &lt;/env:Body&gt; 
     586&lt;/env:Envelope&gt; 
     587    </pre></li> 
     588  </ul></li> 
     589 
     590  <li>Installation; 
     591  <ul> 
     592    <li>The previous version soap4r/1.5.0 required http-access2 to be installed to build CGI server, but no longer needed fot this purpose now. 
     593You can use almost all features of soap4r without http-access2, 
     594but for actual usage, consider installing http-access2 for speed and 
     595thread-safe SOAP client.</li> 
     596    <li>Under ruby/1.8, installer installs lib files to rubylibdir(e.g. /usr/local/lib/ruby/1.8) instead of sitelibdir(e.g. /usr/local/lib/ruby/site_ruby/1.8)</li> 
     597  </ul></li> 
     598 
     599  <li>Bug fixes; 
     600  <ul> 
     601    <li>Do not introduce XSD constants to toplevel.</li> 
     602    <li>'NO_PROXY'/'no_proxy' env var was not supported under net/http.  Fixed.</li> 
     603    <li>Remove some ruby/1.8 dependent codes.  Should work fine under 1.6, too.</li> 
     604    <li>XSD::XSDString did not check its value space under $KCODE = 'NONE' env for example where iconv module is not installed.</li> 
     605    <li>XSD::XSDFloat, XSD::XSDDouble: add +/- sign explicitly when stringified and embedded into XML instance.  Ruby's sprintf may format -0.0 as "0.0" (no minus sign) depending on underlying C sprintf implementation.</li> 
     606  </ul></li> 
     607</ul></dd> 
     608 
     609<dt>1.5.0 - September 13, 2003</dt> 
    557610<dd>Thousands of lines are changed in this release 
    558611(*.rb in current SOAP4R distribution has 30kloc or over). 
    …… 
    12361289<dt>E-mail</dt> 
    12371290<dd><a href="mailto:nakahiro@sarion.co.jp" class="path">nakahiro@sarion.co.jp</a></dd> 
    1238  
    1239 <dt>URL</dt> 
    1240 <dd><a href="http://www.jin.gr.jp/~nahi/" class="path">http://www.jin.gr.jp/~nahi/</a> (Japanese)</dd> 
    12411291</dl> 
    12421292