ConvertersΒΆ

VSGI provide stream utilities named converters to convert data according to modern web standards.

These are particularly useful to encode and recode request and response bodies in VSGI implementations.

GLib provide default converters for charset conversion and zlib compression. These can be used to compress the message bodies and convert the string encoding transparently.

Converters can be applied on both the Request and Response object using the convert method.

Server.new_with_application ("http", "org.vsgi.App", (req, res) => {
    res.headers.append ("Content-Encoding", "gzip");
    res.convert (new ZlibCompressor (ZlibCompressorFormat.GZIP));
    return res.expand_utf8 ("Hello world!");
});

Warning

The Content-Encoding header must be adapted to reflect the current set of encodings applied (or unapplied) on the payload.

Since conversion typically affect the resulting size of the payload, the Content-Length header must be set appropriately. To ease that, the new value can be specified as second argument. Note that -1 is used to describe an undetermined length.

res.convert (new CharsetConverter ("UTF-8", "ascii"), res.headers.get_content_length ());

The default, which apply in most cases, is to remove the Content-Length header and thus describe an undetermined length.