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

Changeset 374

Show
Ignore:
Timestamp:
12/05/01 13:09:20 (7 years ago)
Author:
nakahiro
Message:

Docs for 1.4

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • trunk/RELEASE_en.html

    r326 r374  
    1919 
    2020<p class="status"> 
    21 Last modified: October 4, 2001<br /> 
     21Last modified: December 5, 2001<br /> 
    2222Created: July 17, 2000 
    2323</p> 
    …… 
    3434 
    3535<p> 
    36 Target SOAP4R version: SOAP4R/1.3.8 
     36Target SOAP4R version: SOAP4R/1.4 
    3737</p> 
    3838 
    …… 
    5151<h2 id="changes" name="changes">1. Changes</h2> 
    5252 
    53 <p> 
    54 Feedback from 
    55 <a href="http://www.whitemesa.com/interop.htm">SOAPBuilders Interoperability Lab &quot;Round 2&quot;</a> 
    56 and Michael Neumann.  Thanks! 
    57 </p> 
    58  
    5953<ul> 
    6054<li>Datatypes: 
    6155<ul> 
    62 <li>XSDFloat: Creating float data from junk string such as "123.0junk" was 
    63   converted to 0.0.  It should be avoided.  Fixed.</li> 
    64 <li>XSDFloat: Fixed double -&gt; single rounding code.</li> 
     56<li>XSDFloat: Bug in rounding double float to single float.  Fixed.</li> 
     57<li>SOAPElement: Added for literal encoding.</li> 
     58<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> 
     59<li>SOAPHeaderItem: Changed interface for easy use.</li> 
     60</ul></li> 
     61 
     62<li>SOAP Encoding: 
     63<ul> 
     64<li>Encoding by itself, not using NQXML's tree object model.</li> 
     65<li>At last, supported multi-ref encoding!</li> 
     66<li>marshal.rb: Marshalling with Envelope and Body.  To marshal multi-ref'd object, Body is needed. CAUTION: Not compatible between former implementation.</li> 
     67<li>Add EncodingStyleHandlerLiteral and set it to default.</li> 
     68<li>Renamed encoding.rb to encodingStyleHandler.rb.</li> 
     69<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> 
     70<li>Changed element name escape. 
     71<ul> 
     72<li>:: &lt;=&gt; \.\.</li> 
     73<li>[^a-zA-Z0-9_-] &lt;=&gt; \.[0-F][0-F] 
     74</ul> 
     75Limitation: 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> 
    6576</ul></li> 
    6677 
    6778<li>RPC related functions: 
    6879<ul> 
    69 <li>Changed typename <=> NCName strategy.  '::' &lt;=&gt; '.'</li> 
    70 <li>Added mappingRegistry argument to interfaces for SOAP object creation.</li> 
    71 </ul></li> 
    72  
    73 <li>Others: 
    74 <ul> 
    75 <li>Set faultstring '(No faultstring)' to SOAP Fault when empty faultstring element.</li> 
    76 <li>server.rb: Added mappingRegistry interface.</li> 
    77 <li>marshal.rb: Create NCName from typename.</li> 
     80<li>Driver: Added 'invoke' method for messaging.</li> 
     81<li>Driver: Content of SOAPFault detail element is set in the exception which is thrown from SOAP Node to client application.</li> 
     82<li>Processor: Changed Processor.(un|)marshal interface.  An instance of NS for parsing/generating XML instance is prepared in parser/generator.</li> 
     83<li>mappingRegistry.rb is devided from rpcUtils.rb.</li> 
    7884</ul></li> 
    7985</ul> 
    …… 
    106112 
    107113<dt class="path">GServer</dt> 
    108 <dd>by John W. Small</dd> 
     114<dd>by John W. Small: <a href="http://fairfax2.laser.net/~jsmall/rubycorner.html">http://fairfax2.laser.net/~jsmall/rubycorner.html</a></dd> 
    109115 
    110116<dt class="path">httpserver.rb</dt> 
    …… 
    213219It does not works on 1.4 series because of class variable.</li> 
    214220 
    215 <li>SOAP4R delegates XML related processing to 
    216 <a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=NQXML">NQXML module</a>. 
    217 You have to install NQXML module.</li> 
    218  
    219 <li>To play with SOAP-RPC client sample, you have to install 
    220 <a href="http://xml.apache.org/soap/">Apache SOAP</a>. 
    221 </li> 
     221<li>SOAP4R requires a XML processor package installed. 
     222For now, one of following XML processor must be installed 
     223 (SOAP4R automatically detects it in runtime). 
     224<ul> 
     225<li><a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=NQXML">NQXML module</a></li> 
     226<li><a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=XMLParser">XMLParser module</a></li> 
     227</ul></li> 
    222228</ul> 
    223229 
    …… 
    241247<li>encoding/decoding using XML Schema; 
    242248Only xsi:type in SOAP Encoding is checked</li> 
    243 <li>Marshalling references to href/id (Unmarshalling is OK)</li> 
    244249</ul></li> 
    245250<li style="margin-top: 2ex;">Othres 
    …… 
    253258 
    254259<dl> 
     260<dt>1.4 - December 5, 2001</dt> 
     261<dd><ul> 
     262<li>Datatypes: 
     263<ul> 
     264<li>XSDFloat: Bug in rounding double float to single float.  Fixed.</li> 
     265<li>SOAPElement: Added for literal encoding.</li> 
     266<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> 
     267<li>SOAPHeaderItem: Changed interface for easy use.</li> 
     268</ul></li> 
     269 
     270<li>SOAP Encoding: 
     271<ul> 
     272<li>Encoding by itself, not using NQXML's tree object model.</li> 
     273<li>At last, supported multi-ref encoding!</li> 
     274<li>marshal.rb: Marshalling with Envelope and Body.  To marshal multi-ref'd object, Body is needed. CAUTION: Not compatible between former implementation.</li> 
     275<li>Add EncodingStyleHandlerLiteral and set it to default.</li> 
     276<li>Renamed encoding.rb to encodingStyleHandler.rb.</li> 
     277<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> 
     278<li>Changed element name escape. 
     279<ul> 
     280<li>:: &lt;=&gt; \.\.</li> 
     281<li>[^a-zA-Z0-9_-] &lt;=&gt; \.[0-F][0-F] 
     282</ul> 
     283Limitation: 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> 
     284</ul></li> 
     285 
     286<li>RPC related functions: 
     287<ul> 
     288<li>Driver: Added 'invoke' method for messaging.</li> 
     289<li>Driver: Content of SOAPFault detail element is set in the exception which is thrown from SOAP Node to client application.</li> 
     290<li>Processor: Changed Processor.(un|)marshal interface.  An instance of NS for parsing/generating XML instance is prepared in parser/generator.</li> 
     291<li>mappingRegistry.rb is devided from rpcUtils.rb.</li> 
     292</ul></li> 
     293</ul></dd> 
     294 
     295 
    255296<dt>1.3.8 - October 4, 2001</dt> 
    256297<dd>Feedback from 

  • trunk/RELEASE_ja.html

    r326 r374  
    1919 
    2020<p class="status"> 
    21 Last modified: October 4, 2001<br /> 
     21Last modified: December 5, 2001<br /> 
    2222Created: July 15, 2000 
    2323</p> 
    …… 
    3636<p> 
    3737$BK\J8=q$,BP>]$H$7$F$$$k(BSOAP4R$B$N%P!<%8%g%s$O!$(B 
    38 SOAP4R/1.3.8 
     38SOAP4R/1.4 
    3939$B$G$9!%(B 
    4040</p> 
    …… 
    5454<h2 id="changes" name="changes">1. Changes</h2> 
    5555 
    56 <p> 
    57 <a href="http://www.whitemesa.com/interop.htm">SOAPBuilders Interoperability Lab &quot;Round 2&quot;</a> 
    58 $B$G8!=P$5$l$?Hs8_49@-!$$*$h$S(BMichael Neumann$B$5$s$+$i$NJs9p$K4p$E$/=$@5!%(B 
    59 </p> 
    60  
    6156<ul> 
    6257<li>$B%G!<%?7?(B: 
    6358<ul> 
    64 <li>XSDFloat: '123.0junk'$B$N$h$&$J0[>o%G!<%?$,(B0.0$B$KJQ49$5$l$F$$$^$7$?!%(B 
    65 $B$3$l$O6X;_$5$l$k$Y$-$G$9!%=$@5$7$^$7$?!%(B</li> 
    66 <li>XSDFloat: $BG\@:EY(B-&gt;$BC1@:EYJQ49%3!<%I$r=$@5$7$^$7$?!%(B</li> 
     59<li>XSDFloat: double float$B$r(Bsingle float$B$K4]$a$k:]$K%P%0$,$"$j$^$7$?!%=$@5$5$l$^$7$?!%(B</li> 
     60<li>SOAPElement: literal encoding$B!J(Bencoding$B$;$:$K(BXML$B$rKd$a9~$`!K$N$?$a$KDI2C$5$l$^$7$?!%(B</li> 
     61<li>SOAP data model(baseData.rb)$B$+$i(Bencoding$B4XO"5!G=$r<h$j=|$-$^$7$?!%(BEncondingStyleHandler$B$,E,59H=CG$9$Y$-$G$9!%(B</li> 
     62<li>SOAPHeaderItem: $B$h$j;H$$0W$/%$%s%?%U%'%$%9$rJQ99$7$^$7$?!%(B</li> 
     63</ul></li> 
     64 
     65<li>SOAP Encoding: 
     66<ul> 
     67<li>NQXML$B$NLZ9=B$%b%G%k$KMj$i$:!$<+A0$G(Bencoding$B$7$^$9!%(B</li> 
     68<li>$B$D$$$KB?=E;2>H$N(Bencoding$B$r<BAu$7$^$7$?(B!</li> 
     69<li>marshal.rb: Envelope$B$H(BBody$B$rH<$J$C$F(Bmarshal$B$9$k$h$&$K$J$j$^$7$?!%(B 
     70SOAP Encoding$B$G$O!$B?=E;2>H$N(Bencoding$B$N$?$a$K(BBody$B$,I,MW$G$9!%(B 
     71$BCm0U(B: $B=>Mh$N<BAu$H$N8_49@-$,$"$j$^$;$s!%(B</li> 
     72<li>literal encoding$B$N%O%s%I%i$rDI2C$7!$$3$l$r(Bdefault$B$H$7$^$7$?!%(B</li> 
     73<li>encoding.rb$B$r(BencodingStyleHandler.rb$B$KL>A0$rJQ$($^$7$?!%(B</li> 
     74<li>ASP.NET$B$N(Bencoding handler$B$rDI2C$7$^$7$?!%(BASP.NET$B$O%G%U%)%k%H$G$O(Bliteral encoding$B$r;HMQ$7$^$9$,!$85$O$H$$$($P$d$C$Q$j4X?t$HG[Ns$G$"$k$?$a!$<u$1B&$G$b$=$l$C$]$/(Bdecode$B$7$?$[$&$,JXMx$G$9!J(BDOM$B%W%m%0%i%_%s%0$J$s$+$7$?$/$J$$!K!%(B</li> 
     75<li>$BMWAGL>$N(Bescape$BJ}K!$rJQ99$7$^$7$?!%(B 
     76<ul> 
     77<li>:: &lt;=&gt; \.\.</li> 
     78<li>[^a-zA-Z0-9_-] &lt;=&gt; \.[0-F][0-F] 
     79</ul> 
     80$B@)8B(B: SOAP4R$B$N(BRPC$B4XO"5!G=$r;H$&>l9g!$%a%=%C%IL>!$%/%i%9L>!$%a%s%PL>$K(B'.'$B$r4^$`(Bobject$B$NE>Aw$r9T$J$&$3$H$O$G$-$^$;$s!%(BRuby$B$NJ8K!E*$K$O$3$l$GLdBj$J$$$O$:$G$9!%(B</li> 
    6781</ul></li> 
    6882 
    6983<li>RPC$B4XO"5!G=(B: 
    7084<ul> 
    71 <li>Ruby$B$N7?L>$H(BXML$BMWAGMQ$N(BNCName$B$NBP1~IU$1@oN,$rJQ99$7$^$7$?!%(B 
    72 'Foo::Bar'$B$H$$$&7?$r(B'Foo.Bar'$B$H$$$&MWAG$KBP1~$5$;$^$9!%(B</li> 
    73 <li>SOAP$B%*%V%8%'%/%H@8@.MQ$N%X%k%Q4X?t$K!$(BmappingRegistry$B$rEO$;$k$h$&$K$7$^$7$?!%(B</li> 
    74 </ul></li> 
    75  
    76 <li>$B$=$NB>(B: 
    77 <ul> 
    78 <li>SOAP Fault$B$N(Bfaultstring$B$,6u$N;~$K!$(B'(No faultstring)'$B$H$$$&J8;zNs$r%;%C%H$7$^$9!%(B</li> 
    79 <li>server.rb: mappingRegistry$B$r%;%C%H$9$k%$%s%?%U%'%$%9$rDI2C$7$^$7$?!%(B</li> 
    80 <li>marshal.rb: $B7?L>$+$i(BNCName$B$r@8@.$7$^$9!%(B</li> 
     85<li>Driver: $B%a%C%;!<%8%s%0$r9T$J$&$?$a$N%a%=%C%I!$(B'invoke'$B$rDI2C$7$^$7$?!%(B</li> 
     86<li>Driver: SOAP Fault$B$N(Bdetail$BMWAG$NCf?H$r!$(BDriver$B$+$i%f!<%6%"%W%j%1!<%7%g%s$KJV$9Nc30$NCf$K%;%C%H$9$k$h$&$K$7$^$7$?!%(B</li> 
     87<li>Processor: marshal/unmarshal$B$N%$%s%?%U%'%$%9$rJQ99$7$^$7$?!%(B</li> 
     88<li>mappingRegistry.rb$B$,(BrpcUtils.rb$B$+$iJ,N%$7$^$7$?!%(B</li> 
    8189</ul></li> 
    8290</ul> 
    …… 
    103111<dl> 
    104112<dt class="path">date3.rb</dt> 
    105 <dd>by $B$U$J$P$5$s!J(B<a href="http://www.kt.rim.or.jp/~tadf/ruby.html">http://www.kt.rim.or.jp/~tadf/ruby.html</a>$B!K(B</dd> 
     113<dd>by $B$U$J$P$5$s(B: <a href="http://www.kt.rim.or.jp/~tadf/ruby.html">http://www.kt.rim.or.jp/~tadf/ruby.html</a></dd> 
    106114 
    107115<dt class="path">parsedate3.rb</dt> 
    108 <dd>by $B$U$J$P$5$s!J(B<a href="http://www.kt.rim.or.jp/~tadf/ruby.html">http://www.kt.rim.or.jp/~tadf/ruby.html</a>$B!K(B</dd> 
     116<dd>by $B$U$J$P$5$s(B: <a href="http://www.kt.rim.or.jp/~tadf/ruby.html">http://www.kt.rim.or.jp/~tadf/ruby.html</a></dd> 
    109117 
    110118<dt class="path">GServer</dt> 
    111 <dd>by John W. Small</dd> 
     119<dd>by John W. Small: <a href="http://fairfax2.laser.net/~jsmall/rubycorner.html">http://fairfax2.laser.net/~jsmall/rubycorner.html</a></dd> 
    112120 
    113121<dt class="path">httpserver.rb</dt> 
    …… 
    223231$B%/%i%9JQ?t$r;H$C$F$$$k$?$a!$(B1.4$B7O$G$OF0$-$^$;$s!%(B</li> 
    224232 
    225 <li>SOAP4R$B$O(BXML$B4XO"$N=hM}$r(B 
    226 <a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=NQXML">NQXML module</a> 
    227 $B$K0MB8$7$F$$$^$9!%(B 
    228 NQXML$B%b%8%e!<%k$r%$%s%9%H!<%k$7$F$*$/I,MW$,$"$j$^$9!%(B</li> 
    229  
    230 <li>SOAP-RPC$B%/%i%$%"%s%H%5%s%W%k$rF0$+$9$?$a$K$O!$(B 
    231 <a href="http://xml.apache.org/soap/">Apache SOAP</a> 
    232 $B$,I,MW$G$9!%(B 
    233 </li> 
     233<li>SOAP4R$B$O(BXML$B4XO"$N=hM}$N$?$a$K!$(BXML$B%W%m%;%C%5$rI,MW$H$7$^$9!%(B 
     234$B:#$N$H$3$m!$0J2<$N$$$:$l$+$N(BXML$B%W%m%;%C%5%b%8%e!<%k$,%$%s%9%H!<%k$5$l$F$$$k(B 
     235$BI,MW$,$"$j$^$9!J(BSOAP4R$B$,<B9T;~$K<+F08!=P$7$^$9!K!%(B 
     236<ul> 
     237<li><a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=NQXML">NQXML module</a></li> 
     238<li><a href="http://www.ruby-lang.org/en/raa-list.rhtml?name=XMLParser">XMLParser module</a></li> 
     239</ul></li> 
    234240</ul> 
    235241 
    …… 
    254260<li>XML Schema$B$rFI$s$G(Bencode/decode$B$9$k$3$H$O$G$-$^$;$s!%(B 
    255261SOAP Encoding$BK\BN$KKd$a9~$^$l$?(Bxsi:type$B$N$_$rMxMQ$7$^$9!%(B</li> 
    256 <li>$BB?=E;2>H$X$N(Bmarshalling$B!J(Bunmarshalling$B$O2DG=$G$9!K(B</li> 
    257262</ul></li> 
    258263<li style="margin-top: 2ex;">$B$=$NB>(B 
    …… 
    266271 
    267272<dl> 
     273<dt>1.4 - December 5, 2001</dt> 
     274<dd> 
     275<ul> 
     276<li>$B%G!<%?7?(B: 
     277<ul> 
     278<li>XSDFloat: double float$B$r(Bsingle float$B$K4]$a$k:]$K%P%0$,$"$j$^$7$?!%=$@5$5$l$^$7$?!%(B</li> 
     279<li>SOAPElement: literal encoding$B!J(Bencoding$B$;$:$K(BXML$B$rKd$a9~$`!K$N$?$a$KDI2C$5$l$^$7$?!%(B</li> 
     280<li>SOAP data model(baseData.rb)$B$+$i(Bencoding$B4XO"5!G=$r<h$j=|$-$^$7$?!%(BEncondingStyleHandler$B$,E,59H=CG$9$Y$-$G$9!%(B</li> 
     281<li>SOAPHeaderItem: $B$h$j;H$$0W$/%$%s%?%U%'%$%9$rJQ99$7$^$7$?!%(B</li> 
     282</ul></li> 
     283 
     284<li>SOAP Encoding: 
     285<ul> 
     286<li>NQXML$B$NLZ9=B$%b%G%k$KMj$i$:!$<+A0$G(Bencoding$B$7$^$9!%(B</li> 
     287<li>$B$D$$$KB?=E;2>H$N(Bencoding$B$r<BAu$7$^$7$?(B!</li> 
     288<li>marshal.rb: Envelope$B$H(BBody$B$rH<$J$C$F(Bmarshal$B$9$k$h$&$K$J$j$^$7$?!%(B 
     289SOAP Encoding$B$G$O!$B?=E;2>H$N(Bencoding$B$N$?$a$K(BBody$B$,I,MW$G$9!%(B 
     290$BCm0U(B: $B=>Mh$N<BAu$H$N8_49@-$,$"$j$^$;$s!%(B</li> 
     291<li>literal encoding$B$N%O%s%I%i$rDI2C$7!$$3$l$r(Bdefault$B$H$7$^$7$?!%(B</li> 
     292<li>encoding.rb$B$r(BencodingStyleHandler.rb$B$KL>A0$rJQ$($^$7$?!%(B</li> 
     293<li>ASP.NET$B$N(Bencoding handler$B$rDI2C$7$^$7$?!%(BASP.NET$B$O%G%U%)%k%H$G$O(Bliteral encoding$B$r;HMQ$7$^$9$,!$85$O$H$$$($P$d$C$Q$j4X?t$HG[Ns$G$"$k$?$a!$<u$1B&$G$b$=$l$C$]$/(Bdecode$B$7$?$[$&$,JXMx$G$9!J(BDOM$B%W%m%0%i%_%s%0$J$s$+$7$?$/$J$$!K!%(B</li> 
     294<li>$BMWAGL>$N(Bescape$BJ}K!$rJQ99$7$^$7$?!%(B 
     295<ul> 
     296<li>:: &lt;=&gt; \.\.</li> 
     297<li>[^a-zA-Z0-9_-] &lt;=&gt; \.[0-F][0-F] 
     298</ul> 
     299$B@)8B(B: SOAP4R$B$N(BRPC$B4XO"5!G=$r;H$&>l9g!$%a%=%C%IL>!$%/%i%9L>!$%a%s%PL>$K(B'.'$B$r4^$`(Bobject$B$NE>Aw$r9T$J$&$3$H$O$G$-$^$;$s!%(BRuby$B$NJ8K!E*$K$O$3$l$GLdBj$J$$$O$:$G$9!%(B</li> 
     300</ul></li> 
     301 
     302<li>RPC$B4XO"5!G=(B: 
     303<ul> 
     304<li>Driver: $B%a%C%;!<%8%s%0$r9T$J$&$?$a$N%a%=%C%I!$(B'invoke'$B$rDI2C$7$^$7$?!%(B</li> 
     305<li>Driver: SOAP Fault$B$N(Bdetail$BMWAG$NCf?H$r!$(BDriver$B$+$i%f!<%6%"%W%j%1!<%7%g%s$KJV$9Nc30$NCf$K%;%C%H$9$k$h$&$K$7$^$7$?!%(B</li> 
     306<li>Processor: marshal/unmarshal$B$N%$%s%?%U%'%$%9$rJQ99$7$^$7$?!%(B</li> 
     307<li>mappingRegistry.rb$B$,(BrpcUtils.rb$B$+$iJ,N%$7$^$7$?!%(B</li> 
     308</ul></li> 
     309</ul></dd> 
     310 
     311 
    268312<dt>1.3.8 - October 4, 2001</dt> 
    269313<dd><a href="http://www.whitemesa.com/interop.htm">SOAPBuilders Interoperability Lab &quot;Round 2&quot;</a>