Hosted by:
SourceForge
Get Firefox!

Cascading Configuration Files
Cascading Configuration Files
Configuration Property Overview
Cascading Configuration Files

Starting with version 3.0.0, it is possible to specify include files within a configuration file. This is useful where there is a need to override default values without modifying the main configuration file.

Include files are specified by placing a line in the configuration file with the following syntax:

#include ../conf/wrapper2.conf

If the specified file can not be located for any reason then it is ignored. This makes it easy to specify a series of optional include files which users may or may not create.

The location of the include definition in a file is important. Any properties defined before the include can be overridden where as properties set after the include file will override any settings in the include files. This rule applies to the contents of include files as well.

If relative paths to the include files are specified, be aware that all paths must be relative to the location of the Wrapper working directory. By default, this is the location of the Wrapper.exe on Windows, or the script used to launch the Wrapper on UNIX. The working directory can be changed using the wrapper.working.dir property.

Include files can be nested up to 10 levels deep.

by Leif Mortenson

last modified: