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

Changeset 1139

Show
Ignore:
Timestamp:
12/25/03 18:51:18 (5 years ago)
Author:
nahi
Message:

* for 1.5.2.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • trunk/RELEASE_en.html

    r1075 r1139  
    1919 
    2020<p class="status"> 
    21 Last modified: November  3, 2003<br /> 
     21Last modified: December 25, 2003<br /> 
    2222Created: July 17, 2000 
    2323</p> 
    …… 
    3434 
    3535<p> 
    36 Target SOAP4R version: SOAP4R/1.5.1 
     36Target SOAP4R version: SOAP4R/1.5.2 
    3737</p> 
    3838 
    …… 
    5757ruby/1.8.1.  You might not be need to install this package under ruby/1.8. 
    5858The files this package includes and are not included in ruby/1.8 distribution 
    59 are an application program (bin/wsdl2ruby) and some test codes. 
    60 Consider 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> 
     59are; some experimental code, application program (bin/wsdl2ruby) and some test 
     60codes.  Consider to get this package if, 
     61</p> 
     62 
     63<ul> 
     64  <li>You want to use soap4r under ruby/1.6</li> 
     65  <li>You need to do SOAP Messages with Attachments (SwA)</li> 
     66  <li>You need the WSDL to ruby (reads a WSDL file and generates stubs and Ruby class definitions) application</li> 
     67</ul> 
     68 
     69<p> 
     70Changes from 1.5.1.2. 
     71</p> 
     72 
     73<ul> 
     74  <li>License; 
     75  <ul> 
     76    <li>Changed license from GPL2 to Ruby's.</li> 
     77  </ul></li> 
     78 
    6979  <li>Features; 
    7080  <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. 
    73 Using XML attribute to support ruby object dependent information, marshalled object keeps compatibility with SOAP spec. 
    74 It shows the power of XML, extensibility.<br/> 
    75 Now 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. 
     81    <li>Add SOAP Messages with Attachments (SwA) support. 
     82    Patched by Jamie Herre. 
     83    &quot;SOAP Messages with Attachments&quot; is the W3C Note which defines a 
     84    binding for a SOAP 1.1 message to be carried within a MIME 
     85    multipart/related message.  <a href="http://www.w3.org/TR/SOAP-attachments">http://www.w3.org/TR/SOAP-attachments</a> 
     86    This feature is still experimental.  Interop testing is going on.</li> 
     87 
     88    <li>HTTPS support even when you use net/http (not http-access2). 
     89    Patched by Oliver M. Bolzer.</li> 
     90 
     91    <li>Property file support.  SOAP and WSDL client reads &quot;soap/property&quot; 
     92    file located at somewhere in $: (ruby libray locations).  For 
     93    example, save these lines to 
     94    &quot;$rubylibdir/site_ruby/1.8/soap/property&quot;. 
    7795<pre> 
    78 puts 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> 
     96      client.protocol.http.proxy = http://myproxy:8080 
     97      client.protocol.http.no_proxy = 192.168.71.71,192.168.71.72 
     98</pre> 
     99    Then all HTTP connections should use these proxy and no_proxy 
     100    definition.</li> 
     101 
     102    <li>Do not trust "HTTP_PROXY" environment variable by default to 
     103    avoid security problem.  cf. 
     104    <ul> 
     105      <li><a href="http://ftp.ics.uci.edu/pub/websoft/libwww-perl/archive/2001h1/0072.html">http://ftp.ics.uci.edu/pub/websoft/libwww-perl/archive/2001h1/0072.html</a></li> 
     106      <li><a href="http://ftp.ics.uci.edu/pub/websoft/libwww-perl/archive/2001h1/0241.html">http://ftp.ics.uci.edu/pub/websoft/libwww-perl/archive/2001h1/0241.html</a></li> 
     107      <li><a href="http://curl.haxx.se/mail/archive-2001-12/0034.html">http://curl.haxx.se/mail/archive-2001-12/0034.html</a></li>  
     108    </ul> 
     109    To use HTTP_PROXY and NO_PROXY environment variable, you must set 
     110    SOAP_USE_PROXY environment variable 'on', too. 
     111<pre> 
     112      bash$ soap_use_proxy=on http_proxy=http://myproxy:8080 ruby ... 
     113      csh$  env soap_use_proxy=on http_proxy=http://myproxy:8080 ruby ... 
     114</pre></li> 
     115 
     116    <li>Add SOAP::RPC::Driver#mandatorycharset= and 
     117    SOAP::WSDLDriver#mandatorycharset= interface to force using 
     118    charset when parsing response from buggy server such as AWS.</li> 
     119 
     120    <li>Support a halfway-typed multi-ref array that Axis dumps.</li> 
     121 
     122    <li>Added a interface XSD::Charset.encoding= to control internal 
     123    encoding scheme.  Internal encoding scheme was fixed to 'utf-8' 
     124    when iconv or uconv was installed.  You can set 'euc-jp', etc. 
     125    to avoid encoding scheme conversion if you know what encoding 
     126    scheme the server uses.</li> 
    96127  </ul></li> 
    97128 
    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. 
    101 You can use almost all features of soap4r without http-access2, 
    102 but for actual usage, consider installing http-access2 for speed and 
    103 thread-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> 
    105   </ul></li> 
    106  
    107129  <li>Bug fixes; 
    108130  <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> 
     131    <li>SOAP::Marshal.unmarshal: raise an exception if parse fails. 
     132    (returned nil)</li> 
     133 
     134    <li>SOAP::WSDLDriver: decode unknown element according to self-defined 
     135    type even if WSDL was given.</li> 
     136 
     137    <li> SOAP::Mapping::Factory#create_empty_object: fix Class#allocate 
     138    emulation code for ruby/1.6.  no effective change under ruby/1.8.</li> 
     139 
     140    <li>SOAP::RPC::SOAPMethodResponse: element name of response message 
     141    could have the name other than 'return'.</li> 
     142 
     143    <li>SOAP::RPC::StandaloneServer: add methods 'shutdown' and 'status' 
     144    as delegates to WEBrick.</li> 
     145 
     146    <li>WSDL::SOAP::ClassDefCreator: WSDL/1.1 allows plural fault 
     147    definition in a operation.</li> 
     148 
     149    <li>XSD::Charset.init: use cp932 under emx. 
     150    Patched by Siena. / SHINAGAWA, Norihide.</li> 
    114151  </ul></li> 
    115152</ul> 
    …… 
    212249<dd>Logging utility by NaHi.  ruby/1.8 includes this library so you don't have to re-install it.</dd> 
    213250 
    214 <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> 
     251<dt class="path"><a href="http://raa.ruby-lang.org/list.rhtml?name=webrick">[RAA:webrick]</a> (1.3.1)</dt> 
    215252<dd>TCP server toolkit by Gotoyuzo. 
    216253ruby/1.8 includes WEBrick in standard distribution library.</dd> 
    …… 
    224261You don't have to install it if you are using ruby/1.8 or later.</dd> 
    225262 
    226 <dt class="path"><a href="http://raa.ruby-lang.org/list.rhtml?name=uconv">[RAA:uconv]</a> (0.4.10) (required for UTF-8 handling under ruby/1.6)</dt> 
     263<dt class="path"><a href="http://raa.ruby-lang.org/list.rhtml?name=uconv">[RAA:uconv]</a> (0.4.10) (required for UTF-8 handling under ruby/1.6 or under ruby/1.8 without iconv)</dt> 
    227264<dd>by Yoshida Masato. 
    228265It is requred when you use ruby/1.6 and want automatic CES conversion between 
    229266SJIS &lt;-&gt; UTF8 and EUC &lt;-&gt; UTF8. 
    230 Under ruby/1.8, soap4r uses iconv in standard distribution library. 
     267Under ruby/1.8, soap4r uses iconv in standard distribution library (if you installed it). 
    231268Note: SJIS &lt;-&gt; EUC uses NKF module which is in standard distribution. 
    232 I will support Iconv for more conversion set. 
    233269</dd> 
    234270 
    …… 
    240276Samples are in sample/ directory of distribution. 
    241277Some samples try to connect to public servers. 
    242 Set environment variable HTTP_PROXY if you are in a firewall and you have 
     278Set environment variable SOAP_USE_PROXY and HTTP_PROXY if you are in a firewall and you have 
    243279http proxy to the internet like; 
    244280</p> 
    245281<pre class="path"> 
     282$ export SOAP_USE_PROXY=on 
    246283$ export HTTP_PROXY=http://myproxyserver:8080 
    247284  or 
     285$ setenv SOAP_USE_PROXY on 
    248286$ setenv HTTP_PROXY http://myproxyserver:8080 
    249287</pre> 
    …… 
    547585 
    548586<dl> 
     587<dt>1.5.2 - December 25, 2003</dt> 
     588<dd> 
     589<ul> 
     590  <li>License; 
     591  <ul> 
     592    <li>Changed license from GPL2 to Ruby's.</li> 
     593  </ul></li> 
     594 
     595  <li>Features; 
     596  <ul> 
     597    <li>Add SOAP Messages with Attachments (SwA) support. 
     598    Patched by Jamie Herre. 
     599    &quot;SOAP Messages with Attachments&quot; is the W3C Note which defines a 
     600    binding for a SOAP 1.1 message to be carried within a MIME 
     601    multipart/related message.  <a href="http://www.w3.org/TR/SOAP-attachments">http://www.w3.org/TR/SOAP-attachments</a> 
     602    This feature is still experimental.  Interop testing is going on.</li> 
     603 
     604    <li>HTTPS support even when you use net/http (not http-access2). 
     605    Patched by Oliver M. Bolzer.</li> 
     606 
     607    <li>Property file support.  SOAP and WSDL client reads &quot;soap/property&quot; 
     608    file located at somewhere in $: (ruby libray locations).  For 
     609    example, save these lines to 
     610    &quot;$rubylibdir/site_ruby/1.8/soap/property&quot;. 
     611<pre> 
     612      client.protocol.http.proxy = http://myproxy:8080 
     613      client.protocol.http.no_proxy = 192.168.71.71,192.168.71.72 
     614</pre> 
     615    Then all HTTP connections should use these proxy and no_proxy 
     616    definition.</li> 
     617 
     618    <li>Do not trust "HTTP_PROXY" environment variable by default to 
     619    avoid security problem.  cf. 
     620    <ul> 
     621      <li><a href="http://ftp.ics.uci.edu/pub/websoft/libwww-perl/archive/2001h1/0072.html">http://ftp.ics.uci.edu/pub/websoft/libwww-perl/archive/2001h1/0072.html</a></li> 
     622      <li><a href="http://ftp.ics.uci.edu/pub/websoft/libwww-perl/archive/2001h1/0241.html">http://ftp.ics.uci.edu/pub/websoft/libwww-perl/archive/2001h1/0241.html</a></li> 
     623      <li><a href="http://curl.haxx.se/mail/archive-2001-12/0034.html">http://curl.haxx.se/mail/archive-2001-12/0034.html</a></li>  
     624    </ul> 
     625    To use HTTP_PROXY and NO_PROXY environment variable, you must set 
     626    SOAP_USE_PROXY environment variable 'on', too. 
     627<pre> 
     628      bash$ soap_use_proxy=on http_proxy=http://myproxy:8080 ruby ... 
     629      csh$  env soap_use_proxy=on http_proxy=http://myproxy:8080 ruby ... 
     630</pre></li> 
     631 
     632    <li>Add SOAP::RPC::Driver#mandatorycharset= and 
     633    SOAP::WSDLDriver#mandatorycharset= interface to force using 
     634    charset when parsing response from buggy server such as AWS.</li> 
     635 
     636    <li>Support a halfway-typed multi-ref array that Axis dumps.</li> 
     637 
     638    <li>Added a interface XSD::Charset.encoding= to control internal 
     639    encoding scheme.  Internal encoding scheme was fixed to 'utf-8' 
     640    when iconv or uconv was installed.  You can set 'euc-jp', etc. 
     641    to avoid encoding scheme conversion if you know what encoding 
     642    scheme the server uses.</li> 
     643  </ul></li> 
     644 
     645  <li>Bug fixes; 
     646  <ul> 
     647    <li>SOAP::Marshal.unmarshal: raise an exception if parse fails. 
     648    (returned nil)</li> 
     649 
     650    <li>SOAP::WSDLDriver: decode unknown element according to self-defined 
     651    type even if WSDL was given.</li> 
     652 
     653    <li> SOAP::Mapping::Factory#create_empty_object: fix Class#allocate 
     654    emulation code for ruby/1.6.  no effective change under ruby/1.8.</li> 
     655 
     656    <li>SOAP::RPC::SOAPMethodResponse: element name of response message 
     657    could have the name other than 'return'.</li> 
     658 
     659    <li>SOAP::RPC::StandaloneServer: add methods 'shutdown' and 'status' 
     660    as delegates to WEBrick.</li> 
     661 
     662    <li>WSDL::SOAP::ClassDefCreator: WSDL/1.1 allows plural fault 
     663    definition in a operation.</li> 
     664 
     665    <li>XSD::Charset.init: use cp932 under emx. 
     666    Patched by Siena. / SHINAGAWA, Norihide.</li> 
     667  </ul></li> 
     668</ul></dd> 
     669 
    549670<dt>1.5.1 - November  2, 2003</dt> 
    550 <dd>Important news:  Soap4r library is included in ruby distribution after 
    551 ruby/1.8.1.  You might not be need to install this package under ruby/1.8. 
    552 The files this package includes and are not included in ruby/1.8 distribution 
    553 are an application program (bin/wsdl2ruby) and some test codes. 
    554 Consider 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  
     671<dd> 
    560672<ul> 
    561673  <li>Features;