Berlioz Global Properties


The Berlioz global configuration file is a simple file to provide a list of properties to the content generators running in Berlioz.

Any property defined in this file will be 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.http.cache-controlString""The default "Cache-Control" HTTP response header that Berlioz should use
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-strictBoolean true To throw XML/XSLT errors even for warnings
berlioz.control-keyString""Specifies a control Key: a string required to use Berlioz global 


File Format

There 3 possible file formats for the global settings:

Simple XML file

This is the simplest type of configuration. The name of the properties are generated using the concatenation of the attribute names and their parent element. The property value if the attribute value. The document element is ignored.

For example:

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

Will create the following property:



XML properties file

This format is little terse and is a simple representation of a properties file as 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"/>


 It is recommended that you use the simple format instead.

Properties file

It is also possible to use a simple properties file.



Created on , last edited on