Skip to main content


Advanced topics

Berlioz global properties

The Berlioz global configuration file is a simply a list of properties for the content generators running in Berlioz.


Properties defined this way are available in the content generators using the GlobalSettings class.

Predefined Berlioz properties

The following properties are defined by Berlioz.

berlioz.http.compressionBooleantrueTo allow Berlioz to use HTTP compression when possible
berlioz.http.get-via-postBooleantrueTo forward HTTP POST requests to GET is there is no specific service for POST
berlioz.http.max-ageInteger60The default maximum age in seconds of cacheable content
berlioz.errors.handleBooleantrueTo allow Berlioz handle errors (they are sent to Web container
berlioz.errors.generator-catchBooleantrueTo catch errors thrown by generators
berlioz.xslt.cacheBooleantrueTo enable the caching of XSLT templates
berlioz.xml.parse-strictBooleantrueTo throw XML/XSLT errors even for warnings
berlioz.control-keyString""Specifies a control Key: a string required to use Berlioz global

File format

There are three possible file formats for the global properties settings, they are the following:

Simple XML file

This is a minimal representation with the property name generated by concatenating the attribute with the parent element and the attribute value being the value of the property. The <document> element is ignored.

For example:

  <myapp test="abc" acme="true"/>

creates the following property:


XML properties file

This is a terse representation of the properties in XML:

<?xml version="1.0"?>
<!DOCTYPE service-config PUBLIC "-//Berlioz//DTD::Properties 1.0//EN"
    <!-- Berlioz Global settings -->
    <node name="myapp">
        <entry key="test" value="abc"/>
        <entry key="acme" value="true"/>

 Unless you have a specific reason, always use the Simple XML format.

Properties file

It is also possible to use a conventional properties file format.

Created on , last edited on