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
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
|
<?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>
<foo>
<bar>1</bar>
<bar>2</bar>
<bar>3</bar>
<baz>4</baz>
</foo>
->
foo.bar => [1, 2, 3]
foo.baz => 4
</pre>
</li>
<li>raise an exception while dumping singleton class. [ruby-dev:22588]
<pre>
e.g. c = class << Object.new
class C; self; end
end
SOAPMarshal.dump(c)
</pre>
</li>
</ul>
</li>
<li>WSDL
<ul>
<li>WSDL definition
<ul>
<li>added <xsd:simpleContent> support.</li>
<li>initial (means "far from complete") simpleType support.</li>
<li>support parts attribute of soap:body element.</li>
<li>xmlSchema's 'any' element support; for parsing, just treat the element as an element which has a name 'any'.</li>
<li>add mustUnderstand attribute support.</li>
<li>a special well-known type: ApacheMap support.</li>
</ul>
</li>
<li>code generation from WSDL
<ul>
<li>added simple code generation utils (lib/xsd/codegen)</li>
<li>dump attribute definition in XMLSchema as 'attr_*' attribute. [experimental]</li>
<li>wsdl2ruby.rb: add document/literal service support. see sample/wsdl/documentliteral/*</li>
<li>untyped element should be treated as xsd:anyType.</li>
<li>added a tool xsd2ruby.rb for generating classdef from xsd file.</li>
</ul>
</li>
</ul>
</li>
<li>Samples
<ul>
<li>added RAA/2.4 sample client</li>
<li>added sample for Application/Request scope use. Session scope (with Cookies) feature is not yet exists.</li>
</ul>
</li>
</ul>
</dd>
<dt>1.5.2 - December 25, 2003</dt>
<dd>
<ul>
<li>License;
<ul>
<li>Changed license from GPL2 to Ruby's.</li>
</ul></li>
<li>Features;
<ul>
<li>Add SOAP Messages with Attachments (SwA) support.
Patched by Jamie Herre.
"SOAP Messages with Attachments" is the W3C Note which defines a
binding for a SOAP 1.1 message to be carried within a MIME
multipart/related message. <a href="http://www.w3.org/TR/SOAP-attachments">http://www.w3.org/TR/SOAP-attachments</a>
This feature is still experimental. Interop testing is going on.</li>
<li>HTTPS support even when you use net/http (not http-access2).
Patched by Oliver M. Bolzer.</li>
<li>Property file support. SOAP and WSDL client reads "soap/property"
file located at somewhere in $: (ruby libray locations). For
example, save these lines to
"$rubylibdir/site_ruby/1.8/soap/property".
<pre>
client.protocol.http.proxy = http://myproxy:8080
client.protocol.http.no_proxy = 192.168.71.71,192.168.71.72
</pre>
Then all HTTP connections should use these proxy and no_proxy
definition.</li>
<li>Do not trust "HTTP_PROXY" environment variable by default to
avoid security problem. cf.
<ul>
<li><a href="http://ftp.ics.uci.edu/pub/websoft/libwww-perl/archive/2001h1/0072.html">http://ftp.ics.uci.edu/pub/websoft/libwww-perl/archive/2001h1/0072.html</a></li>
<li><a href="http://ftp.ics.uci.edu/pub/websoft/libwww-perl/archive/2001h1/0241.html">http://ftp.ics.uci.edu/pub/websoft/libwww-perl/archive/2001h1/0241.html</a></li>
<li><a href="http://curl.haxx.se/mail/archive-2001-12/0034.html">http://curl.haxx.se/mail/archive-2001-12/0034.html</a></li>
</ul>
To use HTTP_PROXY and NO_PROXY environment variable, you must set
SOAP_USE_PROXY environment variable 'on', too.
<pre>
bash$ soap_use_proxy=on http_proxy=http://myproxy:8080 ruby ...
csh$ env soap_use_proxy=on http_proxy=http://myproxy:8080 ruby ...
</pre></li>
<li>Add SOAP::RPC::Driver#mandatorycharset= and
SOAP::WSDLDriver#mandatorycharset= interface to force using
charset when parsing response from buggy server such as AWS.</li>
<li>Support a halfway-typed multi-ref array that Axis dumps.</li>
<li>Added a interface XSD::Charset.encoding= to control internal
encoding scheme. Internal encoding scheme was fixed to 'utf-8'
when iconv or uconv was installed. You can set 'euc-jp', etc.
to avoid encoding scheme conversion if you know what encoding
scheme the server uses.</li>
</ul></li>
<li>Bug fixes;
<ul>
<li>SOAP::Marshal.unmarshal: raise an exception if parse fails.
(returned nil)</li>
<li>SOAP::WSDLDriver: decode unknown element according to self-defined
type even if WSDL was given.</li>
<li> SOAP::Mapping::Factory#create_empty_object: fix Class#allocate
emulation code for ruby/1.6. no effective change under ruby/1.8.</li>
<li>SOAP::RPC::SOAPMethodResponse: element name of response message
could have the name other than 'return'.</li>
<li>SOAP::RPC::StandaloneServer: add methods 'shutdown' and 'status'
as delegates to WEBrick.</li>
<li>WSDL::SOAP::ClassDefCreator: WSDL/1.1 allows plural fault
definition in a operation.</li>
<li>XSD::Charset.init: use cp932 under emx.
Patched by Siena. / SHINAGAWA, Norihide.</li>
</ul></li>
</ul></dd>
<dt>1.5.1 - November 2, 2003</dt>
<dd>
<ul>
<li>Features;
<ul>
<li>Sample updates; Update Amazon Web Service WSDL (v2 -> v3), and update RAA WSDL(0.0.1 -> 0.0.2).
<li>Supports ivars of basetype and extending modules marshalling with XML attribute.
Using XML attribute to support ruby object dependent information, marshalled object keeps compatibility with SOAP spec.
It shows the power of XML, extensibility.<br/>
Now I think SOAP marshaller supports all kind of object graph which is supported by Ruby's original marshaller.</li>
<li>Better XML pretty printing.
<pre>
puts SOAPMarshal.dump(Person.new("NaHi", 33))
=>
<?xml version="1.0" encoding="utf-8" ?>
<env:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<env:Body>
<Person xmlns:n1="http://www.ruby-lang.org/xmlns/ruby/type/custom"
xsi:type="n1:Person"
env:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<age xsi:type="xsd:int">33</age>
<name xsi:type="xsd:string">NaHi</name>
</Person>
</env:Body>
</env:Envelope>
</pre></li>
</ul></li>
<li>Installation;
<ul>
<li>The previous version soap4r/1.5.0 required http-access2 to be installed to build CGI server, but no longer needed fot this purpose now.
You can use almost all features of soap4r without http-access2,
but for actual usage, consider installing http-access2 for speed and
thread-safe SOAP client.</li>
<li>Under ruby/1.8, installer installs lib files to rubylibdir(e.g. /usr/local/lib/ruby/1.8) instead of sitelibdir(e.g. /usr/local/lib/ruby/site_ruby/1.8)</li>
</ul></li>
<li>Bug fixes;
<ul>
<li>Do not introduce XSD constants to toplevel.</li>
<li>'NO_PROXY'/'no_proxy' env var was not supported under net/http. Fixed.</li>
<li>Remove some ruby/1.8 dependent codes. Should work fine under 1.6, too.</li>
<li>XSD::XSDString did not check its value space under $KCODE = 'NONE' env for example where iconv module is not installed.</li>
<li>XSD::XSDFloat, XSD::XSDDouble: add +/- sign explicitly when stringified and embedded into XML instance. Ruby's sprintf may format -0.0 as "0.0" (no minus sign) depending on underlying C sprintf implementation.</li>
</ul></li>
</ul></dd>
<dt>1.5.0 - September 13, 2003</dt>
<dd>Thousands of lines are changed in this release
(*.rb in current SOAP4R distribution has 30kloc or over).
But the biggest change is coding convention, camelCase to non_camel_case.
Though I tried to keep compatibility between 1.5.0 and 1.4.8, but there's no
way to keep it at a few point. If you'll find your code which was developed
for 1.4.8 does not run under 1.5.0, feel free to ask
<a href="mailto:nahi@ruby-lang.org">me</a> to solve the problem.
<ul>
<li>Dependency libraries;
<ul>
<li>Add net/http support. Users can try sample SOAP clients without installing http-access2. For actual usage, consider installing http-access2 for speed and thread-safe SOAP client. CAUTION: Building SOAP CGI server needs http-access2 to be installed.</li>
<li>Soap4r standalone server requires webrick module to be installed instead of GServer.rb and httpserver.rb.</li>
<li>Supports iconv. To use utf-8, you need to install iconv(included in ruby/1.8) or uconv.</li>
<li>Suspend NQXML XML parser support.</li>
<li>Remove REXML processor version check. No longer needed.</li>
<li>Rewrite tests with test/unit.</li>
</ul></li>
<li>Features;
<ul>
<li>Efforts to support messaging with document/literal and ASP.NET interoperability.</li>
<li>Add document/literal messaging interface to wsdlDriver.rb. See a very brief example in sample/soapbox/wsdlDriver.rb though I still didn't try to login to Jabber server.. Jabber folks?</li>
<li>XML pretty printing.</li>
<li>Better Ruby object mapping. Rewrote RubytypeFactory to support more Ruby objects. Tests in AMarshal(http://cvs.m17n.org/~akr/amarshal/) much helped it. Thanks very much to Tanaka Akira-san.</li>
<li>SOAPMarshal accepts IO as an output device like Marshal#dump.</li>
<li>SOAPElement: constructor signature change. Added extraattrs attribute.</li>
<li>XSDDateTimeImpl: to_time did not set usec.</li>
<li>StreamHandler: add reset method to shutdown a connection to a site.</li>
</ul></li>
<li>Others;
<ul>
<li>Simplify installer and remove uninstaller. Saving inventory file in src dir could be the problem.</li>
<li>Class/Module architecture relocation.</li>
<li>Changing coding convention to fit with Ruby's. Added lib/soap/compat.rb which defines compatibility definitions for 1.4.8. lib/soap/compat.rb warns when the library is loaded.</li>
<li>Many warnings raised under 1.8, caused by illegal references like XSD::XSDInt in typeMap.rb. Soap4r defined toplevel::XSDInt. Define XSD* classes in XSD module and introduce it to toplevel.</li>
</ul></li>
</ul>
</dd>
<dt>1.4.8 - January 17, 2003</dt>
<dd>
This version has these enhancements and bug fixes;
<ul>
<li>Avoid warnings;
<ul>
<li>Use Object#class instead of Object#type.</li>
<li>Avoid implicit use a String as a regexp source.</li>
</ul></li>
<li>Add wsdlDriver which reads WSDL file and allow client to call procedures. Here is an example to search Google.
<pre>
require 'soap/wsdlDriver'
searchWord = ARGV.shift
# You must get key from http://www.google.com/apis/ to use Google Web APIs.
key = File.open(File.expand_path("~/.google_key")).read.chomp
GOOGLE_WSDL = 'http://api.google.com/GoogleSearch.wsdl'
# Load WSDL and create driver.
google = SOAP::WSDLDriverFactory.new(GOOGLE_WSDL).createDriver
# Just invoke!
result = google.doGoogleSearch(key, searchWord, 0, 10, false, "", false, "", 'utf-8', 'utf-8')
result.resultElements.each do |ele|
puts "== #{ele.title}: #{ele.URL}"
puts ele.snippet
puts
end
</pre></li>
<li>WSDLDriver client examples of AmazonWebServices, RAA and RNN (Japanese Ruby blog site) are also included in sample/ dir.</li>
<li>Support xmlscan XML processor.</li>
<li>Changed XML processor detection scheme. Search xmlscan, REXML, XMLParser and NQXML in this order.</li>
<li>Rewrite charset handling of XML processor.
<ul>
<li>If you only use us-ascii and utf-8, all XML processors should work without uconv module.</li>
<li>With xmlscan/0.2 or later, you can handle euc-jp or shift_jis encoded XML instance WITHOUT uconv module.</li>
<li>With other XML processors includes xmlscan/0.1, you need to install uconv module to handle euc-jp or shift_jis encoded XML instance.</li>
</ul></li>
<li>cgistub.rb: Overridable response mediatype. There exists a http client which does not accept the mediatype text/xml which is specified in SOAP spec. For example, an i-Mode (smart phone) client does not accept it... You can set response mediatype to 'text/plain' for such client though it violates SOAP spec...</li>
<li>wsdl2ruby: Add --force option to override existing file.</li>
<li>Fixed many bugs.</li>
</ul></dd>
<dt>1.4.7 - September 20, 2002</dt>
<dd>
This version has these enhancements and bug fixes;
<ul>
<li>Includes WSDL4R initial release.
<ul>
<li>Bear in mind this is an alpha level code.
I wrote it halfway at half and a year ago,
and wrote the rest part in half and a day.
No comprehensive test, no strict syntax check, unfriendly error message, etc.
Try it if you want, and find bugs in it.</li>
<li>WSDL4R can run under XMLParser for now.
You might be able to let it run under NQXML/REXML if you know SAX
programming well. How XML processor is used under WSDL4R
is as same as under SOAP4R.</li>
</ul></li>
<li>Added xsd:short support.</li>
<li>::Float(double precision float in Ruby) is mapped to xsd:double now.
It was mapped to xsd:float.</li>
<li>Fixed a bug of year < 0 handling. B.C. 1 => -0001 in XMLSchema.</li>
<li>Fixed a bug of exception serialization. Custam mappingRegistry was not used.</li>
<li>Fixed a bug of regex for MediaType parsing.</li>
</ul>
</dd>
<dt>1.4.5 - May 25, 2002</dt>
<dd>
This version has these enhancements;
<ul>
<li>Supports all primitive datatypes of XML Schema Part2 Datatypes except NOTATION.
Added types are Duration, gYearMonth, anyURI, QName and so on.</li>
<li>Runs much faster than earlier versions.
Some performance check and tuning has been done.</li>
<li>Supports all Ruby objects marshalling/unmarshalling
except some special objects. See below for more detail.</li>
</ul>
CAUTION: This version requires
<a href="http://raa.ruby-lang.org/list.rhtml?name=date2">[RAA:date2]</a> version 3.2 or later and
<a href="http://raa.ruby-lang.org/list.rhtml?name=http-access2">[RAA:http-access2]</a> version F.
Please make sure the versions you use.
<br/><br/>
Here is detail of change.
<dl>
<dt>Datatypes (XMLSchemaDatatypes.rb and baseData.rb)</dt>
<dd>
<ul>
<li>Added duration, gYearMonth, gYear, gMonthDay, gDay, gMonth, anyURI and QName datetypes.
All primitive datatypes in XML Schema Part 2 section 3.2 except NOTAION are supported now.</li>
<li>Modified XSDDataTime, XSDDate and XSDTime implementation. These use a DataTime as a data holder.</li>
<li>Follow date/3.2: date2.rb -> date.rb.</li>
<li>Changed to_s representations of single float and double float. Thanks to gotoken.</li>
<li>XSDFloat: Add '0' if given str ends with 'E'. Float( "-1.4E" ) might fail on some system.</li>
<li>Added SOAPRawString class. Given string is embedded into XML instance directly.
You can use this class to embed (numeric) character references manually.</li>
<li>Fixed UTF8 regexp bug. XSDString uses this regexp to check a given string.</li>
<li>Added UT for XMLSchemaDatatypes.rb. See test/xsd_ut.rb and test/baseData_ut.rb.</li>
</ul></dd>
<dt>SOAP <-> Ruby object mapping (mappingRegistry.rb and rpcUtils.rb)</dt>
<dd>
<ul>
<li>Exception raised from server side could not be mapped to specific exception. Fixed.</li>
<li>Refactoring to avoid *_eval. Reduced warnings.</li>
<li>Added Range marshalling support.</li>
<li>Regexp#options support under ruby/1.6.</li>
<li>Supports cyclic Range such as;
<pre>
class Foo
attr_accessor :foo
def succ; end
def <=>( rhs ); end
end
o1 = Foo.new
o2 = Foo.new
r = o1..o2
o1.foo = r
p SOAPMarshal.load( SOAPMarshal.dump( r ))
</pre></li>
<li>Supports some instance variable of ruby standard class.
But instance variable of Array, Hash, String, Float and Bignum are not supported because of restriction of SOAP encoding format...</li>
<li>Alias ::SOAPMarshal to ::SOAP::Marshal.</li>
<li>Added Marshal.load and Marshal.dump as aliases to Marshal.unmarshal and
Marshal.unmarshal.</li>
</ul></dd>
<dt>misc</dt>
<dd>
<ul>
<li>Dumps what parser is used when $DEBUG. Try 'ruby -d -rsoap/processor -e 0'</li>
<li>Added CGI samples in sample/.</li>
<li>Some performance check and tuning has been done on both client and server side.
One bottle neck is Kernel.methods which SOAP4R use(d) while mapping SOAP Data Model <-> Ruby object.
I replaced it with Object.respond_to? .
Another bottle neck of client side is delegate.rb which is used by http-access2.
Get <a href="http://raa.ruby-lang.org/list.rhtml?name=http-access2">[RAA:http-access2]</a> version F.
</ul>
</dd>
</dl>
</dd>
<dt>1.4.4 - May 6, 2002</dt>
<dd>
This is a bug fix release.
Following users should update.
<ul>
<li>Users who use DateTime datatype.</li>
<li>Developers of SOAP client/server which works under multi-thread condition.</li>
<li>REXML users.</li>
</ul>
Fixed bugs.
<ul>
<li>XSDDataTime: Changed variable name usec to sec_frac. It's not a micro sec so name usec is misleading.</li>
<li>XSDTime: Fixed bugs in usec part.</li>
<li>date.rb in standard library and date2 version 3 conflicts because date2.rb is a successor of date.rb and not designed for dual use.
(ex. using a module which requires date.rb like DBI and another module which requires date2.rb).
Added a workaround for this.</li>
<li>SOAP::Processor was not MT-safe. Fixed.
Projected feature regards to MT are follows.
At least I hope so. Tell me if you find these wrong.
<ul>
<li>Driver: safe</li>
<li>Proxy: safe</li>
<li>Server: safe</li>
<li>CGIStub: safe</li>
<li>StandaloneServer: safe</li>
<li>RPCRouter: safe</li>
<li>StreamHandler: safe</li>
<li>Processor: safe</li>
<li>SOAPParser: unsafe</li>
<li>SOAPGenerator: unsafe</li>
<li>EncodingStyleHandler: unsafe</li>
</ul>
</li>
<li>SOAP4R/1.4.3 supports REXML/2.1.3 but it did not detect REXML processor automatically.</li>
</ul>
</dd>
<dt>1.4.3 - April 11, 2002</dt>
<dd>
<dl>
<dt>Attention to 1.4.2 or earlier users;</dt>
<dd>
<ul>
<li>Stopped redistributing packages in RAA from this release.
Please get <a href="#dependencies">required</a> packages from
<a href="http://raa.ruby-lang.org">RAA</a>
and install it.</li>
<li>It still does NOT support WSDL!</li>
</ul>
</dd>
<dt>New features</dt>
<dd>
<ul>
<li>Added REXML parser support.</li>
<li>Added uninstaller.</li>
<li>Re: samples
<ul>
<li>Added 3 new samples, Calc, Exchange, and SampleStruct.</li>
<li>Use environment variable HTTP_PROXY or http_proxy for http proxy.</li>
<li>Removed unreachable services.</li>
<li>RAA: Separate iRAA.rb into RAA.rb and iRAA.rb.</li>
<li>Added description about <a href="#samples">samples</a> to RELEASE_en.html.</li>
</ul>
<li>Changed String encoding handling among
Ruby object <-> SOAP Data Model <-> XML instance.
<ul>
<li>Ruby object: $KCODE.</li>
<li>SOAP Data Model: utf-8 if uconv module is installed, $KCODE if not.</li>
<li>XML instance: Client side use utf-8 if uconv module is installed,
$KCODE if not. Server side try to adjust the request encoding.</li>
<li>Use regexp instead of NKF.guess to check if the given String is EUC/SJIS or not.</li>
</ul>
</li>
<li>Added 'addServant' interface to server side. See sample/Calc/server.rb.</li>
<li>Added 'addMethodAs' interface to both server side and client side.
See sample/Calc/server2.rb.</li>
</ul>
</dd>
<dt>Changes</dt>
<dd>
<ul>
<li>Removed Japanese document.
I was tired of maintaining 2 separated documents.
Though my English is poor as you see, numbers of readers of my English document
should be more than one of my Japanese document.
Would you please tell me bug of my English composition and of course in the code?</li>
<li>Use
<a href="http://raa.ruby-lang.org/list.rhtml?name=devel-logger">[RAA:devel-logger]</a>
instead of
<a href="http://raa.ruby-lang.org/list.rhtml?name=application">[RAA:application]</a>.
</li>
<li>Avoided using exception in soap2obj and reduced warnings in runtime.</li>
<li>XSDDateTime: Use date2 version 3 instead of date3.rb.
Date2 version 3 will be included in standard distribution of Ruby/1.8.</li>
<li>XSDDateTime: Added XSDDateTimeToTime module to extract a Time object from XSDDateTime, XSDDate and XSDTime.</li>
</ul>
</dd>
<dt>Bug fixes</dt>
<dd>
<ul>
<li>Set 'charset=' to content-type when sending back a SOAPFault.
It was not set.</li>
<li>XSDDateTime: Parsedate was not used. Removed.</li>
<li>Added constant Log as a canonical name of Devel::Logger for backward
compatibility of devel-logger.</li>
<li>Foo = Struct.new(:foo) and Foo = Struct.new("Foo", :foo) could not be
unmarshalled collectly. All members were unmarshalled as nil. Fixed.</li>
<li>Rescue ArgumentError(Unrecognized signal) in standaloneServer.rb for mswin32 ruby.</li>
</ul>
</dd>
</dl>
</dd>
<dt>1.4.2 - December 28, 2001</dt>
<dd>
Many changes around Ruby language mapping for SOAP.
I replaced DRb's marshalling format with SOAP marshalling and it passed
about all unit test packed in DRb package.
Only test failed was regards to packet size.
You might be able to use SOAP::Marshal.(un|)marshal for serializing objects
instead of Marshal.(load|dump).
<ul>
<li>Illegal decoding of a position-less element after position-ed element. Fixed.</li>
<li>Add Rubytype encoding/decoding support: Regexp, Class, Module and Symbol.</li>
<li>Added an option of MappingRegistry to raise an exception when unknown Struct.
The option is set 'false' by default so that same behaviour as before.</li>
</ul></dd>
<dt>1.4.1 - December 7, 2001</dt>
<dd>SOAP4R/1.4 contained many bugs (as usual...)
1.4.1 is a maintenance release. Some bugs are fixed.
Thanks to Michael Neumann.
<ul>
<li>instance_eval in SOAPStruct#add for adding accessor illegaly overrode important methods for SOAP4R such as name, name= and so on. Removed this instance_eval and rewrote other codes which did depend the code. Thanks to MNeumann for reporting it and giving a suggestion to fix it.</li>
<li>Fixed charset handling. Illegal charset was set when automatic XML processor detecting.</li>
<li>Removed unused code(self.decode) in element.rb.</li>
<li>Illegal constant access when SOAP format error. Fixed.</li>
<li>LiteralEncodingNamespace moved to SOAP module.</li>
</ul></dd>
<dt>1.4 - December 5, 2001</dt>
<dd><ul>
<li>Datatypes:
<ul>
<li>XSDFloat: Bug in rounding double float to single float. Fixed.</li>
<li>SOAPElement: Added for literal encoding.</li>
<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>
<li>SOAPHeaderItem: Changed interface for easy use.</li>
</ul></li>
<li>SOAP Encoding:
<ul>
<li>Encoding by itself, not using NQXML's tree object model.</li>
<li>At last, supported multi-ref encoding!</li>
<li>marshal.rb: Marshalling with Envelope and Body. To marshal multi-ref'd object, Body is needed. CAUTION: Not compatible between former implementation.</li>
<li>Add EncodingStyleHandlerLiteral and set it to default.</li>
<li>Renamed encoding.rb to encodingStyleHandler.rb.</li>
<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>
<li>Changed element name escape.
<ul>
<li>:: <=> \.\.</li>
<li>[^a-zA-Z0-9_-] <=> \.[0-F][0-F]
</ul>
Limitation: 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>
</ul></li>
<li>RPC related functions:
<ul>
<li>Driver: Added 'invoke' method for messaging.</li>
<li>Driver: Content of SOAPFault detail element is set in the exception which is thrown from SOAP Node to client application.</li>
<li>Processor: Changed Processor.(un|)marshal interface. An instance of NS for parsing/generating XML instance is prepared in parser/generator.</li>
<li>mappingRegistry.rb is devided from rpcUtils.rb.</li>
</ul></li>
</ul></dd>
<dt>1.3.8 - October 4, 2001</dt>
<dd>Feedback from
<a href="http://www.whitemesa.com/interop.htm">SOAPBuilders Interoperability Lab "Round 2"</a>
and Michael Neumann. Thanks!
<ul>
<li>Datatypes:
<ul>
<li>XSDFloat: Creating float data from junk string such as "123.0junk" was
converted to 0.0. It should be avoided. Fixed.</li>
<li>XSDFloat: Fixed double -> single rounding code.</li>
</ul></li>
<li>RPC related functions:
<ul>
<li>Changed typename <=> NCName strategy. '::' <=> '.'</li>
<li>Added mappingRegistry argument to interfaces for SOAP object creation.</li>
</ul></li>
<li>Others:
<ul>
<li>Set faultstring '(No faultstring)' to SOAP Fault when empty faultstring element.</li>
<li>server.rb: Added mappingRegistry interface.</li>
<li>marshal.rb: Create NCName from typename.</li>
</ul></li>
</ul></dd>
<dt>1.3.7 - August 24, 2001</dt>
<dd>Feedback from
<a href="http://www.whitemesa.com/interop.htm">SOAPBuilders Interoperability Lab "Round 2"</a>
and Michael Neumann. Thanks!
<ul>
<li>Datatypes:
<ul>
<li>All datatypes try to keep nil correctly.</li>
<li>XSDInt/Integer/Long: to_i -> Integer() to detect format error.</li>
<li>XSDDateTime, XSDDate, XSDTime: Add trailing 'Z' to indicate UTC.</li>
<li>SOAPStruct: Accept untyped struct.</li>
<li>Map(Hash): Let <item> untyped.</li>
<li>Apache allows only 'item' in Map type.</li>
</ul></li>
<li>Stream handler:
<ul>
<li>Removed MPOST support.</li>
<li>ECONNRESET was not caught. Fixed.</li>
<li>Added timeout support.</li>
</ul></li>
<li>Others:
<ul>
<li>Changed using URI library: URb -> URI; following its name change.</li>
<li>Added NQXML/1.1.0 support. A XMLDecl now recognized as a XMLDecl, not a PI.</li>
</ul></li>
</ul></dd>
<dt>1.3.6 - July 27, 2001</dt>
<dd>Many feedbacks from Michael Neumann. Thanks!
<ul>
<li>hexBinary type: Added.</li>
<li>nil type: Should not be xsd:nil but xsi:nil.</li>
<li>Added StandaloneServer implementation. Thanks to Michael Neumann!</li>
<li>Illegal parsing of XMLDecl. Fixed.</li>
<li>RPC's 'inout' param was not supported. Fixed. Thanks to Michael Neumann!</li>
<li>URb::Generic#path returns '' when abs_path is empty (such as http://foo).
Added checking code.</li>
<li>Use http-access2 instead of original HTTP implementation. http-access2 supports HTTP/1.1's persistent connection.</li>
</ul></dd>
<dt>1.3.5 - July 14, 2001</dt>
<dd>Many feedbacks from Michael Neumann.
I much appreciate valuable comments to him.
Thanks!
<ul>
<li>Changed using URI library: uri -> URb.</li>
<li>Types changed:
<ul>
<li>All: Triming data except XSDString before parsing it.</li>
<li>String: Regexp for XML Char check did not work under $KCODE = 'UTF8' condition. Fixed.</li>
<li>Nil: 2001xsd:nil must not accept a value '1'. 1999xsd:null must not accept a value 'true' because these are not a boolean but only a flag for nil. Fixed.</li>
</ul>
</li>
<li>Supported XML parser:
<ul>
<li>Added automatic CES conversion support for NQXMLParser.
(Depends on uconv module).
Set $KCODE for regexps used in NQXML parser.</li>
<li>Moved SOAPNQXML*Parser to nqxmlparser.rb.</li>
</ul>
</li>
<li>RPC related functions changed:</li>
<ul>
<li>Added marshalling/unmarshalling Ruby's object using SOAP Encoding.</li>
<li>Parallelize of signatures of 'addMethod': proxy.rb <-> rpcRouter.rb, driver.rb <-> cgistub.rb.</li>
<li>Void return if 'retval' is not defined.</li>
<li>Added SOAP's Long type to default mapping table.</li>
</ul>
</li>
</ul></dd>
<dt>1.3.4.2 - July 11, 2001</dt>
<dd>SOAP4R/1.3.4 was once packed in July 10, 2001.
But, thanks to MNeumann and knu,
I found I had forgotten to pack 'redist' directory with it.
I added some fix from developing version and repack it as 1.3.4.2.
Sorry for frequently release...
<br/><br/>
Feedback from
<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
and Michael Neumann. Thanks!
<ul>
<li>Added in 1.3.4.2:
<ul>
<li>Type Decimal: Silly bug fixed. 0.0001 was converted to 0.1</li>
<li>CGIStub returns HTTP status 500 when returning SOAP Fault.
Returned 200 because I don't like this spec., but SOAP/1.2 W3C WD
9 July 2001 have adopted it. Hmm...</li>
<li>RPC client(driver.rb): Exception#set_backtrace was omitted when transmitting exception by SOAP Fault.</li>
</ul>
</li>
<li>Types changed:
<ul>
<li>Array: Incomplete sparse array support. Fixed.</li>
<li>Date: Added.</li>
<li>Time: Added.</li>
<li>DateTime: Added precision of time support.</li>
<li>String: Default data should not be nil but ''.</li>
<li>Nil: Attribute value of xsi:nil might be '1' instead of 'true'. Fixed.</li>
</ul>
</li>
<li>Supported XML parser:
<ul>
<li>Added SOAPXMLParser and SOAPSAXDriver for XMLParser which uses expat.
You can get the module from RAA: <a href="http://raa.ruby-lang.org/list.rhtml?name=xmlparser">XMLParser module</a>.<br/>
To use XMLParser -> add "require 'soap/xmlparser'".<br/>
To use SAX driver of XMLParser -> add "require 'soap/saxdriver'".<br/>
To use NQXMLParser -> nothing to do.<br/>
FYI:
<ul>
<li>XMLParser version is faster than others</li>
<li>SAXDriver version is extremely slow</li>
<li>NQXMLParser version is somewhat slower than XMLParser version</li>
<li>XMLParser is a Ruby extension module; To use it, you must compile and install it.</li>
<li>So far, automatic code conversion support is for XMLParser and SAXDriver. See below.</li>
</ul>
</li>
<li>Added automatic CES conversion support: UTF-8 <-> EUC, SJIS.
Requires Uconv module. Works with XMLParser module only now.</li>
<li>Added XMLDecl for CES.</li>
</ul>
</ul></dd>
<dt>1.3.3 - July 4, 2001</dt>
<dd>Feedback from
<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
and Michael Neumann. Thanks!
<ul>
<li>Added SOAP4R Installer by Michael Neumann. Thanks!</li>
<li>Types changed:
<ul>
<li>Boolean: Accepts 1 and 0 in addition to true and falue.</li>
<li>Float: handles single-precision 32-bit floating point.
Ruby's float is doule-precision.</li>
<li>Double: Added. Mapped to Ruby's Float.</li>
<li>DateTime: Added TZ support.</li>
<li>Long: Added.</li>
<li>Int: Changed class hierarchy; derived from Long now.</li>
<li>Array: Added 'position' and 'offset' support.</li>
<li>Array: Added M-D Array support.</li>
<li>Decimal: Added but it's incomplete now.</li>
</ul>
</li>
<li>Illegal error message when a type not found in SOAP-ENC.</li>
<li>Tries to transmit \r safely. To be checked...</li>
<li>Parse Fault items like 'faultcode' as same as Body ie. href/id.</li>
<li>rpcUtils.rb was completely re-written.
<ul>
<li>Added mappingRegistry interface.</li>
<li>Changed soap2obj and obj2soap's interface.</li>
<li>Bignum might be int or integer. It's dependent on platform.
Changed to check range -2147483648~+2147483647 itself.</li>
<li>ary2md: Added. Converting Array ((of Array)...) to M-D Array.</li>
<li>struct2obj: Illegal dependency on ordering of Struct#members. Fixed.</li>
<li>Ruby's Array should be converted to SOAP's Array of anyType. Fixed.</li>
</ul>
</li>
<li>Dump HTTP header even when an error was raised.</li>
</ul></dd>
<dt>1.3.2 - June 21, 2001</dt>
<dd>Feedback from
<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
<ul>
<li>"nil='1'" should be "nil='true'" in 2001 schema
whereas "null='1'" in 1999 schema. Fixed.</li>
<li>SOAP Array was not typed with xsi:type.</li>
<li>Fixed serialization root handling algorithm.</li>
<li>Supported kind of SOAP-ENC:String style typed element.</li>
<li>Default namespace was not derived to child element. Fixed.</li>
<li>Support default encodingStyle.</li>
<li>Added support for void type (SOAP::RPCUtils::SOAPVoid).</li>
</ul></dd>
<dt>1.3.1 - May 30, 2001</dt>
<dd>Feedback from
<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
<ul>
<li>Heading and trailing whtespaces in Base64 string could not be processed. Fixed.</li>
<li>Illegal typeNamespace of SOAP's base64 type. Fixed.</li>
<li>Added NaN, INF, -INF support of Float type.</li>
<li>Extracted xsd:1999 type support to XMLSchemaDatatypes1999.rb. Use it with 'require "soap/XMLSchemaDatatypes1999"'.</li>
<li>Added 'root' attribute support.</li>
<li>Return status 500 when Fault.</li>
</ul></dd>
<dt>1.3.0 - May 20, 2001</dt>
<dd><ul>
<li>Adopted
<a href="http://raa.ruby-lang.org/list.rhtml?name=nqxml">NQXML module</a>
instead of XMLParser module extensively.
(You can implement your SOAP parser with XMLParser module.
See the last part of lib/soap/parser.rb)
<ul>
<li>Use NQXML's streamingParser or tokenizer instead of XMLParser's DOMParser for unmarshalling.</li>
<li>Use NQXML's document instead of XMLParser's DOM for marshalling.</li>
</ul></li>
<li>Passed major(?) part of inteoperability test in
<a href="http://www.xmethods.net/ilab/">`SOAPBuilders Interoperability Lab.'</a>
See test/interop/README.txt.</li>
<li>Changed module namespace. SOAPFoo -> SOAP::Foo.</li>
<li>Added float datatype support.</li>
<li>Changed dateTime marshalling format. No timezone was added to marshalled string because SOAP4R does not support timezone now.</li>
</ul></dd>
<dt>1.2.0 - March 30, 2001</dt>
<dd>Checked interoperability with
<a href="http://xml.apache.org/soap/">Apache-SOAP</a>,
<a href="http://www.pocketsoap.com">pocketSOAP/0.91</a>,
<a href="http://www.geocities.com/paulclinger/soap.html">SOAP::Lite for Perl</a>,
and <a href="http://www.develop.com/soap/">SOAP/Perl/0.28</a>.
It seems to work good except SOAP/Perl/0.28.
<ul>
<li>Added href/id unmarshalling support.
(href/id marshalling has not been supported yet)</li>
<li>Added SOAP's base64 type support.</li>
<li>SOAPTimeInstant -> SOAPDateTime. Following XML Schema PR.</li>
<li>SOAPStruct can have multiple accessor which have same name.
Should I separate it from original SOAPStruct?</li>
<li>Unknown attribute in Header Item raised an exception. Omitted.</li>
<li>Router can handle methods which belong to different namespace.</li>
<li>Added an option to allow unqualified SOAP element.</li>
<li>Added Apache's Map type support. Ruby's Hash are mapped to it now.
(Ruby's Hash marshalled by 1.1 processor in the old way can be unmarshalled,
but 1.2 processor marshals it in the new way and 1.1 processor does not
unmarshals it into Hash. Incompatibility between SOAP4R/1.2 and 1.1)</li>
<li>Unknown type 'unknown:SOAPStruct' was incorrectly unmarshalled into SOAPStruct. Fixed.</li>
<li>Added utility methods map! and members to SOAPArray and SOAPStruct.</li>
<li>Added methods request, response, and fault to SOAPBody.</li>
</ul></dd>
<dt>1.1.0 - March 23, 2001</dt>
<dd>Made many changes.
Since it is tested only for my limited use, please be careful to use.
Any comments especially "cannot connect to XXX implementation" are welcomed.
Feel free sending mail to
<a href="mailto:nahi@ruby-lang.org" class="path">nahi@ruby-lang.org</a>.
<ul>
<li>Added RPC server support.</li>
<li>Divided RPC client/server implementation from core.</li>
<li>Added Date, Hash type support. (Unknown type is converted to Struct as usual)</li>
<li>Adopted Date in date3.rb by Funaba-san instead of Time as TimeInstant.</li>
<li>Many encoding/decoding bugs around SOAPArray and SOAPStruct were fixed.</li>
</ul></dd>
<dt>1.0.2 - November 11, 2000</dt>
<dd>Since the previous package dated, refreshes some points.
<ul>
<li>Ruby: ruby 1.6.x</li>
<li>uri.rb: 4.22</li>
<li>sample: xml-soap/2.0</li>
</ul></dd>
<dt>1.0.1 - July 27, 2000</dt>
<dd>Handles SOAP/1.1 arrays.
1.0.0 cannot handles SOAP/1.1 arrays...
Bear in mind there still be many
<a href="#restrictions">restrictions</a>
around SOAP arrays.</dd>
<dt>1.0.0 - July 17, 2000</dt>
<dd>It is the initial released version of SOAP4R. :-)</dd>
</dl>
<h2 id="author" name="author"><span class="content">9. Author</span></h2>
<dl>
<dt>Name</dt>
<dd>NAKAMURA, Hiroshi (aka NaHi or nakahiro)</dd>
<dt>E-mail</dt>
<dd><a href="mailto:nahi@ruby-lang.org" class="path">nahi@ruby-lang.org</a></dd>
</dl>
<h2 id="copyright" name="copyright"><span class="content">10. Copyright</span></h2>
<p style="text-align: center;">
SOAP4R<br />
Copyright © 2000-2007 NAKAMURA, Hiroshi <nahi@ruby-lang.org>.
</p>
<p>
This program is copyrighted free software by NAKAMURA, Hiroshi. You can
redistribute it and/or modify it under the same terms of Ruby's license;
either the dual license version in 2003 (see the file RUBYS), or any later
version.
</p>
</div>
<hr />
<div class="footer">
<address>
<a href="http://dev.ctor.org/soap4r">SOAP4R</a>.<br />
Copyright © 2000-2007 NAKAMURA, Hiroshi.
</address>
</div>
</body>
</html>
|
