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

Changeset 1886

Show
Ignore:
Timestamp:
07/16/07 00:20:39 (1 year ago)
Author:
nahi
Message:
  • release note updated for 1.5.7
Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • trunk/RELEASE_en.html

    r1882 r1886  
    1919 
    2020<p class="status"> 
    21 Last modified: Jul 8, 2007<br /> 
     21Last modified: Jul 16, 2007<br /> 
    2222Created: July 17, 2000 
    2323</p> 
     
    5656Here are changes in 1.5.7 from 1.5.6. 
    5757</p> 
    58 <ul><li>SOAP/Ruby mapping 
     58<ul><li>Environment 
     59<ul><li>soap4r gem depends on httpclient &gt;= 2.1.0. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/379" title="let soap4r gem depends on httpclient &gt;= 2.1.0 (closed)">#379</a>) 
     60</li><li>let soap4r http clients (SOAP::RPC::Driver and WSDL/XSD importers) do not check soap_use_proxy environment variable and use only http_proxy/HTTP_PROXY and no_proxy/NO_PROXY envvars for proxy configuration.  no need to set 'soap_use_proxy=on' envvar anymore.  But to avoid proxy injection problem, when a library is used on CGI environment (with checking REQUEST_METHOD envvar existence), soap4r http clients use cgi_http_proxy/CGI_HTTP_PROXY envvar instead of http_proxy/HTTP_PROXY. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/378" title="change HTTP_PROXY/NO_PROXY envvar behavior to follow httpclient (closed)">#378</a>) 
     61</li></ul></li></ul><ul><li>SOAP/Ruby mapping 
    5962<ul><li>try to call klass.soap_marshallable before mapping an XML element to the klass while unmarshalling. to avoid auto-mapping from element name, define klass.soap_marshallable method let it return false. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/223" title="avoid the AutoMapping (closed)">#223</a>) 
     63</li><li>let xsd2ruby.rb generate a mapping registry and a mapper from XML Schema definition. the mapper has obj2xml and xml2obj which uses the generated mapping registry. you can use this instead of XSD::Mapping.obj2xml and XSD::Mapping.xml2obj which does not know anything about mapping. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/362" title="classname parameter for bin/xsd2ruby.rb (closed)">#362</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/363" title="mapping xml&lt;-&gt;obj based on XML Schema (closed)">#363</a>) 
     64 
    6065</li><li>[BUG] Array or Struct was not properly marshalled when literal service + generated stub combination. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/360" title="Array or Struct is not properly marshalled through stub definition for  ... (closed)">#360</a>) 
    6166</li><li>[BUG] derived class was marshalled without xsi:type for literal service. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/361" title="derived class  is marshalled without xsi:type for literal service (closed)">#361</a>) 
    6267</li><li>[BUG] passing nil as a basetype through generated mapping registry was broken in 1.5.6. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/369" title="nil passed as attribute to axis service gets sent as an empty string  ... (closed)">#369</a>) 
    6368</li><li>[BUG] an rpc/encoded parameter could be wrongly typed when the parameter is typed as a derived type from a base type of XML Schema datatypes. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/371" title="an rpc/encoded parameter wrongly typed (closed)">#371</a>) 
    64  
    6569</li><li>[BUG] under the earlier versions, we could use [] instead of CountryTargets[]. from 1.5.6-GA it doesn't work. let LiteralRegistry decide how the class should be mapped to according to the defined class in the parent complexType. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/373" title="generic Array cannot be used instead of a custom array (closed)">#373</a>) 
     70 
    6671</li></ul></li></ul><ul><li>RPC 
    6772<ul><li>allow xsi:nil="true" element as an RPC request though I don't think it's SOAP spec compliant. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/374" title="SOAP::Lite incompatibility (closed)">#374</a>) 
    6873</li></ul></li></ul><ul><li>Payload 
    6974<ul><li>added an API for filtering streamhandler to capture/generate HTTP header. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/276" title="streamHandler filter to capture/create HTTP header (closed)">#276</a>) 
    70 </li><li>added 'protocol.http.auth' option to set authentication information for both BasicAuth and DigestAuth. with the latest http-access2, now soap4r client can connect to DigestAuth server. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/345" title="Client Digest Authentication Implemented (closed)">#345</a>) 
     75</li><li>added 'protocol.http.auth' option to set authentication information for both BasicAuth and DigestAuth. with the latest httpclient (formerly known as http-access2), now soap4r client can connect to DigestAuth server. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/345" title="Client Digest Authentication Implemented (closed)">#345</a>) 
    7176 
    7277</li></ul></li></ul><ul><li>WSDL 
    73 <ul><li>[BUG] error when simpleType element usage as "part" definition directly. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/367" title="error when simpleType element usage as &#34;part&#34; definition directly (closed)">#367</a>) 
    74 </li></ul></li></ul><ul><li>misc 
    75 <ul><li>let xsd2ruby.rb generate a mapping registry and a mapper from XML Schema definition. the mapper has obj2xml and xml2obj which uses the generated mapping registry. you can use this instead of XSD::Mapping.obj2xml and XSD::Mapping.xml2obj which does not know anything about mapping. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/362" title="classname parameter for bin/xsd2ruby.rb (closed)">#362</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/363" title="mapping xml&lt;-&gt;obj based on XML Schema (closed)">#363</a>) 
    76 </li><li>importer should not import <a class="ext-link" href="http://schemas.xmlsoap.org/soap/encoding/"><span class="icon">http://schemas.xmlsoap.org/soap/encoding/</span></a>. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/366" title="importer should not import http://schemas.xmlsoap.org/soap/encoding/ (closed)">#366</a>) 
     78<ul><li>importer should not import <a class="ext-link" href="http://schemas.xmlsoap.org/soap/encoding/"><span class="icon">http://schemas.xmlsoap.org/soap/encoding/</span></a>. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/366" title="importer should not import http://schemas.xmlsoap.org/soap/encoding/ (closed)">#366</a>) 
     79</li><li>[BUG] error when simpleType element usage as "part" definition directly. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/367" title="error when simpleType element usage as &#34;part&#34; definition directly (closed)">#367</a>) 
    7780</li><li>[BUG] wsdl2ruby.rb did not generate a classdef entry for empty element definition such as &lt;element name="foo"/&gt;. let wsdl2ruby.rb generate 'class Foo &lt; String'. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/370" title="empty element definition causes 'cannot find mapped class' warning (closed)">#370</a>) 
    7881</li></ul></li></ul> 
     
    173176 
    174177<p> 
    175 SOAP4R is written in <a href="http://www.ruby-lang.org">Ruby</a> and 
    176 aims to use with Ruby application. 
    177 You have to install Ruby itself. 
    178 Ruby/1.6 series or later is required. 
     178SOAP4R is written in <a href="http://www.ruby-lang.org">Ruby</a> and aims to use with Ruby application. 
     179You have to install ruby itself.  Tested against the following ruby versions. 
    179180</p> 
    180 <ul> 
     181 
     182<ul> 
     183  <li>ruby-1.8.5</li> 
     184  <li>ruby-1.8.5 patchlevel 52</li> 
    181185  <li>ruby-1.8.6</li> 
    182   <li>ruby-1.6.8</li> 
     186  <li>ruby-1.8.6 patchlevel 36</li> 
    183187</ul> 
    184188 
     
    189193</p> 
    190194 
    191 <h3><span class="content">for ruby-1.8.6</span></h3> 
    192  
    193195<dl> 
    194 <dt class="path"><a href="http://raa.ruby-lang.org/project/http-access2/">[RAA:http-access2]</a> (2.0.5) (required for SSL)</dt> 
     196<dt class="path"><a href="http://raa.ruby-lang.org/project/httpclient/">[RAA:httpclient]</a> (2.1.0 or later)</dt> 
    195197<dd>Yet another HTTP client implementation by NaHi. 
    196 It's not required when you don't use SSL, but it's recommended to use. 
    197 The author always runs and checks soap4r with http-access2.</dd> 
     198httpclient is formerly known as http-access2.</dd> 
    198199 
    199200<dt class="path"><a href="http://raa.ruby-lang.org/project/uconv/">[RAA:uconv]</a> (0.4.10) (not required but needed if your Ruby doesn't have iconv module and you need UTF-8 encoded Japanese chars)</dt> 
     
    206207</dl> 
    207208 
    208 <h3><span class="content">for ruby-1.6.8</span></h3> 
    209  
    210 <dl> 
    211 <dt class="path"><a href="http://raa.ruby-lang.org/project/webrick/">[RAA:webrick]</a> (1.3.1)</dt> 
    212 <dd>TCP server toolkit by Gotoyuzo.</dd> 
    213  
    214 <dt class="path"><a href="http://raa.ruby-lang.org/project/http-access2/">[RAA:http-access2]</a> (2.0.5)</dt> 
    215 <dd>Yet another HTTP client implementation by NaHi.</dd> 
    216  
    217 <dt class="path"><a href="http://raa.ruby-lang.org/project/devel-logger/">[RAA:devel-logger]</a> (1.1.0)</dt> 
    218 <dd>Logging utility by NaHi.</dd> 
    219  
    220 <dt class="path"><a href="http://raa.ruby-lang.org/project/date2/">[RAA:date2]</a> (3.2)</dt> 
    221 <dd>Date and DateTime implementation by Todayoshi Funaba.</dd> 
    222  
    223 <dt class="path"><a href="http://raa.ruby-lang.org/project/uconv/">[RAA:uconv]</a> (0.4.10) (required for UTF-8 handling)</dt> 
    224 <dd>by Yoshida Masato. 
    225 It is requred when you want automatic CES conversion between 
    226 SJIS &lt;-&gt; UTF8 and EUC &lt;-&gt; UTF8. 
    227 Note: SJIS &lt;-&gt; EUC uses NKF module which is in standard distribution. 
    228 </dd> 
    229  
    230 </dl> 
    231  
    232209<h2 id="samples" name="samples"><span class="content">6. Samples</span></h2> 
    233210 
     
    235212Samples are in sample/ directory of distribution. 
    236213Some samples try to connect to public servers. 
    237 Set environment variable SOAP_USE_PROXY and HTTP_PROXY if you are in a firewall and you have 
     214Set environment variable HTTP_PROXY if you are in a firewall and you have 
    238215http proxy to the internet like; 
    239216</p> 
    240217<pre class="path"> 
    241 $ export SOAP_USE_PROXY=on 
    242218$ export HTTP_PROXY=http://myproxyserver:8080 
    243219  or 
    244 $ setenv SOAP_USE_PROXY on 
    245220$ setenv HTTP_PROXY http://myproxyserver:8080 
    246221</pre>