Changeset 1886
- Timestamp:
- 07/16/07 00:20:39 (1 year ago)
- Files:
-
- trunk/RELEASE_en.html (modified) (6 diffs)
Legend:
- Unmodified
- Added
- Removed
- Modified
- Copied
- Moved
trunk/RELEASE_en.html
r1882 r1886 19 19 20 20 <p class="status"> 21 Last modified: Jul 8, 2007<br />21 Last modified: Jul 16, 2007<br /> 22 22 Created: July 17, 2000 23 23 </p> … … 56 56 Here are changes in 1.5.7 from 1.5.6. 57 57 </p> 58 <ul><li>SOAP/Ruby mapping 58 <ul><li>Environment 59 <ul><li>soap4r gem depends on httpclient >= 2.1.0. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/379" title="let soap4r gem depends on httpclient >= 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 59 62 <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<->obj based on XML Schema (closed)">#363</a>) 64 60 65 </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>) 61 66 </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>) 62 67 </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>) 63 68 </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 65 69 </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 66 71 </li></ul></li></ul><ul><li>RPC 67 72 <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>) 68 73 </li></ul></li></ul><ul><li>Payload 69 74 <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>) 71 76 72 77 </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 "part" 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<->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 "part" definition directly (closed)">#367</a>) 77 80 </li><li>[BUG] wsdl2ruby.rb did not generate a classdef entry for empty element definition such as <element name="foo"/>. let wsdl2ruby.rb generate 'class Foo < 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>) 78 81 </li></ul></li></ul> … … 173 176 174 177 <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. 178 SOAP4R is written in <a href="http://www.ruby-lang.org">Ruby</a> and aims to use with Ruby application. 179 You have to install ruby itself. Tested against the following ruby versions. 179 180 </p> 180 <ul> 181 182 <ul> 183 <li>ruby-1.8.5</li> 184 <li>ruby-1.8.5 patchlevel 52</li> 181 185 <li>ruby-1.8.6</li> 182 <li>ruby-1. 6.8</li>186 <li>ruby-1.8.6 patchlevel 36</li> 183 187 </ul> 184 188 … … 189 193 </p> 190 194 191 <h3><span class="content">for ruby-1.8.6</span></h3>192 193 195 <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> 195 197 <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> 198 httpclient is formerly known as http-access2.</dd> 198 199 199 200 <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> … … 206 207 </dl> 207 208 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 between226 SJIS <-> UTF8 and EUC <-> UTF8.227 Note: SJIS <-> EUC uses NKF module which is in standard distribution.228 </dd>229 230 </dl>231 232 209 <h2 id="samples" name="samples"><span class="content">6. Samples</span></h2> 233 210 … … 235 212 Samples are in sample/ directory of distribution. 236 213 Some samples try to connect to public servers. 237 Set environment variable SOAP_USE_PROXY andHTTP_PROXY if you are in a firewall and you have214 Set environment variable HTTP_PROXY if you are in a firewall and you have 238 215 http proxy to the internet like; 239 216 </p> 240 217 <pre class="path"> 241 $ export SOAP_USE_PROXY=on242 218 $ export HTTP_PROXY=http://myproxyserver:8080 243 219 or 244 $ setenv SOAP_USE_PROXY on245 220 $ setenv HTTP_PROXY http://myproxyserver:8080 246 221 </pre>