ph config

A multi-source configuration manager, that can use system properties, environment variables, resources and application specific values to work with. See ConfigFactory.getDefaultConfig () for the starting point. By default the following configurations sources are scanned in this order:

1. System properties - priority 400
2. Environment variables - priority 300
3. if the system property config.resource or the environment variable CONFIG_RESOURCE is present, and it points to an existing classpath resource, the first one matching is used - priority 200 or determined by the system property config.resource.priority or the environment variable CONFIG_RESOURCE_PRIORITY. Note: the file type is determined by the extension and defaults to "properties".
4. if the system property config.resources (note the trailing "s") or the environment variable CONFIG_RESOURCES is present, and it points to an existing classpath resource, all matching ones are used - priority 200 or determined by the system property config.resources.priority (also note the trailing "s") or the environment variable CONFIG_RESOURCES_PRIORITY. Note: the file type is determined by the extension and defaults to "properties".
5. if the system property config.file or the environment variable CONFIG_FILE is present, and it points to an existing file, it is used - priority 200 or determined by the system property config.file.priority or the environment variable CONFIG_FILE_PRIORITY. Note: the file type is determined by the extension and defaults to "properties".
6. if the system property config.url or the environment variable CONFIG_URL is present, and it points to an existing URL, it is used - priority 200 or determined by the system property config.url.priority or the environment variable CONFIG_URL_PRIORITY. Note: the file type is determined by the extension and defaults to "properties".
7. a JSON file called private-application.json - this is mainly to have an easy way to override settings - priority 195.
8. a properties file called private-application.properties - this is mainly to have an easy way to override settings - priority 190.
9. all JSON files called application.json that are in the classpath - priority 185.
10. all properties files called application.properties that are in the classpath - priority 180.
11. all properties files called reference.properties that are in the classpath - priority 1.

• Note: the default configuration does NOT contain any custom configuration files. It is solely based on system properties and environment variables.
• Note: JSON and Properties files are expected to be UTF-8
• Note: The usage of variables (as in ${xyz}) to reference to other properties is currently not yet implemented

JSON format

The JSON configuration file must be a single large object so it must start with "{" and end with "}". The JSON syntax is a bit relaxed and allows for unquoted names (as in key: "value") but other than that it is regular JSON.

Configuration property resolution

Each configuration property is trying to be resolved in all configured sources. Each configured source is iterated in descending priority, so in the default setup stated above system properties would be searched first, then environment variables and then the optional available configuration files.

Maven usage

Add the following to your pom.xml to use this artifact:

<dependency>
  <groupId>com.helger.commons</groupId>
  <artifactId>ph-config</artifactId>
  <version>x.y.z</version>
</dependency>

Note: the Maven groupId changed in v10 from com.helger to com.helger.commons