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 设置Holder 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 设置Manager 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

public class TitleConfig implements 设置Holder {

    public static final Property<String> TITLE_TEXT =
        newProperty("title.text", "-Default-");

    public static final Property<Integer> TITLE_SIZE =
        newProperty("title.size", 10);

    private TitleConfig() {
        // prevent instantiation
    }
}

WelcomeWriter.java

public class WelcomeWriter {
    public String generateWelcomeMessage() {
        设置Manager settings = 设置ManagerBuilder
            .withYamlFile(Path.of("config.yml"))
            .configurationData(TitleConfig.class)
            .useDefaultMigrationService()
            .create();

        // Get properties from the settings manager
        return "<font size=\""
            + settings.getProperty(TitleConfig.TITLE_SIZE) + "\">"
            + settings.getProperty(TitleConfig.TITLE_TEXT) + "</font>";
    }
}

📝 Read the full documentation in the ConfigMe 维基.

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

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