ConfigMe

A simple configuration management library with YAML support out of the box.

• Lightweight
• Flexible
• Out of the box support for YAML
• Allows migrations / config file checks
• Null-safe
• Unit testing friendly

How it works

• Each configurable value is a Property in ConfigMe. Properties are declared as public static final fields in classes which implement the SettingsHolder interface.
• Configurations are read from a PropertyResource (e.g. the provided YamlFileResource), which abstracts reading and writing.
• The property resource may be checked for completeness with the MigrationService, which allows you also to rename properties or to remove obsolete ones.
• The SettingsManager unifies the members above. On creation, it calls the migration service and allows you to get and change property values.

Integration

Start using ConfigMe by adding this to your pom.xml:

<dependencies>
<dependency>
<groupId>ch.jalu</groupId>
<artifactId>configme</artifactId>
<version>1.4.1</version>
</dependency>
</dependencies>

Example

config.yml

title:
text: 'Hello'size: 12

TitleConfig.java

publicclassTitleConfigimplementsSettingsHolder {
publicstaticfinalProperty<String> TITLE_TEXT =
newProperty("title.text", "-Default-");
publicstaticfinalProperty<Integer> TITLE_SIZE =
newProperty("title.size", 10);
privateTitleConfig() {
// prevent instantiation
}
}

WelcomeWriter.java

publicclassWelcomeWriter {
publicStringgenerateWelcomeMessage() {
SettingsManagersettings = SettingsManagerBuilder
.withYamlFile(Path.of("config.yml"))
.configurationData(TitleConfig.class)
.useDefaultMigrationService()
.create();
// Get properties from the settings managerreturn"<font size=\""
+ settings.getProperty(TitleConfig.TITLE_SIZE) + "\">"
+ settings.getProperty(TitleConfig.TITLE_TEXT) + "</font>";
}
}

📝 Read the full documentation in the ConfigMe Wiki.

📝 See a full working example based on this: ConfigMe demo.

📝 See how to use custom classes as property types in the bean properties demo.