forked from rubyjedi/soap4r
/
RELEASE_en.html
1900 lines (1704 loc) · 116 KB
/
RELEASE_en.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<?xml version="1.0"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<link rev="MADE" href="mailto:nahi@ruby-lang.org" />
<link rel="StyleSheet" href="rubyStyle.css" type="text/css" media="screen" />
<title>Release Notes - SOAP4R</title>
</head>
<body>
<div class="header">
<h1>
Release Notes - SOAP4R
</h1>
<p class="status">
Last modified: Sep 24, 2007<br />
Created: July 17, 2000
</p>
</div>
<hr />
<div class="main">
<h2><span class="content">0. In this document...</span></h2>
<p>
This is Release Notes of SOAP4R.
</p>
<p>
Target SOAP4R version: SOAP4R/1.5.8
</p>
<ol>
<li><a href="#changes">Changes</a></li>
<li><a href="#install">Install</a></li>
<li><a href="#uninstall">Uninstall</a></li>
<li><a href="#whats">What is SOAP4R?</a></li>
<li><a href="#dependencies">Dependencies</a></li>
<li><a href="#samples">Samples</a></li>
<li><a href="#resources">Resources</a></li>
<li><a href="#history">History</a></li>
<li><a href="#author">Author</a></li>
<li><a href="#copyright">Copyright</a></li>
</ol>
<h2 id="changes" name="changes"><span class="content">1. Changes</span></h2>
<p>
Version 1.5.8 has improved its XML Schema support, such as
class generation of XML Schema anonymous complexType,
full built-in datatypes support of XML Schema Datatypes, and more.
Here are changes in 1.5.8 from 1.5.7.
</p>
<ul><li>XML Schema
<ul><li>added classes for the last of built-in datatypes of XML Schema Datatypes (NMTOKEN, NMTOKENS, Name, NCName, ID, IDREF, IDREFS, ENTITY, and ENTITIES). lexical scope is not checked for these datatypes yet. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/340" title="Complete implementation of data types (xsd, soap) (closed)">#340</a>)
</li><li>added anonymous type support. wsdl2ruby.rb/xsd2ruby.rb maps anonymous type to inner class. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/355" title="let wsdl2ruby.rb support stub class generation of XML anonymous type (closed)">#355</a>)
</li><li>added support of all XML Schema facets for restriction. No validation implemented yet. do you want to validate XML messages by soap4r? (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/364" title="minInclusive/maxInclusive of simpleRestriction (closed)">#364</a>)
</li><li>added <xsd:attributeGroup> support. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/389" title="attributeGroup support (closed)">#389</a>)
</li><li>added <xsd:anyAttribute> support. just ignore anyAttribute because wsdll2ruby.rb now generates xmlattr method. use it for adding any attribute. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/390" title="anyAttribute support (closed)">#390</a>)
</li><li>added <xsd:group> support. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/391" title="group support (closed)">#391</a>)
</li><li>[BUG] XSD::XSDDuration should allow durations lower than a day. Thanks to an anonymous user for taking the time to file the ticket. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/401" title="XSDDuration doesn't support durations lower than a day (closed)">#401</a>)
</li><li>[BUG] choice handling bug fixed according to a patch from KR, Vesa Varimo. If there was choice element in complex type, soap4r didn't process all elements if the first element was an empty array. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/382" title="Choice definition in XSD (closed)">#382</a>)
</li><li>[BUG] some WSDL caused cyclic schema inclusion. <xsd:import> supported cyclic include but <xsd:include> did not. extract common implementation as importHandler.rb. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/385" title="cyclic schema include (closed)">#385</a>)
</li><li>[BUG] added supports of <xsd:complexType> definition inheritance. earlier soap4r supported only element definition inheritance. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/394" title="Abstract classes not being included in output - wsdsl2ruby, netsuite wsdl (closed)">#394</a>)
</li><li>[BUG] support <xsd:choice maxOccurs="unbounded"/>: treat it <xsd:all/> for now. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/400" title="choice + maxOccurs="unbounded" (closed)">#400</a>)
</li><li>[BUG] allow <xsd:any> appear twice or more. with the current implementation, soap4r ignores <xsd:any> element definition such as namespace and processContent. just allow any element appear. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/402" title="<any> can appear twice (closed)">#402</a>)
</li><li>[BUG] Type simpleType and simpleContent was unmarshalled as a String, not as an instance of the subclass which is generated by wsdl2ruby.rb. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/412" title="Type simpleType and simpleContent is unmarshalled as a String, not as an ... (closed)">#412</a>)
</li><li>[BUG] ignore xsd:element definition when the same qname is also defined as a xsd:complexType. it's a workaround for this version. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/413" title="what if the same name would be used in one XML namespace for an element ... (closed)">#413</a>)
</li><li>[BUG] wsdl2ruby.rb generated inconsistent class definition when the base class was :TYPE_ARRAY and the derived class was a :TYPE_STRUCT. let the derived class be a standalone (not a derived) class. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/424" title="wsdl2ruby.rb generates inconsistent class definition which derives an ... (closed)">#424</a>)
</li><li>[BUG] wsdl2ruby.rb generates incomplete encoded Array mapping registry for base64Binary[]. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/428" title="wsdl2rb produces incomplete mapping (closed)">#428</a>)
</li><li>[BUG] LiteralMappingRegistryCreator did not generate an entry for the element which type is mapped to an Array. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/432" title="LiteralMappingRegistryCreator does not generate an entry for the element ... (closed)">#432</a>)
</li></ul></li></ul><ul><li>SOAP
<ul><li>add :default_ns_tag option to configure a pre-defined Namespace tag. :default_ns is for configuring namespace definitions at SOAPEnvelope. :default_ns_tag is for configuring pre-defined namespace tag. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/383" title="let SOAP message use pre-defined namespace tag (closed)">#383</a>)
</li><li>login.live.com returns SOAPFault as a direct child of SOAPEnvelope. support it even though it's not spec compliant. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/384" title="login.live.com returns SOAPFault as a direct child of SOAPEnvelope (closed)">#384</a>)
</li><li>allow to remove mustUnderstand attribute from a SOAP Header. I heard that there's an implementation which cannot handle mustUnderstand existence. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/429" title="Removing env:mustUnderstand from header? (closed)">#429</a>)
</li><li>add the Generator option for using default namespace in SOAP message. it's for interoperability with non XML Namespace comformant implementation. false by default (same behavior as before.) you can turn it on with Driver#use_default_namespace = true or Server#use_default_namespace = true. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/430" title="add an option for forcing Generator use default namespace (closed)">#430</a>)
</li><li>[BUG] send xsi:nil=true element when literal + maxOccurs != 0 + nillable="true", not empty element. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/395" title="literal + nil + maxOccurs != 0 + nillable="true" (closed)">#395</a>)
</li><li>[BUG] do not crash when parsing an incomplete multi-dimensional array. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/397" title="`traverse_data': undefined method `[]' for nil:NilClass (NoMethodError) (closed)">#397</a>)
</li><li>[BUG] do not dump xsi:type for non-polymorphic type of literal service. there's an implementation which only allows xsd:type for polymorphic type hint. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/405" title="should send xsd:type for document/literal service only if needed (closed)">#405</a>)
</li><li>[BUG] a content of the stub class which is generated as a subclass of String by wsdl2ruby.rb was not properly encoded. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/415" title="A content of the stub class which is generated as a subclass of String by ... (closed)">#415</a>)
</li><li>[BUG] a value of XML attribute was not properly encoded. users who did XML-encode a value in SOAPElement#extraattr should care about this change (not needed from now.) (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/416" title="a value of XML attribute is not properly encoded (closed)">#416</a>)
</li><li>[BUG] XML encoding does not work properly depending on CES. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/417" title="XML encoding does not work properly depending on KCODE (closed)">#417</a>)
</li><li>[BUG] soap4r's XML namespace handler did not handle xmlns="" correctly. it means 'no default namespace'. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/421" title="xmlns="" means 'no default namespace' (closed)">#421</a>)
</li><li>[BUG] multi-refed basetype value was not be able to decode with generated EncodedRegistry. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/423" title="cannot decode multi-refed basetype value with generated MappingRegistry (closed)">#423</a>)
</li><li>[BUG] unqualified element 'Envelope', 'Header', 'Body' and 'Fault' caused an error while parsing. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/431" title="unqualified element 'Envelope', 'Header', 'Body' and 'Fault' causes an ... (closed)">#431</a>)
</li><li>[BUG] illegal marshaling a request for rpc/literal + parameter is a built-in basetype of XML Schema + message is defined as "type" (not "element"). fixed. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/434" title="illegal marshaling a request for rpc/literal + parameter is a built-in ... (closed)">#434</a>)
</li></ul></li></ul><ul><li>SOAP/Ruby mapping
<ul><li>let MappingError be a NestedException and show original cause of MappingError. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/404" title="nested SOAP::Mapping::MappingError does not reported correctly (closed)">#404</a>)
</li><li>check illegal constant name before const_defined? call to avoid warnings. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/386" title="too many warnings about 'wrong constant name' from mapping.rb (closed)">#386</a>)
</li><li>added a header handler which utilize a mapping registry. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/425" title="HeaderHandler which utilize a mapping registry (closed)">#425</a>)
</li><li>[BUG] avoid NoMethodError when passing SOAPArray to LiteralRegistry. It's caused when a servant raised an exception in literal service. Thanks to Emil for contributing test case for it. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/393" title="NoMethodError when parsing the soap fault with the stack trace on the ... (closed)">#393</a>)
</li><li>[BUG] allow the Fixnum which have an instance variable to be marshalled. For Fixnum, ivars are not marshalled but allowed to be marshalled in Ruby's marshal. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/406" title="Fixnum + instance variable causes MappingError (closed)">#406</a>)
</li><li>[BUG] a Driver generated by a WSDLDriverFactory did not handle nested sequence/choice correctly. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/409" title="WSDLDriverFactory does not handle nested sequence/choice correctly (closed)">#409</a>)
</li><li>[BUG] a Driver generated by a WSDLDriverFactory ignored 'xmlattr_*' value in a Hash parameter. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/414" title="a Driver generated by WSDLDriverFactory does not accept XML attributes in ... (closed)">#414</a>)
</li><li>[BUG] let it be distinguishable <ele attr=""> from <ele> (no attribute in the element). now the former returns "" and the latter returns nil. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/418" title="cannot distinguish '' and nil as a value of XML attribute (closed)">#418</a>)
</li></ul></li></ul><ul><li>misc
<ul><li>added SOAP::WSDLDriverFactory#dump_method_signatures. it returns a formatted text which describes method signatures. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/141" title="SOAP::RPC::Driver#defined_webservice? ... (closed)">#141</a>)
</li><li>added servletStubCreator. wsdl2ruby.rb with --servlet_stub creates servlet stub for WEBrick. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/290" title="wsdl2ruby.rb to auto-generate code for use with Webrick (closed)">#290</a>)
</li><li>wsdl2ruby.rb generated too much 'XSD::QName.new(...)' parts. let wsdl2ruby.rb/xsd2ruby.rb extract common namespace definitions as constants. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/381" title="wsdl2ruby.rb generates too much 'XSD::QName.new(...)'s in a file (closed)">#381</a>)
</li><li>let wsdl2ruby.rb/xsd2ruby.rb generate member types as a comment for each class in classdef file. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/384" title="login.live.com returns SOAPFault as a direct child of SOAPEnvelope (closed)">#384</a>)
</li><li>do not raise warning when there's a simpleType definition which have non-enumeration restriction. Generated mapping registry wrongly contained references to undefined classes. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/399" title="many warnings: cannot find mapped class (closed)">#399</a>)
</li><li>[BUG] as a workaround of class name crash problem between generated class and generated driver, add --drivername_postfix option to wsdl2ruby.rb. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/372" title="name crashes between types(classdef names) and services(driver names) in ... (closed)">#372</a>)
</li><li>[BUG] soap4r without httpclient caused NameError. forgot to add required dependency in the previous release. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/403" title="wsdl2ruby without httpclient causes NameError ... (closed)">#403</a>)
</li></ul></li></ul>
<p>
Thanks to all of soap4r-ml members and soap4r users for their support.
And special thanks to following contributors;
</p>
<pre>
'Aaron Pfeifer' for contributing a patch for safemethodname.
'Andi Wundsam' for contributing a patch for net/http + no_proxy.
'anonymous contributor from Wall St.' for contributing a MSSOAP + Excel sample.
'Emil Marceta' for contributing a patch for one-way service support and many test cases that points a bug of soap4r.
'Ernie' for contributing a helloworld WSDL sample and WSDL service feature of HTTPServer.
'Felipe Contreras' for contributing an union + memberType sample, patches for missing 'require', and a patch to allow to customize default ns definition of SOAP Envelope.
'Greg Lappen' for contributing an eBaySvc sample.
'Ger Apeldoorn' for contributing a sample of complex type + MIME attachment.
'Jamie Herre' for contributing a SwA implementation.
'John Anderson' for contributing a patch for handling gzipped HTTP content.
'Junichi Uekawa' for contributing a HTTP redirection patch for net/http.
'Kent Sibilev' for contributing a patch for correct extraattr handling of SOAPHeaderItem.
'KR, Vesa Varimo' for contributing a patch for correct handling of XML Schema's choice element.
'Leoš Bitto' for contributing a patch for XML pretty print.
'Michael Neumann' for contributing an original implementation of standaloneServer.
'Oliver M. Bolzer' for contributing a patch for net/http + SSL.
'Owen Fraser-Green' for contributing a patch for MIME CRLF handling.
'Patrick Chanezon' for contributing a patch for wsdl2ruby classdef name option.
'Peter Gardfjäll' for contributing a patch for wsdl:fault handling.
'Sandi Metz' for contributing a patch for SwA in document/literal service.
'SHINAGAWA, Norihide' for contributing a patch for emx platform.
'Tadayoshi Funaba' for contributing a patch for date/time XMLSchema datatypes.
'UENO Katsuhiro' for xmlscan implementation.
'Walter Korman' for contributing soap4r.gemspec and a workaround patch for gem's require problem.
'wrex' for contributing a patch for soap4r to work with SalesForce service.
</pre>
<h2 id="install" name="install"><span class="content">2. Install</span></h2>
<p>
At first, see <a href="#dependencies">Dependencies</a> section.
You may need to install some extra packages.
Next, get the archived file of SOAP4R and extract it, then simply try;
</p>
<pre class="path">
$ ruby install.rb
</pre>
<p>
Necessary files will be installed to suitable directory.
</p>
<p>
Files and directories in lib directory are SOAP4R library program itself.
</p>
<dl>
<dt class="path">lib/</dt>
<dd>Libraries.</dd>
<dt class="path">sample/</dt>
<dd>SOAP4R samples.
See <a href="#samples">Samples</a> section.</dd>
<dt class="path">test/</dt>
<dd>Tests. It also contains useful sample scripts for servers and clients.
<br/>
test/interopR2/ directory includes Clients/Server for
<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
Followings are advanced examples to use complex type transmit,
sending base64 encoded string, multi-dimensional array, and so on.
<ul>
<li>test/interopR2/server.rb is a RPC Server side implementation.</li>
<li>test/interopR2/client.rb is a RPC Client side implementation.</li>
<li>test/interopR2/base.rb includes common definitions for client/server.</li>
</ul>
</dd>
</dl>
<h2 id="uninstall" name="uninstall"><span class="content">3. Uninstall</span></h2>
<p>
Simply delete installed files.
</p>
<h2 id="whats" name="whats"><span class="content">4. What is SOAP4R?</span></h2>
<p>
'SOAP4R' is an implementation of
<a href="http://www.w3.org/TR/SOAP/">SOAP 1.1 (W3C Note)</a>.
</p>
<p>
Comments, information such as interoperability between SOAP4R and another implementation are welcomed.
Feel free sending mail to
<a href="mailto:nahi@ruby-lang.org" class="path">nahi@ruby-lang.org</a>.
</p>
<h2 id="dependencies" name="dependencies"><span class="content">5. Dependencies</span></h2>
<p>
SOAP4R is written in <a href="http://www.ruby-lang.org">Ruby</a> and aims to use with Ruby application.
You have to install ruby itself. Tested against the following ruby versions.
</p>
<ul>
<li>ruby-1.8.5</li>
<li>ruby-1.8.5 patchlevel 52</li>
<li>ruby-1.8.6</li>
<li>ruby-1.8.6 patchlevel 36</li>
</ul>
<p>
SOAP4R depends on following Ruby modules in
<a href="http://raa.ruby-lang.org">RAA</a>.
You also have to install these modules to use SOAP4R.
</p>
<dl>
<dt class="path"><a href="http://raa.ruby-lang.org/project/httpclient/">[RAA:httpclient]</a> (2.1.0 or later) (required)</dt>
<dd>Yet another HTTP client implementation by NaHi.
httpclient is formerly known as http-access2.</dd>
<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>
<dd>by Yoshida Masato.
It is requred when you want automatic CES conversion between
SJIS <-> UTF8 and EUC <-> UTF8.
Note: SJIS <-> EUC uses NKF module which is in standard distribution.
</dd>
</dl>
<h2 id="samples" name="samples"><span class="content">6. Samples</span></h2>
<p>
Samples are in sample/ directory of distribution.
Some samples try to connect to public servers.
Set environment variable HTTP_PROXY if you are in a firewall and you have
http proxy to the internet like;
</p>
<pre class="path">
$ export HTTP_PROXY=http://myproxyserver:8080
or
$ setenv HTTP_PROXY http://myproxyserver:8080
</pre>
<h3><span class="content">basic/ ... basic samples</span></h3>
<dl>
<dt class="path">babelfish.rb</dt>
<dd>a SOAP client sample to connect to a babelfish server.</dd>
<dt class="path">whois.rb</dt>
<dd>a SOAP client sample to connect to a whois server.</dd>
<dt class="path">flickr.rb</dt>
<dd>a SOAP client sample to connect to the flickr SOAP server and extract data from XML response.</dd>
<dt class="path">yahooNewsSearch.rb</dt>
<dd>a HTTP client sample to connect to the Yahoo news search REST service and extract data from XML response.</dd>
<dt class="path">helloworld/</dt>
<dd>a SOAP server and client sample of 'Hello World'.
To run the server;
<pre class="path">
$ ./server.rb
</pre>
And to connect to the server, run the client;
<pre class="path">
$ ./client.rb
</pre>
</dd>
<dt class="path">calc/</dt>
<dd>Calc service contains 2 servers and 2 clients.
calc.rb is hosted by server.rb, calc2.rb is hosted by server2.rb.
client.rb is for server.rb, client2.rb is for server2.rb.
<dl>
<dt>calc.rb</dt>
<dd>Calc server definition using module and module methods.
This module responds 'add', 'sub', 'multi' and 'div'.
</dd>
<dt>server.rb</dt>
<dd>Standalone server.
It requires calc.rb and serve module methods of this module.
To run this server;
<pre class="path">
$ ./server.rb
</pre>
</dd>
<dt>server.cgi</dt>
<dd>CGI version.
To run this server, copy server.cgi and calc.rb to suitable
directory of your WWW server.
</dd>
<dt>client.rb</dt>
<dd>It connects to server.rb or server.cgi,
and hit methods served by calc.rb.
To run the client;
<pre class="path">
$ ./client.rb
</pre>
Is it stacked? Did you run the server.rb?<br/>
Turn logger and wireDumpDev in its source on to see logs and wire
dumps of SOAP transport.
</dd>
<dt>calc2.rb</dt>
<dd>Calc server definition using class and instance methods.
An instance of this class holds its value. Methods 'set' and 'get'
is to set/get the value.
It also responds to '+', '-', '*', and '/'.
</dd>
<dt>server2.rb</dt>
<dd>It requires calc2.rb and creates an instance of CalcService2
that responds all SOAP requests.
Since '+', '-' and so on of calc2.rb are not valid name as an
element in XML instance, this sample register the method '+' as
'add', '-' as 'sub', and so on.
</dd>
<dt>server2.cgi</dt>
<dd>CGI version.
To run this server, copy server2.cgi and calc2.rb to suitable
directory of your WWW server.
</dd>
<dt>client2.rb</dt>
<dd>It connects to server2.rb or server2.cgi.
Set a value at first and call methods like 'puts objAtServer + 2'.
</dd>
</dl>
</dd>
<dt class="path">exchange/</dt>
<dd>A sample to retrieve the currency rate from public SOAP service.
<dl>
<dt>iExchange.rb</dt>
<dd>It includes common definitions for client and server of
Exchange service. Including only a definition of namespace URI of
this service.</dd>
<dt>exchange.rb</dt>
<dd>Definition of servant class ExchangeService which returns the
currency rate after connecting to another site by SOAP to get the
real rate.
So that this class is the SOAP server for local client and
is also a SOAP client for public server.
An instance of this class is hosted by server.rb.
The instance responds to only 'getRate' which receives two country
code such as 'USA' and 'Japan'.</dd>
<dt>server.rb</dt>
<dd>It requires exchange.rb and creates an instance of
ExchangeService that responds all SOAP requests.
To run this server;
<pre class="path">
$ ./server.rb
</pre>
</dd>
<dt>server.cgi</dt>
<dd>CGI version. To run this server, copy server.cgi and exchange.rb
to suitable directory of your WWW server.</dd>
<dt>client.rb</dt>
<dd>It connects to server.rb. Turn logger and wireDumpDev in its
source on to see logs and wire dumps of SOAP transport.
To run the client;
<pre class="path">
$ ./client.rb
</pre>
</dd>
</dl>
</dd>
<dt class="path">sampleStruct/</dt>
<dd>A sample to transmit complex structured object which has recursive
object reference.
<dl>
<dt>iSampleStruct.rb</dt>
<dd>It includes common definitions for client and server of
SampleStruct service. Definition of SampleStruct class and
namespace URI of this service.</dd>
<dt>sampleStruct.rb</dt>
<dd>Definition of servant class SampleStructService.
An instance of this class is hosted by server.rb.
The instance responds to only 'hi' which receives a SampleStruct
and wraps it in the new instance of SampleStruct to return .</dd>
<dt>server.rb</dt>
<dd>It requires sampleStruct.rb and creates an instance of
SampleStructService that responds all SOAP requests.
To run this server;
<pre class="path">
$ ./server.rb
</pre>
</dd>
<dt>server.cgi</dt>
<dd>CGI version. To run this server, copy server.cgi and
sampleStruct.rb to suitable directory of your WWW server.</dd>
<dt>client.rb</dt>
<dd>It connects to server.rb. Turn logger and wireDumpDev in its
source on to see logs and wire dumps of SOAP transport.
To run the client;
<pre class="path">
$ ./client.rb
</pre>
</dd>
</dl>
</dd>
<dt class="path">wsdl_helloworld/</dt>
<dd>A sample 'Hello World' SOAP client and server which utilize WSDL.
See wsdl_helloworld/README for more detail</dd>
</dl>
<h3><span class="content">payload/ ... various payload configuration</span></h3>
<dl>
<dt class="path">basicauth/</dt>
<dd>BasicAuth server and client sample.</dd>
<dt class="path">cookies/</dt>
<dd>HTTP-Cookies server and client sample.</dd>
<dt class="path">ssl/</dt>
<dd>SSL SOAP server and client samples.
<dl>
<dt class="path">sslserver.rb</dt>
<dd>SSL server sample which hosts "hello world" service.
This server uses SSL server certificate in files/ directory
(SSL client should check this certificate for SSL server
authentication).</dd>
<dt class="path">sslserver_noauth.rb</dt>
<dd>This server generates SSL server certificate
at runtime. No security.</dd>
<dt class="path">sslserver_require_clientauth.rb</dt>
<dd>This server users SSL server certificate in files/ directory
and requires SSL client authentication (clients must
have SSL client certificate and send it to the server).</dd>
<dt class="path">sslclient.rb</dt>
<dd>SSL client sample which calls "hello world" service via HTTPS.
This client checks SSL server certificate sent from SSL server.</dd>
<dt class="path">sslclient_require_noserverauth.rb</dt>
<dd>This client does not check SSL server certificate.
No security.</dd>
<dt class="path">sslclient_with_clientauth.rb</dt>
<dd>This client sends SSL client certificate in files/ directory
and checks SSL server certificate.</dd>
</dl>
</dd>
<dt class="path">gzipped/</dt>
<dd>gzipped content negotiation server and client sample.</dd>
</dl>
<h3><span class="content">soapheader/ ... SOAPHeader configuration</span></h3>
<dl>
<dt class="path">authheader/</dt>
<dd>It contains a sample to utilize SOAP Header handler. Send
userid/passwd and receive sessionid via SOAP Header</dd>
<dt class="path">soapext_basicauth/</dt>
<dd>It contains a sample to do BasicAuth in SOAPHeader. (http://soap-authentication.org/basic/2001/10/)</dd>
</dl>
<h3><span class="content">attachment/ ... SOAP with Attachment (SwA)</span></h3>
<dl>
<dt class="path">swa/</dt>
<dd>SOAP server and client sample of SwA (SOAP with Attachments).</dd>
<dt class="path">complexmime/</dt>
<dd>SOAP server and client sample of Complex Type + SwA</dd>
</dl>
<h3><span class="content">howto/ ... various other configuration</span></h3>
<dl>
<dt class="path">as_xml/</dt>
<dd>Sample client to send a request with XML, and receive a response as XML.</dd>
<dt class="path">base64/</dt>
<dd>Sample client to send/receive base64 data.</dd>
<dt class="path">documentliteral/</dt>
<dd>Sample client and server of document/literal service. See README.txt in this directory to run this sample.</dd>
<dt class="path">filter/</dt>
<dd>Sample client and server of filtering request/response before sending/receiving.</dd>
<dt class="path">scopesample/</dt>
<dd>SOAP server sample which shows a different behavior of SOAP server scope settings; Request scope vs Application scope.
sample/soap/scopesample/servant.rb is a servant which holds push-ed
object that can be pop-ed afterward.
See sample/soap/scopesample/server.rb how to define a servant as
a Request scope servant or an Application scope servant.
Application scope servant works as we expected because the servant
object is living from beginning to the time server terminated.
In contrast, request scope servant(s) does not work because a servant
object is created for each request.
</dd>
<dt class="path">styleuse/</dt>
<dd>Sample client and server of SOAP style and use combination, especially rpc/literal and document/encoded.</dd>
<dt class="path">wsdl_fault/</dt>
<dd>Sample client and server of handling SOAP fault specified in a WSDL. See wsdl_fault/README.txt for more detail.</dd>
<dt class="path">wsdl_hash/</dt>
<dd>Sample client and server of sending/receiving Hash struct defined in a WSDL.</dd>
</dl>
<h3><span class="content">marshal/ ... object <-> XML marshalling</span></h3>
<dl>
<dt class="path">digraph.rb</dt>
<dd>A sample of SOAP marshalling/unmarshalling.
It creates a digraph that contains multi-ref-ed nodes at first
and marshals this object to get serialized XML instance.
Then reads and unmarshals this XML instance to recover a object
which has the same links among nodes in the digraph.
</dd>
<dt class="path">customfactory.rb</dt>
<dd>Sample program for customizing mapping registry.</dd>
<dt class="path">enum/</dt>
<dd>Sample program to demonstrate how xsd2ruby.rb works.</dd>
</dl>
<h3><span class="content">showcase/ ... showcase sample to demonstrate</span></h3>
<dl>
<dt class="path">raa2.4/</dt>
<dd>sample/soap/raa2.4/sample.rb is a sample client to retrieve project
information on RAA. It uses raaDriver.rb which is generated by
wsdl2ruby.rb from WSDL at
<a href="http://www.ruby-lang.org/xmlns/soap/interface/RAA/0.0.4/">http://www.ruby-lang.org/xmlns/soap/interface/RAA/0.0.4/</a>.
You'll find wsdlDriver.rb in sample/wsdl/raa2.4/wsdlDriver.rb which
loads the WSDL at runtime to connect.</dd>
<dt class="path">icd/</dt>
<dd>A client for
<a href="http://www.iwebmethod.net/">Insider's Computer Dictionary Web Service</a>.
This service is implemented with ASP.NET so that it's also a sample of
a client which connects to ASP.NET.
CAUTION: this sample contains non-ascii chars in its source and dumped
results.
<dl>
<dt>IICD.rb</dt>
<dd>Class(type) definitions for this server.</dd>
<dt>icd.rb</dt>
<dd>Client implementation. To run the client;
<pre class="path">
$ ./icd.rb
</pre>
</dd>
</dl>
</dd>
<dt class="path">googleSearch/</dt>
<dd>Sample client to search with <a href="http://www.google.com/apis/">Google Web API</a> using WSDL. You need to get a developer's key to use it. See wsdlDriver.rb.</dd>
<dt class="path">amazon/</dt>
<dd>Sample client to connect with <a href="http://associates.amazon.com/exec/panama/associates/ntg/browse/-/1067662/086-5207681-4585409">AmazonWebServices</a> using WSDL. See wsdlDriver.rb.</dd>
<dt class="path">noaa/</dt>
<dd>Sample client of National Weather Service digital weather forecast data service at http://weather.gov/</dd>
<dt class="path">raa2.4/</dt>
<dd>sample/wsdl/raa2.4/wsdlDriver.rb is a sample client to retrieve
project information on RAA. It loads WSDL file
<a href="http://www.ruby-lang.org/xmlns/soap/interface/RAA/0.0.4/">http://www.ruby-lang.org/xmlns/soap/interface/RAA/0.0.4/</a>
at <strong>runtime</strong>.
You'll find a sample client at sample/soap/raa2.4/sample.rb
which connects RAA using pre-generated service definitions
(not loads WSDL at runtime).</dd>
<dt class="path">googleAdwords/</dt>
<dd>Sample client of Google AdWords service.
CAUTION: I don't have an account of AdWords so the sample code is NOT
tested. Please tell me (nahi@ruby-lang.org) if you will get good/bad
result in communicating with AdWords Server.</dd>
<dt class="path">amazonEC/</dt>
<dd>Sample client of AWSECommerce service.
CAUTION: I don't have an account of AWSECommerce so the sample code is
NOT tested. Please tell me (nahi@ruby-lang.org) if you will get
good/bad result in communicating with AWSECommerce Server.</dd>
</dl>
<p>
There are more samples in this directory.
</p>
<h2 id="resources" name="resources"><span class="content">7. Resources</span></h2>
<dl>
<dt class="path"><a href="http://dev.ctor.org/soap4r">soap4r project page</a></dt>
<dd>You can get the latest information and the latest development version of soap4r here.</dd>
<dt class="path"><a href="http://raa.ruby-lang.org/project/soap4r">[RAA:soap4r]</a></dt>
<dd>RAA meta information</dd>
<dt class="path"><a href="http://groups.google.com/group/soap4r">soap4r-ml on Google Groups</a></dt>
<dd>Feel free to join the list to ask any question and comment about soap4r.
You can browse messages archive. Bear in mind that Google Groups is still
in [beta] stage.</dd>
<dt class="path">Subversion repository</dt>
<dd>Soap4r's svn repository is here: http://dev.ctor.org/svn/soap4r/ .
To checkout the latest soap4r module, try
<pre>
svn checkout http://dev.ctor.org/svn/soap4r/trunk soap4r
</pre>
CVS repository of soap4r which was located at cvs.ruby-lang.org is pending since 2004-05-27. </dd>
</dl>
<h2 id="history" name="history"><span class="content">8. History</span></h2>
<dl>
<dt>1.5.7 - Jul 16, 2007</dt>
<dd>Version 1.5.7 mainly intends to fix regression problems introduced in 1.5.6.
Here are changes in 1.5.7 from 1.5.6.
<ul><li>Environment
<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>)
</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>)
</li></ul></li></ul><ul><li>SOAP/Ruby mapping
<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>)
</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>)
</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>)
</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>)
</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>)
</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>)
</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>)
</li></ul></li></ul><ul><li>SOAP
<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>)
</li><li>allow to customize default ns definition of SOAP Envelope. SOAPGenerator.new gets option hash as 'opt' and treats opt[:default_ns] as a XSD::NS which stores default ns definition of SOAP Envelope. See how it works in test/soap/test_custom_ns.rb. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/380" title="default XSD::NS for SOAPGenerator (closed)">#380</a>)
</li></ul></li></ul><ul><li>Payload
<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>)
</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>)
</li></ul></li></ul><ul><li>WSDL
<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>)
</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>)
</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>)
</li></ul></li></ul></dd>
<dt>1.5.6 - Jun 14, 2007</dt>
<dd>Here are changes in 1.5.6 from 1.5.5.
<ul><li>SOAP/Ruby mapping
<ul><li>specify sending XML document over SOAP by REXML::Element or to_xmlproc -able object. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/21" title="send XML Document over SOAP (closed)">#21</a>)
</li><li>encode or decode of single basetype parameter according to type definition in rpc/encoded service. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/14" title="wsdlRouter: return value must be converted to the specified element name (closed)">#14</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/98" title="param_def for rpc service (closed)">#98</a>)
</li><li>determining rpc method paramaters and outputs at runtime with MethodDefCreator" rel="nofollow">MethodDefCreator#{collect_rpcparameter|collect_documentparameter} (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/142" title="Determining rpc method paramaters and outputs at runtime (closed)">#142</a>)
</li><li>support an array element name other than 'item' in document/literal service. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/150" title="SOAP::FaultError - Index was outside the bounds of the array (closed)">#150</a>)
</li><li>let document/literal service proxy generated by
WSDLDriverFactory accept key-value pair array of array ([['k1', 'v1'],
...]) as same as a hash ({'k1' => 'v1', ...}). (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/156" title="consider to add ordering support for simple Ruby <-> XML interface (closed)">#156</a>)
</li><li>allow an XSD::QName as a value of extraattr such as <elename xmlns:n1="urn:valuenamespace">n1:value</elename>. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/157" title="QName as a value (closed)">#157</a>)
</li><li>SwA and doc/lit service. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/165" title="SwA and doc/lit service (closed)">#165</a>)
</li><li>allow to define an empty SOAP Body service. Thanks, emil. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/174" title="Minor change in SOAP::RPC::Driver.add_document_method (closed)">#174</a>)
</li><li>method overloading support. allow to define methods which have
same name and different signatures, and let Router invoke a method
according to SOAPAction. you need to define methods with different
SOAPAction. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/233" title="Method overloading and generated drivers (closed)">#233</a>)
</li><li>let Driver#generate_explicit_type work for ltieral service, too. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/234" title="generate_explicit_type for ltieral service (closed)">#234</a>)
</li><li>get the raw XML from the response. you get a result as an XML string when you set Driver#return_response_as_xml = true. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/250" title="get the raw XML from the response (closed)">#250</a>)
</li><li>do not validate CES of String by default to avoid consuming
memory. let XML processor check it instead. (you can turn it on by
XSD::XSDString.strict_ces_check = true) (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/265" title="String encoding validation (closed)">#265</a>)
</li><li>allow SOAP::Mapping::Object to dump/load with marshal_dump/marshal_load. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/266" title="SOAP::Mapping::Object: 'singleton can't be dumped' (closed)">#266</a>)
</li><li>handle CDATA correctly with xmlscan and rexml (only xmlparser worked). (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/332" title="CDATA in response (closed)">#332</a>)
</li><li>defined omit element / xsi:nil="true" elemet control. nil
means xsi:nil="true" for encoded service and nil means element omission
for literal service. pass SOAPNil.new to pass xsi:nil="true" for
literal service. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/343" title="omit element / xsi:nil="true" elemet control (closed)">#343</a>)
</li><li>one-way service support. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/200" title="one-way service support (`dump_method': undefined method `soapbody_use' ... (closed)">#200</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/346" title="oneway service + WSDLDriverFactory (closed)">#346</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/347" title="Onewy service should return 202 Accepted / service client should accept it (closed)">#347</a>)
</li><li>offer clearly defined message interceptor API. see test/soap/filter for more detail. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/350" title="offer clearly defined message interceptor API (chain) (closed)">#350</a>)
</li><li>SOAPElement.from_obj(obj): allow to set XML attribute. this
method is called when you pass a Hash or [['key1', 'value1'], ...] to
literal service so you can easily add XML attribute to a request. see <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/331" title="attributes with namespaces (closed)">#331</a> for more detail. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/331" title="attributes with namespaces (closed)">#331</a>)
</li></ul></li></ul><ul><li>Payload
<ul><li>merged a patch from Ernie that enables httpserver to serve WSDL. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/161" title="merge a patch that enables httpserver to serve WSDL (closed)">#161</a>)
</li><li>allow user to set own streamhandler of a SOAP::RPC::Driver. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/180" title="Create a request and pipe it to another program (closed)">#180</a>)
</li><li>let Driver#test_loopback_response work under soap4r + net/http. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/181" title="Driver#test_loopback_response under soap4r + net/http (closed)">#181</a>)
</li><li>allow to define basic_auth parameters with property file. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/198" title="define basic_auth with property file (closed)">#198</a>)
</li><li>follow HTTP redirection even with net/http. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/280" title="Follow HTTP redirection even with net/http (closed)">#280</a>)
</li><li>[ruby-Bugs-7532] make SOAP::HTTPStreamHandler handle gzipped content. Thanks, John Anderson. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/310" title="[ ruby-Bugs-7532 ] patch to make SOAP::HTTPStreamHandler handle gzipped ... (closed)">#310</a>)
</li></ul></li></ul><ul><li>SOAP format
<ul><li>SOAP actor name can be set through HeaderHandler. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/19" title="actor support (closed)">#19</a>)
</li><li>support xsd:token and xsd:language. Thanks, Jirka Pech. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/252" title="Complete implementation of data types (xsd, soap) (closed)">#252</a>)
</li><li>let XSD::QName immutable. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/274" title="let XSD::QName immutable (closed)">#274</a>)
</li><li>allow Header::Handler to access SOAPHeader from inside of on_outbound. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/354" title="sending Empty SOAPHeader (closed)">#354</a>)
</li></ul></li></ul><ul><li>WSDL
<ul><li>support <xsd:list> of <xsd:simpleType>. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/3" title="<xsd:list> of <xsd:simpleType> (closed)">#3</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/248" title="String should be allowed xsd:list of xsd:simpleType (closed)">#248</a>)
</li><li>support <xsd:union> of memberTypes. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/6" title="<xsd:union> of memberTypes (closed)">#6</a>)
</li><li>support <xsd:extension> for <xsd:complexContent>. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/72" title="<xsd:extension> support for <xsd:complexContent> (closed)">#72</a>)
</li><li>support <any>. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/148" title="SForce sample: how to create? (closed)">#148</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/155" title="<any> support (closed)">#155</a>)
</li><li>support <xsd:restriction> for <xsd:complexContent>. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/167" title="<xsd:restriction> support for <xsd:complexContent> (closed)">#167</a>)
</li><li>support <choice>. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/168" title="<choice> support (closed)">#168</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/205" title="sequence of choice not supported (was Unable to parse wsdl) (closed)">#205</a>)
</li><li>support simpleContent + attribute extension. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/176" title="simpleContent + attribute extension (closed)">#176</a>)
</li><li>generate Array classdef for maxOccurs="unbounded" element. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/182" title="classdef generation of element(untyped) array (closed)">#182</a>)
</li><li>support minLength and maxLength attributes. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/185" title="support minLength and maxLength attributes (closed)">#185</a>)
</li><li>support abstract attribute of complexTypes. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/195" title="wsdl2rb should not ignore the "abstract" attribute of complexTypes (closed)">#195</a>)
</li><li>moved @@schema_* things in classdef definition generated by
wsdl2ruby.rb to mapping registry. Mapping registries for each classdef
are defined in independent file and required from driver and server.
NOTE: old classdef files should still work but it should be
re-generated by new wsdl2ruby.rb. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/175" title="move @@schema_* things to MappingRegistry (closed)">#175</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/267" title="Missing 'wsdl/soap/literalMappingRegistryCreator' in driverCreator.rb (closed)">#267</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/270" title="respect ruby namespaces (closed)">#270</a>)
</li><li>support wsdl:fault definitions. Thanks, Peter Gardfjall. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/319" title="[PATCH] correct handling of wsdl:fault definitions (closed)">#319</a>)
</li></ul></li></ul><ul><li>Samples
<ul><li>add a demo how to call from Excel a simple soap service running
in apache (sample/soap/mssoap/) Thanks, an 'anonymous contributor from
Wall St.' (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/143" title="a self contained example how to setup apache web server to service a wsdl ... (closed)">#143</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/154" title="add a demo how to call from Excel a simple soap service running in apache (closed)">#154</a>)
</li><li>a sample to send an integer as Long type. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/160" title="add a sample to send an integer as Long type (closed)">#160</a>)
</li><li>an eBaySvc sample by Greg. Thanks! (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/183" title="add eBaySvc sample by Greg (closed)">#183</a>)
</li><li>basicauth client + server sample. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/249" title="basicauth server sample (closed)">#249</a>)
</li><li>cookie client + server sample. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/321" title="client + cookie sample (closed)">#321</a>)
</li></ul></li></ul><ul><li>misc
<ul><li>add a --prefix option in install.rb. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/255" title="support for a --prefix option in install.rb (closed)">#255</a>)
</li><li>warn misusage of lib/wsdl/soap/wsdl2ruby.rb. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/339" title="warn misusage of lib/wsdl/soap/wsdl2ruby.rb (closed)">#339</a>)
</li><li>wsdl2ruby --classdef could have an optional classname argument. Thanks, P@. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/173" title="wsdl2ruby --classdef could have an optional classname argument (closed)">#173</a>)
</li><li>putting the classes that support a web service into a service-specific module. check --module_path (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/279" title="putting the classes that support a web service into a service-specific ... (closed)">#279</a>)
</li></ul></li></ul><ul><li>Bug fixes
<ul><li>SOAP/Ruby mapping: <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/184" title="undefined method `each' for #<SOAP::SOAPString:0x405d8eec> ... (closed)">#184</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/186" title="xml document with a class tag seems to cause infinite loop (closed)">#186</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/187" title="Axis enumerations and soap4r (closed)">#187</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/188" title="AWSECommerceService client sample raises "unknown class/module: Header" (closed)">#188</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/190" title="salesforce.com - undefined string maps to #<SOAP::Mapping::Object:0x...> ... (closed)">#190</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/220" title="'.' in Method names produces an exception (closed)">#220</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/224" title="huge memory usage with the Ebay API (closed)">#224</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/225" title="`struct2soap': You have a nil object when you didn't expect it! (closed)">#225</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/226" title="a problem about extraattr when using SOAP::SOAPHeaderItem (closed)">#226</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/228" title="@@schema_element does not work in rpc service (closed)">#228</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/229" title="Incorrect obj2soap mapping (Case-Sensitivity) (closed)">#229</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/230" title="arrayType default namespace seems wrong (closed)">#230</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/238" title="rpc serialize + @@schema_element definition in class causes mapping error: ... (closed)">#238</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/241" title="do not dump XML attribute which value is nil (closed)">#241</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/242" title="handling anonymous class crashes under Ruby/1.9 (closed)">#242</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/254" title="parameter is not submitted if "name" attribute contains uppercase ... (closed)">#254</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/268" title="Allow safe method names with =, ?, !, or self. (closed)">#268</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/289" title="unqualified element generated from Hash parameter (closed)">#289</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/302" title="soap4r will redefine "class" (closed)">#302</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/311" title="Bad extraattr in Envelope, Body and Header (closed)">#311</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/312" title="Generator not working with HeaderItem childs. (closed)">#312</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/316" title="false children get dropped and not added to SOAP request (closed)">#316</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/328" title="xsd:date + WSDL generated stub (closed)">#328</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/333" title="[PATCH] MappingRegistryCreator missing require (closed)">#333</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/336" title="Element must have no character or element information item [children] (closed)">#336</a>
</li><li>Payload: <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/172" title="Converter not found: X_ISO_8859_1 -> UTF8 ... (closed)">#172</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/215" title="improved end-of-line handling withing MIME messages (closed)">#215</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/236" title="netHttpClient.rb + no_proxy bug (closed)">#236</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/264" title="intermittent error: "get_status must be called at the beginning of a ... (closed)">#264</a>
</li><li>SOAP format: <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/177" title="SOAP Fault Codes support (closed)">#177</a>, <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/237" title="cannot parse xml:lang etc in SOAP response (closed)">#237</a>
</li><li>WSDL: <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/151" title="soap4r-1_5_5 wsdl2ruby.rb fails (elementFormDefault (closed)">#151</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/152" title="add_elements2stubobj -- elename may not be set (closed)">#152</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/158" title="wsdl2ruby fails to generate a class definition (closed)">#158</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/162" title="parameters are set to nil in request SOAP envelope (closed)">#162</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/163" title="WSDL2Ruby generates module definition for simpleType enumeration twice (closed)">#163</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/169" title="wsdl2ruby should support proxy when wsdl location is a URL (closed)">#169</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/170" title="wsdl2ruby.rb cannot handle WSDL using soapenc:* types (closed)">#170</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/178" title="wsdl2ruby.rb may generate illegal derived class definition for ... (closed)">#178</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/189" title="WSDLLiteralRegistry wrongly decodes empty string and nil to ... (closed)">#189</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/191" title="Problem with the documentliteral/echo.wsdl (closed)">#191</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/194" title="extending types seems to confuse wsdl2rb (closed)">#194</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/199" title="Abstract WSDL definition(no binding) causes NameError (closed)">#199</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/201" title="undefined method `namespace' for nil:NilClass (NoMethodError) from ... (closed)">#201</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/203" title="classes not defined for simple types using restriction base (closed)">#203</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/204" title="when xsd: is not specified wsdl2ruby generates a wrong method (closed)">#204</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/216" title="Case-Sensitivity in WSDL Driver (closed)">#216</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/227" title="undefined method `ports' for nil:NilClass (NoMethodError) in wsdl2ruby.rb (closed)">#227</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/231" title="classDefCreator fails with simpleContent extension (closed)">#231</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/232" title="WSDLLiteralRegistry fails to map XML instance to Array: element override (closed)">#232</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/239" title="Possible patch to wsdl/soap/mappingRegistryCreator.rb (closed)">#239</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/240" title="accessing doc-lit service returns [response] only in Ruby/1.9 (closed)">#240</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/245" title="schema import location is not inherited (closed)">#245</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/246" title="not all portType are bound in the given WSDL (closed)">#246</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/247" title="name attribute of wsdl:operation should not be qualified (closed)">#247</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/258" title="PayPal WSDL generates an error (closed)">#258</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/260" title="'form="unqualified"' (closed)">#260</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/262" title="no parameters generated in classes for extensions in complex types (closed)">#262</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/263" title="patch for #262 (closed)">#263</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/267" title="Missing 'wsdl/soap/literalMappingRegistryCreator' in driverCreator.rb (closed)">#267</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/271" title="wsdl2ruby.rb generates duplicated class definitions (closed)">#271</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/272" title="choice definition breakage in encoded service (closed)">#272</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/273" title="wsdl2ruby.rb --classdef argument not explained in usage (closed)">#273</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/275" title="problem with receiving subclasses using wsdl2ruby (closed)">#275</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/284" title="wsdl2rb produces incomplete mapping (closed)">#284</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/285" title="illegal mapping definition about a type 'xsd:schema' (closed)">#285</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/300" title="Problem in Port Init (closed)">#300</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/304" title="Marshalling of simple data types ends up with the wrong data type in Ruby (closed)">#304</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/306" title="String subclass is generated wrongly from simpleContent (closed)">#306</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/309" title="Bug in complexContent.rb (closed)">#309</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/313" title="wsdl2ruby exception with Google Adwords AdService.xml (closed)">#313</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/317" title="value cannot be resolved (closed)">#317</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/322" title="xsd2ruby generates BadURIError (closed)">#322</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/325" title="part: value cannot be resolved (RuntimeError) (closed)">#325</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/326" title="inheritance hierarchy not maintained from wsdl, problems with complexType ... (closed)">#326</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/327" title="wsdl2ruby: fatal - undefined method `namespace' for ... (closed)">#327</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/335" title="issues when generating a mapping registry, specifically; a literal mapping ... (closed)">#335</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/337" title="wsdl2ruby produces code that overrides system classes (closed)">#337</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/342" title="EncodingStyle not supported (closed)">#342</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/344" title="ref + min/maxOccurs does not work (closed)">#344</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/348" title="XSD::ValueSpaceError when SOAP response contains empty elements (closed)">#348</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/349" title="ClassDefCreator must sort complextypes: base class first, derived classes ... (closed)">#349</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/352" title="abstract type is added to the Mapping Registry, which causes malfunction (closed)">#352</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/353" title="private method `sub' called for #<XSD::QName:...XMLSchema}anyType> ... (closed)">#353</a>
</li><li>misc: <a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/153" title="warnings in test such as: WSDLDriverFactory#create_driver is depricated. ... (closed)">#153</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/192" title="GoogleAdwords Sample doesn't work (closed)">#192</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/251" title="typo: 'depricated' in wsdlDriver.rb (closed)">#251</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/277" title="rubygems xml parser fallback broken due to rubygems 'require' bug (closed)">#277</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/282" title="wsdl2ruby.rb argument order dependency (closed)">#282</a>,
<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/329" title="property file and non UTF-8 encoding chars (closed)">#329</a>
</li></ul></li></ul>
</dd>
<dt>1.5.5 - Sep 15, 2005</dt>
<dd> Here are changes in 1.5.5 from 1.5.4.
<ul><li>SOAP
<ul><li>allow to configure an envelope namespace of SOAP request. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/124" title="configuable envelope namespace (closed)">#124</a>)
<pre class="wiki">TemporaryNamespace = 'http://www.w3.org/2003/05/soap-envelope'
@client.options["soap.envelope.requestnamespace"] = TemporaryNamespace
@client.options["soap.envelope.responsenamespace"] = TemporaryNamespace
@client.do_proc(...)
</pre>
</li><li>let SOAP request XML indent space configuable. see "soap.envelope.no_indent" option. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/130" title="A server dislike indent spaces in XML instance (closed)">#130</a>)
</li><li>let external CES configuable. ex. client["soap.mapping.external_ces"] = 'SJIS'. $KCODE is used by default. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/133" title="let $KCODE free (closed)">#133</a>)
<pre class="wiki">external CES ::= CES used in Ruby object of client and server
internal CES ::= CES used in SOAP/OM
</pre>
</li><li>add iso-8859-1 external CES support. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/106" title="iso-8859-1 encoded response (closed)">#106</a>)
</li><li>fixed illegal 'qualified' handling of elements. it caused ASP.NET inteoperability problem. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/144" title="soap4r and ASP.NET problems about 'qualified' (closed)">#144</a>)
</li><li>added 'soap.envelope.use_numeric_character_reference' (boolean) option to let query XML use numeric character reference in XML, not plain UTF-8 character. GoogleSearch server seems to not allow plain UTF-8 character since 2005-08-15 update. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/147" title="GoogleWebSearch does not work with UTF-8 query (closed)">#147</a>)
</li><li>SOAP::Header::SimpleHeader (de)serialization throws an exception on SimpleHeader.on_(in|out)bound when header is a String. so we could not use a simple single element headerItem. fixed. thanks to emil. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/129" title="SOAP::Header::SimpleHeader deserialization throws on ... (closed)">#129</a>)
</li><li>out parameter of rpc operation did not work. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/132" title="outparameter causes NameError (closed)">#132</a>)
</li><li>follow HTTP redirect only if using http-access2. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/125" title="follow http/https redirection (closed)">#125</a>) (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/145" title="an error from streamHandler.rb:37 that claims an uninitialized constant ... (closed)">#145</a>)
</li><li>add a workaround for importing an WSDL whose path begins with drive letter. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/115" title="RuntimeError: Cannot connect to ... (closed)">#115</a>)
</li></ul></li><li>WSDL
<ul><li>SOAP Data which is defined as a simpletype was not mapped correctly to Ruby obj when using wsdl2ruby.rb generated classdef file. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/123" title="soap4r mapping problem when using google adwords api (closed)">#123</a>)
</li><li>rpc/literal support. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/118" title="soap encoding is used for rpc/literal services (closed)">#118</a>)
</li><li>re-implemented local element qualify/unqualify control. handles elementFormDefault and form in WSDL. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/119" title="Cannot talk to doc/literal service which is has ... (closed)">#119</a>)
</li><li>Array of an element which has simpleType causes a crash. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/128" title="Array of a element which has simpleType causes a crash (closed)">#128</a>)
</li><li>prarmeterOrder may not contain return part so it can be shorter than parts size. Thanks to Hugh. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/139" title="prarmeterOrder may not contain return part (closed)">#139</a>)
</li></ul></li><li>Samples
<ul><li>added BasicAuth client sample. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/117" title="add BasicAuth sample not only in test dir but also in sample dir (closed)">#117</a>)
</li><li>added Base64 client/server sample.
</li><li>added Flickr SOAP interface client sample. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/122" title="Flickr SOAP API support (closed)">#122</a>)
</li><li>added SalesForce client sample. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/135" title="how to set session id in SOAP header (sforce WSDL) (closed)">#135</a>)
</li><li>updated Thawte CA certificate for GoogleAdWords sample.
</li><li>updated a client script with the newer version made by Johan. thanks!
</li><li>shortened long file names. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/120" title="long file name (closed)">#120</a>)
</li><li>fixed typo in authheader sample. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/129" title="SOAP::Header::SimpleHeader deserialization throws on ... (closed)">#129</a>)
</li><li>updated deprecated method usage. (<a class="closed ticket" href="http://dev.ctor.org/soap4r/ticket/138" title="create_driver in sample should be replaced with create_rpc_driver (closed)">#138</a>)
</li></ul></li></ul>
</dd>
<dt>1.5.4 - May 13, 2005</dt>
<dd>This is version 1.5.4.
Version 1.5.3 is the module which is included in ruby-1.8.2,
and not released independently.
Following changes consist from 2 parts; Changes from 1.5.3 to 1.5.4,
and from 1.5.2 to 1.5.3.
<br/><br/>
Changes in 1.5.4 from 1.5.3
<br/><br/>
<ul>
<li>SOAP client and server
<ul>
<li>for both client side and server side
<ul>
<li>improved document/literal service support. style(rpc, document)/use(encoding, literal) combination are all supported. for the detail about combination, see test/soap/test_style.rb.</li>
<li>let WSDLEncodedRegistry#soap2obj map SOAP/OM to Ruby according to WSDL as well as obj2soap.</li>
<li>let SOAP::Mapping::Object handle XML attribute for doc/lit service. you can set/get XML attribute via accessor methods which as a name 'xmlattr_' prefixed (<foo name="bar"/> -> Foo#xmlattr_name).</li>
</ul>
</li>
<li>client side
<ul>
<li>WSDLDriver capitalized name operation bug fixed. from 1.5.3-ruby1.8.2, operation which has capitalized name (such as KeywordSearchRequest in AWS) is defined as a method having uncapitalized name. (converted with GenSupport.safemethodname to handle operation name 'foo-bar'). it introduced serious incompatibility; in the past, it was defined as a capitalized. define capitalized method as well under that circumstance.</li>
<li>added new factory interface 'WSDLDriverFactory#create_rpc_driver' to create RPC::Driver, not WSDLDriver (RPC::Driver and WSDLDriver are merged). 'WSDLDriverFactory#create_driver' still creates WSDLDriver for compatibility but it warns that the method is deprecated. please use create_rpc_driver instead of create_driver.</li>
<li>allow to use an URI object as an endpoint_url even with net/http, not http-access2.</li>
</ul>
</li>
<li>server side
<ul>
<li>added mod_ruby support to SOAP::CGIStub. rename a CGI script server.cgi to server.rb and let mod_ruby's RubyHandler handles the script. CGIStub detects if it's running under mod_ruby environment or not.</li>
<li>added fcgi support to SOAP::CGIStub. see the sample at sample/soap/calc/server.fcgi. (almost same as server.cgi but has fcgi handler at the bottom.)</li>
<li>allow to return a SOAPFault object to respond customized SOAP fault.</li>
<li>added the interface 'generate_explicit_type' for server side (CGIStub, HTTPServer). call 'self.generate_explicit_type = true' if you want to return simplified XML even if it's rpc/encoded service.</li>
</ul>
</li>
</ul>
</li>
<li>WSDL
<ul>
<li>WSDL definition
<ul>
<li>improved XML Schema support such as extension, restriction, simpleType, complexType + simpleContent, ref, length, import, include.</li>
<li>reduced "unknown element/attribute" warnings (warn only 1 time for each QName).</li>
<li>importing XSD file at schemaLocation with xsd:import.</li>
</ul>
</li>
<li>code generation from WSDL
<ul>
<li>generator crashed when there's '-' in defined element/attribute name.</li>
<li>added ApacheMap WSDL definition.</li>
</ul>
</li>
</ul>
</li>
<li>Samples
<ul>
<li>added XML <-> Ruby mapping utility. XSD::Mapping#xml2obj maps an XML to a tree of SOAP::Mapping::Object. XSD::Mapping#obj2xml is for reverse direction conversion. see a sample in sample/wsdl/noaa/client.rb</li>
<li>added a sample for weather.gov's NDFD services.</li>
<li>add a sample of googleAdWords. CAUTION: I don't have an account of AdWords so the sample code is NOT tested. Please tell me (nahi@ruby-lang.org) if you will get good/bad result in communicating with AdWords Server.</li>
<li>add a sample of AWSECommerce. CAUTION: I don't have an account of AWSECommerce so the sample code is NOT tested. Please tell me (nahi@ruby-lang.org) if you will get good/bad result in communicating with AWSECommerce Server.</li>
</ul>
</li>
<li>Redists
<ul>
<li>include xmlscan as a redistributed module. xmlscan now is a first class XML processor. still soap4r should run with REXML and XMLParser.</li>
</ul>
</li>
</ul>
<br/>
Changes in 1.5.3 from 1.5.2
<br/><br/>
<ul>
<li>SOAP client and server
<ul>
<li>for both client side and server side
<ul>
<li>added a header handler class for simple SOAPHeader handling. see samples in sample/soap/authheader/*.</li>
<li>SSL support (both client side and server side). check sample/soap/ssl/*</li>
<li>gzipped content encoding support. see sample/soap/helloworld/hw_{c,s}_gzip.rb.</li>
</ul>
</li>
<li>client side
<ul>
<li>HTTP-Cookies support under soap4r + http-access2. not supported under soap4r + net/http.</li>
<li>added a method (SOAP::RPC::Driver#test_loopback_response) for loopback test with the specified response.</li>
<li>added SOAP::RPC::Driver#loadproperty interface to load property file.</li>
<li>let SOAP::RPC::Driver#add_method returns Method object. you can invoke a service like; drv.add_method("hello").call("world")</li>
<li>added http options to get/set timeout seconds.
<ul>
<li>for http-access2:
<ul>
<li>driver.options["protocol.http.connect_timeout"]</li>
<li>driver.options["protocol.http.send_timeout"]</li>
<li>driver.options["protocol.http.receive_timeout"]</li>
</ul>
</li>
<li>for net/http:
<ul>
<li>driver.options["protocol.http.connect_timeout"]</li>
<li>driver.options["protocol.http.receive_timeout"]</li>
</ul>
</li>
</ul>
</li>
<li>raise NotImplementedError when net/http + basic_auth.</li>
</ul>
</li>
<li>server side
<ul>
<li>introduced the new server class SOAP::RPC::HTTPServer which takes WEBrick's HTTPServer compatible config parameter.</li>
<li>added a debug log of SOAP request/response.</li>
</ul>
</li>
</ul>
</li>
<li>SOAP core part
<ul>
<li>added XMLSchema derived type support; byte, nonPositiveInteger, negativeInteger, nonNegativeInteger, positiveInteger, unsignedLong, unsignedInt, unsignedShort, unsignedByte.</li>
<li>'eval' cleanup. I hope it allows soap4r to work under mod_ruby environment.</li>
<li>SOAPProperty raise RuntimeError under ruby-1.9 when accessing locked property. still raises TypeError under ruby-1.8 or earlier. the change is from ruby's behaviour change about an exception when accessing a frozen object.</li>
<li>make SOAPHeader a child of SOAPStruct, not SOAPArray.</li>
<li>SOAPProperty does not eval whole string. \\, \t, \r, \n, \f escaping chars are supported like Java's Properties.</li>
<li>URI object was not mapped correctly so that URI object was not interoperable under some situation. fixed.</li>
<li>SOAP::Mapping::Object: handle multiple value as an array.
<pre>