Wt 3.1.7, JWt 3.1.7

  • Posted by koen
  • Tuesday, November 30, 2010 @ 14:11

A new version of the library packed with lots of bug fixes and a fair share of new features.

The highlights of this release are:


WebSockets, part of W3C’s HTML5 draft and whose underlying BiDirectional or Server-Initiated HTTP protocol is currently being drafted by IETF, is promising to be an interesting revolution for web applications.

It gives stateful web applications (that keep state between requests not simply in a database but also communication state such as open sockets and other in-memory state) a suitable and reliable transport, which has virtually no overhead compared to bare TCP. While it is frequently introduced as a good solution to implement "server-push", we believe it is simply going to replace Ajax as the preferred communication protocol, also for client-initiated events.

HTTP is a stateless protocol: there is nothing in the protocol that implies that requests belong to a single conversation. As a consequence, stateful web application frameworks (such as Wt) bend the protocol to adapt it to its needs: including session information in each and every request, preventing request reordering, and in case of server push, adding reliability features in the face of intermediaries that can drop the connection whenever they feel like it.

Unlike plain HTTP, the WebSockets no longer mandates a request/response scheme. Unlike most web frameworks, Wt and JWt do not expose an API that works in terms of requests and responses, and existing Wt application can benefit from WebSockets using a simple configuration setting.

The advent of WebSockets means bad luck for web applications developed in a stateless framework designed in terms of requests and responses, such as Django and Ruby on Rails — WebSockets are inherently stateful because of the open connection maintained between client and server.

WebSockets are currently implemented only using the C++ built-in HTTP server (effectively acting now as a WebSocket server as well). To enable it, add <web-sockets>true</web-sockets> to your configuration file. WebSockets are currently unsupported in JWt since they are not part of the servlet specification and would need some kind of support to share the same HTTP port. But some application servers already provide non-standard implementations (such as Jetty).

WebSockets in practice

Despite that HTML5 is still a draft specification, and the WebSockets protocol itself in great state of flux (in fact, almost every aspect of it is being debated, including its unorthodox handshake), it has been implemented in current stable versions of Chrome and Safari, and in upcoming versions of Firefox (4.0) and Opera (10.70) (but no mention of it from the Microsoft Internet Explorer development team).

WebSockets requires however active cooperation of intermediaries (either through an HTTP/1.1 CONNECT, or through a protocol upgrade hand-shake). Most proxy software will need to be upgraded to provide support for WebSockets. This may seem like a show-stopper, but it isn’t. Reliability (and simplicity) is the only new feature that WebSockets add compared to existing workarounds based on XMLHttpRequest. This unreliability is caused mostly (only?) by these intermediaries. To solve the one problem of server push workarounds these days there is thus a need to involve the intermediaries and to detect whether they indeed will cooperate.

But that should not ruin the party: it is straight forward to detect availability of WebSockets on an individual basis, and simply continue using the current solutions otherwise. That is exactly what Wt does, extending its current progressive enhancement setup:

plain HTMLAjaxWebSockets

Because WebSockets have been designed to share the same port number as HTTP, firewalls are not going to get in the way. Wt’s builtin httpd now interprets both HTTP and WebSocket requests on port 80 (and HTTPS and WebSocket-over-SSL on port 443).


API-wise, and regardless of server push implementation, no more than two methods of WApplication deal with server push:

  • WApplication::enableUpdates(bool enable): Enables or disables server push (yes, you can enable server push even temporarily).

  • WApplication::triggerUpdate(): Pushes changes to the client. As with normal request handling, the library keeps track of what you changed and what needs to be synchronized with the client.

The serverpush feature example (C++) / (Java) illustrates this API.


This release contains a sneak preview of Wt’s WebGL support, in WGLWidget. Although the documentation is still a bit sketchy, the API has evolved already to a point that we hope it will not require major changes. The distribution includes a simple example that works with the few browser that support WebGL (Firefox 4.0 and Chrome Canary).

  • Posted by dmitigr
  • 13 years ago
My congratulations! :-)
  • Posted by anonymous
  • 13 years ago
Thank you for the tooltips on charts.
  • Posted by anonymous
  • 13 years ago
Very interesting post! I hope Websockets specs progess rapidly to a stable release. It would be a pitty to have several implementations incompatible.
  • Posted by anonymous
  • 13 years ago
Keep up the good work!Thank you!

Contact us for more information
or a personalised quotation