-
Notifications
You must be signed in to change notification settings - Fork 388
Expand file tree
/
Copy pathReleaseNotes.html
More file actions
2235 lines (1916 loc) · 86 KB
/
ReleaseNotes.html
File metadata and controls
2235 lines (1916 loc) · 86 KB
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
<!DOCTYPE html PUBLIC
"-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1" />
<style type="text/css">
dt { font-weight: bold; }
h3 { text-decoration: underline; }
dd p { margin-top: 0px; }
</style>
<title>Wt Release notes</title>
</head>
<body>
<h1>Wt Release notes</h1>
This file lists important notes on migrating existing applications to
newer version of Wt. It lists changes in the library that may break
the way you build Wt, the way you configure Wt or the Wt API and
behaviour.
<h2>Release 3.1.9 (April 7, 2011)</h2>
<p>
This release contains mostly bug fixes and quality improvements.
</p>
<h3>A) New classes:</h3>
<dl>
<dt>
<a href="classWt_1_1WAbstractSpinBox.html">WAbstractSpinBox</a>,
<a href="classWt_1_1WDoubleSpinBox.html">WDoubleSpinBox</a>
</dt>
<dd>
Refactored and reimplemented the spinbox control into an integer
and floating point version, which may be implemented either using
a native HTML5 element or a portable Wt implementation.
</dd>
</dl>
<h3>B) Main new features in existing classes:</h3>
<dl>
<dt>
Internal path handling: HTML5 History API
</dt>
<dd>
<div>
When the browser supports the HTML5 History API, URLs are now the
same for plain HTML and Ajax-enabled session (i.e. without the '#'
trick). This can improve load time and improves the
user-experience.
</div>
<div>
To avoid problems of resolving resources with relative URLs, a
new property 'baseURL' can be used (that can be configured in
wt_config.xml), which allows all relative URLs be resolved from
the same location.
</div>
</dd>
<dt>
Internal path handling: no ugly internal paths ('?_=/path')
</dt>
<dd>
The configuration option (--docroot) for the built-in
httpd allows to specify folders with static paths and when doing
so, all other requests are forwarded to the application, which in
turn does no longer need to rely on the ugly '?_=' query parameter
to encode its internal paths.
</dd>
<dt>
<a href="classWt_1_1WPdfImage.html">WPdfImage</a>, <a href="classWt_1_1WRasterImage.html">WRasterImage</a>
</dt>
<dd>
Improved font support: the library can be optionally built to use
libpango for resolving characters to glyphs. This allows text to
be rendered using a mix of different fonts that all provide only
partial coverage for the entire unicode range. Note that for
WPdfImage, this currently requires use of a libharu fork
(https://github.com/kdeforche/libharu/tree/)
</dd>
<dt>
<a href="classWt_1_1WAbstractItemView.html">WAbstractItemView</a>,
WTableView and WTreeView
</dt>
<dd>
Implementation of setRowHeaderCount() which fixes the number of
columns that are used as row headers and remain fixed while
scrolling horiziontally through the table. This replaces the now
deprecated setColumn1Fixed() API.
</dd>
<dt>
<a href="classWt_1_1WRasterImage.html">WRasterImage</a>
</dt>
<dd>
Several quality improvements: correct rendering of alpha
compositing, text rendering by libpango,
</dd>
<dt>
<a href="classWt_1_1WSlider.html">WSlider</a>
</dt>
<dd>
The slider has been reimplemented to allow for using either the
native HTML5 slider control, or the Wt implementation. The Wt
implementation can now also be styled through CSS.
</dd>
<dt>
<a href="classWt_1_1WServer.html#abca6890dab44d87bd3af64705ac072d3">WRun()</a>,
<a href="classWt_1_1WServer.html#a84f84652ccb139850adcf5ea75f50fa5">WServer::addEntryPoint()</a>
</dt>
<dd>
The callback function is now a boost::function<> object, allowing
you to bind other variables into the callback function.
</dd>
<dt>
<a href="classWt_1_1WServer.html#a2894484a9661d728dc9aa60ba79bb570">WServer::post()</a>
</dt>
<dd>
A safe method to post events to a session, and a useful
alternative to WApplication::UpdateLock. The simplechat and
codeview examples were converted to illustrate this method rather
than the (dead-lock prone) WApplication::UpdateLock approach.
</dd>
<dt>
<a href="classWt_1_1WString.html#abcff7d3d30972762bd5d9279dc903a36">WString::trn()</a>
</dt>
<dd>
Implementation of plural string resolution, with locale-dependent
rules. The implementation provided
by <a href="classWt_1_1WMessageResourceBundle.html">WMessageResourceBundle</a>
allows the same kind of expressions as GNU ngettext().
</dd>
<dt>
<a href="classWt_1_1Chart_1_1WAxis.html#ab36cb584a0aa8bdcc1c3212a9304e6cd">Chart::WAxis::setResolution()</a>
</dt>
<dd>
Allows to specify the minimum chart axis resolution (contributed by Gaetano Mendola).
</dd>
<dt>
<a href="classWt_1_1Dbo_1_1Transaction.html">Dbo::Transaction</a>
</dt>
<dd>
Fixed an issue with internal inconsistencies after transaction rollback.
</dd>
</dl>
<h3>C) Non-backwwards compatible changes</h3>
<dl>
<dt>Changed i18n keys for <tt>Wt.WDate.Mon-Sun</tt>
and <tt>Wt.Date.Jan-Dec</tt></dt>
<dd>
We were pointed out the fact that the built-in i18n keys for WDate
month names had a collision for the month 'May', which had the
same key for the abbreviated 3-letter variant as the full length
variant. Therefore in this release we reformatted the abbreviated
3-letter variant keys to <tt>Wt.WDate.3.Mon-Sun</tt>
and <tt>Wt.WDate.3.Jan-Dec</tt>. You will need to update your own
languages copies of these (or better, contribute them and we'll
maintain them for you!).
</dd>
</dl>
<h3>D) Android and iPad/iPhone targets</h3>
<p>This release contains initial work on supporting Android and
iPad/iPhone as targets for deploying Wt applications within a webkit
view widget.</p>
<p>For iPad/iPhone, we added a script that builds Wt as an OSX Framework
which may be used in XCode to build iOS applications.</p>
<p>For Android, we added support for building the library and examples as
shared objects which are packaged together with a small Java project
which instantiates a WebView, into standalone APK files.</p>
<p>This is ongoing work. We need to improve support in Wt for Mobile
Webkit to make the applications look and behave more as native
applications on these devices.</p>
<hr>
<h2>Release 3.1.8 (Feb 4, 2011)</h2>
<p>
This release contains mostly bug fixes, quality improvements,
and a few new features.
</p>
<h3>A) New classes:</h3>
<dl>
<dt><a href="classWt_1_1WFontMetrics.html">WFontMetrics</a></dt>
<dd>
A font metrics class. Font metrics are only available for
WPdfImage, and an implementation is planned for WRasterImage.
</dd>
<dt><a href="classWt_1_1Render_1_1WTextRenderer.html">Render::WTextRenderer</a>,
<a href="classWt_1_1Render_1_1WPdfRenderer.html">Render::WPdfRenderer</a></dt>
<dd>
A renderer class for a subset of XHTML, useful for e.g.~generatig
PDF reports.
</dd>
</dl>
<h3>B) Main new features in existing classes:</h3>
<dl>
<dt>
<a href="classWt_1_1WAbstractItemView.html#ad11215811b4de66f3d3c4267b694fe38">WAbstractItemView::setHeaderItemDelegate()</a>
</dt>
<dd>
Rendering of header cells is now also delegated and can be customized.
</dd>
<dt>
<a href="classWt_1_1WAbstractItemView.html#a027a8ad4967a0e269bdabbffca15f489">WAbstractItemView::scrollTo()</a>
</dt>
<dd>
Scroll to a particular item.
</dd>
<dt>
<a href="classWt_1_1WApplication.html#a44c5f0398b5539269be3961b26e95b08">WApplication::setLayoutDirection()</a>
</dt>
<dd>
Added support for Right-To-Left (mirrored) layouts, typically used
with some middle-Eastern languages. In addition to HTML's built-in
support for RTL directionality, layout managers, tables and MVC
tree/table views render their columns in the opposite order.
</dd>
<dt>
<a href="classWt_1_1WBoxLayout.html">WBoxLayout, WGridLayout, WBorderLayout</a>
</dt>
<dd>
Empty layout items do longer create padding, and thus padding
collapses around empty items (both horizontally and vertically).
</dd>
<dt>
<a href="classWt_1_1WEvent.html">WEvent::eventType()</a>
</dt>
<dd>
Information on the event type may be used during WApplication::notify()
for e.g. detecting user activity.
</dd>
<dt>
<a href="classWt_1_1WGoogleMap.html">WGoogleMap</a>
</dt>
<dd>
Added support for Google API version 3, alongside version 2.
</dd>
<dt>
<a href="classWt_1_1WPdfImage.html">WPdfImage</a>
</dt>
<dd>
Added support true type font loading, a UTF8 patch for libharu is
pending to enable full unicode support text rendering.
</dd>
<dt>
<a href="classWt_1_1WWidget.html#afc4bfcc92fa39010cac8775f3332dfa5">WWidget::setWidth()</a>,
<a href="classWt_1_1WWidget.html#a7d82ee32496743fdd28b30461f95d5ec">WWidget::setHeight()</a>
</dt>
<dd>
Convenience methods for resize() for only width or height.
</dd>
<dt>
<a href="classWt_1_1Chart_1_1WCartesianChart.html">Chart::WCartesianChart</a>
</dt>
<dd>
A number of methods to customize the location and look of the legend.
</dd>
<dt>
<a href="classWt_1_1Chart_1_1WDataSeries.html#a9361e12e94699f59090ae8ac3a4921df">Chart::WDataSeries::setXSeriesColumn()</a>
</dt>
<dd>
Allow use of a specific X series for each data series in scatter plots.
</dd>
<dt>
<a href="group__dbo.html#ga0f2f0c37d44f27e151b8f12412240731">Dbo::belongsTo()</a>, <a href="group__dbo.html#ga0d0cbc70dcfebc659ea1662e9327c90c">Dbo::hasMany()</a>
</dt>
<dd>
Support for foreign key constraints (NotNull, OnDeleteCascade, etc...).
</dd>
<dt>
<a href="group__dbo.html#ga0f2f0c37d44f27e151b8f12412240731">Dbo::Session::rereadAll()</a>
</dt>
<dd>
Can be optionally given a single table name to reread (discard) all object
data from a single class/table.
</dd>
<dt>
<a href="structWt_1_1Dbo_1_1sql__value__traits.html">Dbo::sql_value_traits<bool>, Dbo::sql_value_traits<long></a>
</dt>
<dd>
Added mappings for C++ <tt>bool</tt> and <tt>long</tt> types.
</dd>
</dl>
<h3>C) API and other changes:</h3>
<dl>
<dt>
CORS (Cross-Origin Resource Sharing)
</dt>
<dd>
A communication method between browser and server is now chosen
based on the needs (same origin or cross-origin), and based on
browser support. Cross-Origin requests are now supported for both
Ajax and WebSockets, and are are chosen if available and needed,
reverting to dynamic script-tags otherwise.<br/>
The WApplication::setAjaxMethod() has no effect anymore, and has
been deprecated.
</dd>
<dt>
Bootstrap process has changed.
</dt>
<dd>
While tracking bootstrapping problems on IE8 (resulting in a blank
page instead of a shiny app), we not only found a good workaround
for that, but also found a way to implement the default bootstrap
mode so that the stylesheets are applied before the application is
rendered. This solves the annoying flicker you experienced with
the default bootstrap mode, and also allows us to remove a number
of workarounds for IE. As a result of various cleanups, more CSS
stylesheet rules have been pushed out to the external wt.css
(theme) stylesheet. If you've created your own theme, you will
need to take note.
</dd>
<dt>
<a href="group__painting.html#gaf67a889bc5e9f8ab3a59fe58b0fa2128">Wt::BrushStyle</a>
</dt>
<dd>
Wt::WBrushstyle has been renamed to Wt::BrushStyle. This makes it
consistent with the naming conventions of other enums. Sorry, our
mistake !
</dd>
</dl>
<hr />
<h2>Release 3.1.7 (Nov 26, 2010)</h2>
<p>
This release contains mostly bug fixes, quality improvements,
and a few new features.
</p>
<p>
Note: the package was updated (3.1.7a) on Nov 30 to fix a layouting
regression.
</p>
<h3>A) New classes:</h3>
<dl>
<dt><a href="classWt_1_1WGLWidget.html">WGLWidget</a></dt>
<dd>
A preview of WebGL support in Wt (work in progress).
</dd>
</dl>
<h3>B) Main new features in existing classes:</h3>
<dl>
<dt>
<a href="classWt_1_1WAbstractItemView.html#a120156dc59eaf3608916b679d937c5b8">WAbstractItemView</a>
</dt>
<dd>Added API for hiding columns.</dd>
<dt>
<a
href="classWt_1_1Chart_1_1WCartesianChart.html">WCartesianChart</a>,
<a
href="classWt_1_1Chart_1_1WCartesianChart.html">WPieChart</a>
</dt>
<dd>
Added support for ToolTipRole data, using WAbstractArea interactive areas.
</dd>
<dt>
<a href="classWt_1_1Dbo_1_1Session.html#ad59da4e078a4e6532da698425193bbdb">Dbo::Session::rereadAll()</a>
</dt>
<dd>
Reread all transient objects, as a catch-all solution to stale
data (data modified in another session).
</dd>
<dt>
<a href="classWt_1_1WInteractWidget.html#ac7d10a6cae1e23a791b44c0682a3c627">WInteractWidget</a>
</dt>
<dd>Added support for touch and gesture events (Mobile webkit).</dd>
</dl>
<h3>C) Misc:</h3>
<dl>
<dt>
WebSocket protocol support (experimental)
</dt>
<dd>Use of WebSocket for communication between browser and server
can now be used, by enabling <web-sockets> in the
configuration file (we're likely to turn this on by default in a
future version. There is automatic fallback to the current
XMLHttpRequest based communication if WebSockets are not available
or communication could not be established. WebSockets is only
available using the built-in httpd server (which is now also a
WebSocket server).</dd>
<dt>
Build improvements
</dt>
<dd>
<ul>
<li>Provide a workaround for broken g++ compiler shipped in Ubuntu
Maverick</li>
<li>Provide support for building without using
std::wstring (-DWT_NO_STD_WSTRING) or std::locale
(-DWT_NO_STD_LOCALE=OFF) support.
</li>
</ul>
</dd>
</dl>
<hr />
<h2>Release 3.1.6 (Oct 29, 2010)</h2>
<p>
This release contains a healthy mix of bug fixes, quality improvements,
and new features. And hopefully no regressions :-)
</p>
<h3>A) New classes:</h3>
<dl>
<dt><a href="classWt_1_1SyncLock.html">SyncLock<Lock></a></dt>
<dd>
A dead-lock avoidance adaptor for a Boost mutex lock, which provides
a controlled way of releasing the current application lock.
</dd>
<dt><a href="classWt_1_1WProgressBar.html">WProgressBar</a></dt>
<dd>
A progress bar, contributed by Thomas Suckow.
</dd>
<dt><a href="classWt_1_1WSpinBox.html">WSpinBox</a></dt>
<dd>
A spin box.
</dd>
<dt><a href="structWt_1_1boost__any__traits.html">boost_any_traits<Type></a></dt>
<dd>
A traits class for customized interpretation of data stored in a
boost::any. You can register a new type using <a href="group__modelview.html#ga91842a84102ee15d41102ccf0745f4e4">registerType<Type></a>.
</dd>
</dl>
<h3>B) Main new features in existing classes:</h3>
<dl>
<dt>
Native support for MSIE 9
</dt>
<dd>
MSIE 9 (Beta) is now supported in all its goodness, including support
for HTML5 canvas and (almost working) support for SVG.
</dd>
<dt>
<a href="classWt_1_1WApplication_1_1UpdateLock.html">
WApplication::UpdateLock</a>
</dt>
<dd>The lock is now a RIAA lock, getUpdateLock() has been deprecated.
The lock needs also to be tested against validity (using operator bool()):
when invalid the session that it is trying to lock is being destroyed.</dd>
<dt>
<a href="classWt_1_1WApplication.html#a506978cfb884af4bc6ffd5a5bc8476d6">WApplication::setConfirmCloseMessage()</a>
</dt>
<dd>Provide the user with a message to confirm navigating away from the
application.</dd>
<dt>
<a href="classWt_1_1WApplication.html#a9a4048e01b69a536e35f47eb2a59a69b">WApplication::unload()</a>
</dt>
<dd>Rather then waiting for the session to expire, an application
that is navigated away iis now notified of this and will by
default <tt>quit()</tt>.</dd>
<dt>
<a href="classWt_1_1WApplication.html#a149412d829d104621c445bc10604be53">WApplication::addMetaHeader()</a>
</dt>
<dd>Can now be used to specify "http-equiv" meta headers too.</dd>
<dt>
<a href="classWt_1_1WDatePicker.html#acda30d9035692895a2bb94090babc073">WDatePicker::changed()</a>
</dt>
<dd>I wonder how we ever did without.
</dd>
<dt><a href="classWt_1_1WAbstractArea.html#a3dbe39c26769a63e4bf63020e31e9f22">WAbstractArea::mouseWheel()</a>,
<a href="classWt_1_1WInteractWidget.html#a656a0e4d5af72af0190d84dedf0093c6">WInteractWidget::mouseWheel()</a>,
<a href="classWt_1_1WMouseEvent.html#a4354738e0bce7e57764a465f5e19895d">WMouseEvent::wheelDelta()</a></dt>
<dd>
Added mouseWheel() event.
</dd>
<dt><a href="classWt_1_1WFileUpload.html">WFileUpload</a></dt>
<dd>
Added support for the simultaneous upload of multiple files (HTML5
"multiple") attribute and showing a progress bar to show upload
progress.
</dd>
<dt><a href="classWt_1_1WFormWidget.html">WFormWidget::hasFocus()</a></dt>
<dd>
Returns whether the widget currently has the keyboard focus.
</dd>
<dt><a href="classWt_1_1WHTML5Media.html">WHTML5Media</a></dt>
<dd>
Added events to catch play, pause, play-back progress and volume
changes.
</dd>
<dt><a href="classWt_1_1WLineEdit.html">WLineEdit</a>, <a href="classWt_1_1WTextArea.html">WTextArea</a></dt>
<dd>
Added <tt>currentPosition()</tt>, <tt>selectionStart()</tt>,
<tt>selectedText()</tt>, and <tt>hasSelectedText()</tt> methods to retrieve
the current cursor position and selection.
</dd>
<dt><a href="classWt_1_1WPushButton.html#aa5830a2118836423f0c16d12bbfd57a0">WPushButton::setRef()</a></dt>
<dd>
Utility method to create an anchor that looks like a button, or a
button that behaves like an anchor, depending on your point of
view. There is also <tt>setResource()</tt> to set a resource as
target.
</dd>
<dt>
<a href="classWt_1_1WResource.html">WResource</a>
</dt>
<dd>Added API for upload progress tracking.</dd>
<dt>
<a href="classWt_1_1Http_1_1Request.html">Http::Request</a>
</dt>
<dd>Added support for HTTP request byte ranges, and this is now
interpreted by both the WFileResource and built-in httpd for static
files.
</dd>
<dt>
<a href="classWt_1_1Http_1_1Response.html">Http::Response</a>
</dt>
<dd>Added <tt>setContentLength()</tt> which allows you to specify the
lenght of the response in advance, proving a better user experience
for large downloads.
</dd>
<dt>
<a href="classWt_1_1Dbo_1_1Session.html#8712ff0d59f7bb6a4d2986ad9637cc9e">Dbo::Session::query()</a>
</dt>
<dd>Switched to a more complete Boost.Spirit parser for SQL queries, which
understands most of the SQL syntax, including functions,
"with ... select ... ".
</dd>
<dt>
<a href="classWt_1_1Dbo_1_1QueryModel.html">Dbo::QueryModel</a>
</dt>
<dd>Added support for custom column header names and changing the
undelrying query using setQuery() while preserving the current
column definitions.</dd>
<dt>
<a href="classWt_1_1Dbo_1_1SqlStatement.html">Dbo::SqlStatement</a>
</dt>
<dd>Added boost::posix_time::time_duration type support.</dd>
<dt>
<a href="structWt_1_1Dbo_1_1sql__value__traits.html">Dbo::sql_value_traits<WTime></a>
</dt>
<dd>Added template specialization for WTime.</dd>
</dl>
<hr />
<h2>Release 3.1.5 (Sep 10, 2010)</h2>
<p>
This release contains mostly bug fixes.
</p>
<h3>A) Main Changes</h3>
<dl>
<dt><a href="classWt_1_1WGridLayout.html">WGridLayout</a>,
<a href="classWt_1_1WBoxLayout.html">WBoxLayout</a></dt>
<dd>Optimized client-side rendering performance. Previously, every layout
manager used would automatically slowdown every event because it would try
to relayout each time. This is no longer the case.</dd>
<dt><a href="classWt_1_1WSocketNotifier.html">WSocketNotifier</a></dt>
<dd>The socket notifier has been resurrected (it was in an perpetual state
of brokeness) and now works reliably across targets.</dd>
</dl>
<h3>B) Changes that may break existing applications:</h3>
<h4>1) Built-in resource bundles</h4>
Starting with this version, Wt uses an internal message resource
bundle for the few strings it provides by itself (like for example
'Ok' for the ok button in a WMessageBox, or the days-of-week in WDate).
Previously, an ugly API was used in <a href="classWt_1_1WMessageBox.html">WMessageBox</a>,
<a href="classWt_1_1WCalendar.html">WCalendar</a>,
and <a href="classWt_1_1WDatePicker.html">WDatePicker</a>
using a boolean 'i18n' parameter in the constructor. All this has now been removed,
and instead the keys for these built-in strings have been documented. If you were
using these classes your application will no longer build, you can simply remove the
internationalization parameter and you will need to fix the keys you used for the
messages according to the documentation.
Any localized strings you use will take precedence over these built-ins.
All affected classes (only those listed above actually have changed API and behaviour) are:
<dl>
<dt><a href="classWt_1_1WAbstractItemView.html">WAbstractItemView</a></dt>
<dd>the paging tool bar buttons for graceful callback.</dd>
<dt><a href="classWt_1_1WCalendar.html">WCalendar</a></dt>
<dd>because of WDate</dd>
<dt><a href="classWt_1_1WDate.html">WDate</a> and <a href="classWt_1_1WDateTime.html">WDateTime</a></dt>
<dd>week days, month names</dd>
<dt><a href="classWt_1_1WDatePicker.html">WDatePicker</a></dt>
<dd>because of WCalendar and for the close button</dd>
<dt><a href="classWt_1_1WDefaultLoadingIndicator.html">WDefaultLoadingIndicator</a></dt>
<dd>loading text</dd>
<dt><a href="classWt_1_1WInPlaceEdit.html">WInPlaceEdit</a></dt>
<dd>save and cancel button text</dd>
<dt><a href="classWt_1_1WMessageBox.html">WMessageBox</a></dt>
<dd>standard buttons</dd>
<dt><a href="classWt_1_1WOverlayLoadingIndicator.html">WLoadingIndicator</a></dt>
<dd>standard buttons</dd>
<dt><a href="classWt_1_1WValidator.html">Validators</a></dt>
<dd>for the messages they display in case of error</dd>
</dl>
<h4>2) Other behavioural changes</h4>
<dl>
<dt><a href="structWt_1_1WDialog.html">WDialog</a></dt>
<dd>Escape will no longer result in the dialog being rejected. You can
enable this behaviour using the rejectWhenEscaped() method.
</dd>
</dl>
<hr />
<h2>Release 3.1.4 (Aug 13, 2010)</h2>
<p>
This release contains several new features, but also a few changes
that break backwards compatibility (but are unlikely to affect an
average application).
</p>
<h3>A) New classes:</h3>
<dl>
<dt><a href="classWt_1_1WBatchEditProxyModel.html">
WBatchEditProxyModel</a></dt>
<dd>A proxy model that caches editing operations to commit them atomically.
</dd>
<dt><a href="classWt_1_1WHTML5Audio.html">WHTML5Audio</a></dt>
<dd>Audio support using the HTML5 audio tag.</dd>
<dt><a href="classWt_1_1WPdfImage.html">WPdfImage</a></dt>
<dd>A WPaintDevice that writes to Pdf (using libharu).</dd>
<dt><a href="classWt_1_1WRasterImage.html">WRasterImage</a></dt>
<dd>A WPaintDevice that writes to a Png/Gif (using GraphicsMagick).</dd>
<dt>ISAPI connector</dt>
<dd>(Windows only) a connector that implements the Microsoft ISAPI
API, to integrate directly into Microsoft IIS. On Windows, this is
an alternative deployment option next to the built-in httpd.</dd>
</dl>
<h3>B) Main new features in existing classes:</h3>
<dl>
<dt>
<a href="classWt_1_1WAbstractItemView.html">WAbstractItemView</a>
</dt>
<dd>Added support for validators while editing.</dd>
<dt>
<a href="classWt_1_1WApplication.html#88b082dadadd3fb7dbe10887e7d89c91">WApplication</a>
</dt>
<dd>Added an appRoot() method this returns the value of the
special property "approot" which can in some cases be defined
implicitly by a connector (such as ISAPI), and which allows an
application to reference working files whereas previously it was
assumed that they were in the working directory (CWD).</dd>
<dt>
<a href="classWt_1_1WEnvironment.html#fd8726dfa8cabcb49895df4a6112ef48">WEnvironment::agent() and related</a>
</dt>
<dd>Convenience methods that return pre-parsed user agent identification,
should you want to differentiate based on browser.</dd>
<dt>
<a href="classWt_1_1WWidget.html#bb5949e98f47edb7db98d7b6df07a31c">WWidget::addStyleClass()</a>, <a href="classWt_1_1WWidget.html#3b8a35e37ef06c408f346c63a5f1aa8e">WWidget::removeStyleClass()</a>
</dt>
<dd>Added addStyleClass() and removeStyleClass() methods.</dd>
<dt>
<a href="classWt_1_1WMenu.html">WMenu, WMenuItem</a>
</dt>
<dd>Added support for closable and disabled items (not complete,
CSS is lacking for polished theme). Contributed by Dmitriy Igrishin.</dd>
<dt>
<a href="classWt_1_1WModelIndex.html#93c11e136a0fdc596eb745cc7fce7033">WModelIndex</a>
</dt>
<dd>Added support for in-place (destructive) encoding to and
decoding from a raw index, making this less of a hassle for View
classes.</dd>
<dt>
<a href="classWt_1_1WSortFilterProxyModel.html">WSortFilterProxyModel</a>
</dt>
<dd>Added support for row insertion/removal.</dd>
<dt>
<a href="classWt_1_1WSuggestionPopup.html">WSuggestionPopup</a>
</dt>
<dd>Allow usage as an advanced combo-box, with an explicit drop down
button and ability to react to a selection.</dd>
<dt>
<a href="group__dbo.html#gc98c1f90b00ed9ce243c6412da3ac489">Dbo::id()</a>
</dt>
<dd>Support for natural keys (possibly of composite type) next to the
built-in surrogate keys.</dd>
<dt>
<a href="structWt_1_1Dbo_1_1dbo__traits.html">Dbo::dbo_traits<C></a>
</dt>
<dd>By specializing this traits class, you can modify the surrogate id
field name (or disable it), and the optimistic version lock field
name (or disable it).</dd>
<dt>
<a href="classWt_1_1Dbo_1_1Session.html#8712ff0d59f7bb6a4d2986ad9637cc9e">Dbo::Session::query()</a>
</dt>
<dd>More robust query parsing (of the 'select' part), including
support for "select distinct".</dd>
<dt>
<a href="classWt_1_1Dbo_1_1QueryModel.html">Dbo::QueryModel</a>
</dt>
<dd>Added editing support (editing the model will modify the queried
dbo's).</dd>
<dt>
<a href="structWt_1_1Dbo_1_1query__result__traits.html">Dbo::query_result_traits<C></a>
</dt>
<dd>Added setValue(), create(), add() and remove() methods for modifying
queried results.</dd>
</dl>
<h3>C) Changes that break existing applications:</h3>
<dl>
<dt><a href="structWt_1_1Dbo_1_1Dbo.html">Dbo::Dbo</a></dt>
<dd>
This class is now a templated with the class name itself, in
order to provide the proper type for the (natural or surrogate) id
field for id(). You will need to replace
<pre>
class User : public Wt::Dbo { ... }
</pre>
with
<pre>
class User : public Wt::Dbo<User> { ... }
</pre>
</dd>
<dt>CSS</dt>
<dd>The toplevel container used by Wt is now given a <tt>position:
relative</tt> style; this was needed to be able to position widgets
(such as popups) using <tt>position: absolute</tt>, but may break
application layouts. You can override this CSS style by adding
<tt>.Wt-domRoot { position: static; }</tt> to your application's
(internal or external) stylesheet.
</dd>
</dl>
<hr />
<h2>Release 3.1.3 (May 20, 2010)</h2>
<p>
This release several new features, but also a few changes that
break backwards compatibility (but are unlikely to affect an average
application).
</p>
<h3>A) New classes:</h3>
<dl>
<dt><a href="classWt_1_1SignalBase.html">SignalBase</a>,
<a href="classWt_1_1EventSignalBase.html">EventSignalBase</a></dt>
<dd>Abstract base classes for signals (these are not actually new,
but they were not yet part of the API).</dd>
<dt><a href="classWt_1_1WHTML5Video.html">WHTML5Video</a></dt>
<dd>Video support using the HTML5 video tag (work-in-progress).</dd>
<dt><a href="classWt_1_1Dbo_1_1Call.html">Dbo::Call</a></dt>
<dd>Class for executing a database call.</dd>
<dt><a href="classWt_1_1Dbo_1_1SqlConnectionPool.html">
Dbo::SqlConnectionPool</a>,
<a href="classWt_1_1Dbo_1_1FixedSqlConnectionPool.html">
Dbo::FixedSqlConnectionPool</a></dt>
<dd>Connection pool interface and implementation.</dd>
<dt><a href="classWt_1_1Dbo_1_1QueryModel.html">Dbo::QueryModel</a></dt>
<dd>An tabular item model for query results.</dd>
</dl>
<h3>B) Main new features in existing classes:</h3>
<dl>
<dt><a href="classWt_1_1WAbstractItemDelegate.html">WAbstractItemDelegate</a></dt>
<dd>Added methods for editing: editState(), setEditState(),
setModelData() and closeEditor().</dd>
<dt><a href="classWt_1_1WAbstractItemView.html">WAbstractItemView</a></dt>
<dd><div>New editing API: edit(), closeEditor(), saveEditedValue(),
setEditOptions(), setEditTriggers().</div>
<div>Graceful degradation support using a paging navigation bar, which
may be customized by reimplementing createPageNavigationBar().</div>
</dd>
<dt><a href="classWt_1_1WCalendar.html">WCalendar</a>, <a href="classWt_1_1WDatePicker.html">WDatePicker</a></dt>
<dd>Added setBottom() and setTop() methods to specify a valid range.</dd>
<dt><a href="classWt_1_1WInteractWidget.html">WInteractWidget</a></dt>
<dd>Added a mouseDragged() event for responding to mouse moves while
a mouse button is down.</dd>
<dt><a href="classWt_1_1WItemDelegate.html">WItemDelegate</a></dt>
<dd>Implements editing using a WLineEdit.</dd>
<dt><a href="classWt_1_1WMenu.html">WMenu</a></dt>
<dd>Can now be used without a contents stack.</dd>
<dt><a href="classWt_1_1WSuggestionPopup.html">WSuggestionPopup</a></dt>
<dd>Added API to support dynamic server-side filtering.</dd>
<dt><a href="classWt_1_1WTableView.html">WTableView</a></dt>
<dd>New implementation which supports horizontal and vertical
virtual scrolling, column resizing, drag and drop, etc... like
WTreeView.</dd>
<dt><a href="classWt_1_1Chart_1_1WPieChart.html">Chart::WPieChart</a></dt>
<dd>Supports now also a shadow effect.</dd>
<dt><a href="classWt_1_1Dbo_1_1collection.html">Dbo::collection</a></dt>
<dd>A find() method has been added to refine the query of a many-side relational.</dd>
<dt><a href="classWt_1_1Dbo_1_1ptr.html">Dbo::ptr</a></dt>
<dd>A version() method returns the current version.</dd>
<dt><a href="classWt_1_1Dbo_1_1Query.html">Dbo::Query</a></dt>
<dd>An extra template parameter specifies a binding strategy. The
default binding strategy is DynamicBinding, which allows reuse of
the query object, and provides new API to modify the query:
where(), orderBy(), groupBy(), offset(), limit().</dd>
<dt><a href="classWt_1_1Dbo_1_1Session.html">Dbo::Session</a></dt>
<dd>Added support for use with a connection pool. Added execute()
method to execute an SQL statement.</dd>
<dt>Built-in httpd</dt>
<dd>Support for HTTP Range header and partial content servering.</dd>
</dl>
<h3>C) Changes that break existing applications:</h3>
<dl>
<dt><a href="structWt_1_1Dbo_1_1query__result__traits.html">Dbo::sql_result_traits</a></dt>
<dd>This traits class has been renamed to query_result_traits and
its API has changed considerably. This will only impact when you
have implemented a custom traits specialization. The getColumns()
method has been replaced with a getFields() method, and the
loadValues() method has been renamed to load(). A getValues()
method has been added which provides conversion to boost::any's.
</dd>
<dt><a href="classWt_1_1WTableView.html">WTableView</a></dt>
<dd>This View class was reimplemented to have functionality
comparable to WTreeView. In the process, we had to abandon the
underlying <table> representation because of rendering
issues with Chrome (of all browsers!), although the WTableView
documentation specifically promised that we would keep this.
</dd>
</dl>
<hr />
<h2>Release 3.1.2 (March 26, 2010)</h2>
<p>This release contains mostly bug fixes, and a few new features.</p>
<h3>A) New classes:</h3>
<dl>
<dt><a href="classWt_1_1WShadow.html">WShadow</a></dt>
<dd>Class representing a drop shadow effect (see below).</dd>
<dt><a href="classWt_1_1Dbo_1_1backend_1_1Postgres.html">Dbo/backend/Postgres</a></dt>
<dd>A Postgres backend has landed, contributed by Hilary Cheng.</dd>
</dl>
<h3>B) Main new features in existing classes:</h3>
<dl>
<dt><a href="classWt_1_1WBoxLayout.html">WBoxLayout</a>, <a href="classWt_1_1WGridLayout.html">WGridLayout</a></dt>
<dd>Addition of horizontal and vertical splitter support (resize handles to
allow the user to adjust the layout), sponsored by Eurofer. The new API
methods are <a href="classWt_1_1WBoxLayout.html#00bdfb4d442bd8e8ad9c33b72692763f">setResizable()</a>, <a href="classWt_1_1WGridLayout.html#180c33a8f9e21a7b58f12e055fdb469e">setColumnResizable()</a> and <a href="classWt_1_1WGridLayout.html#6028853eb5a66d868323d0e034b69390">setRowResizable()</a></dd>
<dt><a href="classWt_1_1WCalendar.html">WCalendar</a></dt>
<dd>Improved the API to allow custom cell rendering, and custom handling
of selection. We have also made the API for selection consistent with other
widgets (like WTreeView), deprecating the old API.</dd>
<dt><a href="classWt_1_1WDateTime.html">WDateTime</a></dt>
<dd>Added <a href="classWt_1_1WDateTime.html#0d7f04bacc6ea6534bc61ec7305a8262">toPosixTime()</a> and <a href="classWt_1_1WDateTime.html#eb5f093554829688b36640f0977da541">fromPosixTime()</a> methods to interoperate with
<tt>boost::posix_time::ptime</tt>.</dd>
<dt><a href="classWt_1_1WFormWidget.html">WFormWidget</a></dt>
<dd>Added a <a href="classWt_1_1WFormWidget.html#92de7a4d9ca6796607dc9fd26f608436">setEmptyText()</a> method to implement a label inside a line edit or text area.</dd>
<dt><a href="classWt_1_1WPainter.html">WPainter</a></dt>
<dd>Added a <a href="classWt_1_1WPainter.html#9c727b82879ab055f3fcf4c9cdfc1f8d">setShadow()</a> method which defines a drop shadow to be used for subsequent
drawing actions.</dd>
<dt><a href="classWt_1_1WResource.html">WResource</a></dt>
<dd>Added a <a href="classWt_1_1WResource.html#06bb9dbe3ae195c320cfed7b062d448a">setInternalPath()</a> method which allow a resource to be deployed at a deterministic and "pretty" URL.</dd>
<dt><a href="classWt_1_1WString.html">WString</a></dt>
<dd>Added constructors that take a std::locale for interpreting a narrow
string in a given locale.</dd>
<dt><a href="classWt_1_1WWidget.html">WWidget</a></dt>
<dd>Added <a href="classWt_1_1WWidget.html#4f83592912a7f8fa4fd35dadde78ee74">setLayoutSizeAware()</a> and <a href="classWt_1_1WWidget.html#f432588db3d599f89b54121f2ede8d63">layoutSizeChanged()</a> methods which allow a widget to react to layout size changes.</dd>
<dt><a href="classWt_1_1Http_1_1Request.html">Http::Request</a></dt>
<dd>Added access to the request <a href="classWt_1_1Http_1_1Request.html#e76664f93462d9311ee671c93607e5ca">method()</a>.</dd>
<dt><a href="classWt_1_1Http_1_1Response.html">Http::Response</a></dt>
<dd>Added a <a href="classWt_1_1Http_1_1Response.html#7c14ba3ab34ff14461df3a4369118443">setStatus()</a> method to modify the response status.</dd>
<dt><a href="classWt_1_1Dbo_1_1Session.html">Dbo::Session</a></dt>
<dd>Added support for schema qualified tables, in
<a href="classWt_1_1Dbo_1_1Session.html#5886d450c052ae0ee15ab3c91e439229">Session::mapClass()</a> and the joinTable specified in <a href="group__dbo.html#g1a086b583fb150dbd4c5b4ba92bc177f">hasMany()</a>.<br />
Added API for dropping the schema: <a href="classWt_1_1Dbo_1_1Session.html#4c1fedb21e4e1cc44b182a34e8ebb4efdropTables()">dropTables()</a>. <br />
Added support for arbitrary queries in <a href="classWt_1_1Dbo_1_1Session.html#d39e953ef521eaa58c4c7e6ca1a6c19e">Session::query()</a>, including
queries that do not return result or do not select from tables.</dd>
<dt><a href="group__dbo.html#g8a2b653ff57f1459dfa2e556badd71d6">Dbo::field()</a></dt>
<dd>Allow size suggestion for std::string and WString mappings</dd>
<dt><a href="classWt_1_1Dbo_1_1SqlConnection.html">Dbo::SqlConnection, Dbo::SqlStatement</a></dt>
<dd>Added support for floating point types, binary data (using std::vector<unsigned char>) and date and date/time types.<br/>
Added methods for return dialect-specific information.<br/>
Added properties API.<br/>
</dd>
<dt><a href="structWt_1_1Dbo_1_1sql__value__traits.html">Dbo::sql_value_traits</a></dt>
<dd>Added support for backend-specific type mapping.</dd>
<dt>(internal) DomElement</dt>
<dd>Performance improvements in serializing the widgets to HTML
and/or JavaScript</dd>
<dt>Built-in httpd</dt>
<dd>Added a configuration option <tt>--max-request-size</tt> to
limit the size of a POST instead of the built-in default of 40
MB<br/> Added a configuration option
<tt>--max-memory-request-size</tt> to limit the size of a POST that
is handed in-memory. Bigger POSTs are handled using a spool file.
</dd>
</dl>
<hr />
<h2>Release 3.1.1 (February 17, 2010)</h2>
<p>The minimum boost version is now 1.36.</p>
<p>This release handles mostly bug fixes, with as most visible change
an update of the <i>polished</i> theme, which is now considered
complete.</p>
<h3>A) Security fixes:</h3>
Because of the following fixes for security problems, we recommend anyone
to upgrade live deployments of his application to the latest version.
<dl>
<dt>Possible XSS vulnerability</dt>
<dd>Fixed a possible XSS attack where a user follows a link to a Wt web
application, taking advantage of unchecked insertions of the URL when
redirecting to the canonical page.</dd>
<dt>Possible UTF-8 vulnerability</dt>
<dd>Form values and JSignal arguments received from the browser are
now checked for sane UTF-8 encoding.</dd>
</dl>
<h3>B) New classes:</h3>
<dl>
<dt><a href="classWt_1_1Dbo_1_1Dbo.html">Dbo/Dbo</a></dt>
<dd>An optional base class for a database object, providing access to its
id() and session().</dd>
</dl>
<h3>C) Main new features in existing classes:</h3>
<dl>