ch.jalu.configme.migration

Class PlainMigrationService

java.lang.Object

ch.jalu.configme.migration.PlainMigrationService

All Implemented Interfaces:

MigrationService

public class PlainMigrationService
extends Object
implements MigrationService

Simple migration service that can be extended.

Field Summary

Fields inherited from interface ch.jalu.configme.migration.MigrationService

MIGRATION_REQUIRED, NO_MIGRATION_NEEDED

Constructor Summary

Constructors

Constructor and Description
PlainMigrationService()

Method Summary

Modifier and Type	Method and Description
boolean	checkAndMigrate(PropertyReader reader, ConfigurationData configurationData) Performs the migration, returning whether a migration has been performed or not.
protected static <T> boolean	moveProperty(Property<T> oldProperty, Property<T> newProperty, PropertyReader reader, ConfigurationData configurationData) Utility method: moves the value of an old property to a new property.
protected boolean	performMigrations(PropertyReader reader, ConfigurationData configurationData) Override this method for custom migrations.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PlainMigrationService

public PlainMigrationService()

Method Detail

checkAndMigrate

public boolean checkAndMigrate(PropertyReader reader,
                               ConfigurationData configurationData)

Description copied from interface: MigrationService

Performs the migration, returning whether a migration has been performed or not.

Specified by:

checkAndMigrate in interface MigrationService

Parameters:

reader - reader to access the values in the configuration file

configurationData - configuration data, which knows all properties and manages their associated values

Returns:

true if a migration has been performed, false otherwise. Indicates whether the configuration data should be saved to the configuration file or not

performMigrations

protected boolean performMigrations(PropertyReader reader,
                                    ConfigurationData configurationData)

Override this method for custom migrations. This method is executed before checking if all settings are present. For instance, you could implement deleting obsolete properties and rename properties in this method.

Note that the settings manager automatically saves the resource if the migration service returns MigrationService.MIGRATION_REQUIRED from checkAndMigrate(ch.jalu.configme.resource.PropertyReader, ch.jalu.configme.configurationdata.ConfigurationData).

Parameters:

reader - the reader with which the configuration file can be read

configurationData - the configuration data

Returns:

true if a migration has been performed, false otherwise (see constants on MigrationService)

moveProperty

protected static <T> boolean moveProperty(Property<T> oldProperty,
                                          Property<T> newProperty,
                                          PropertyReader reader,
                                          ConfigurationData configurationData)

Utility method: moves the value of an old property to a new property. This is only done if there is no value for the new property in the configuration file and if there is one for the old property. Returns true if a value is present at the old property path.

Type Parameters:

T - the type of the property

Parameters:

oldProperty - the old property (create a temporary Property object with the path)

newProperty - the new property to move the value to

reader - the property reader to read the configuration file from

configurationData - configuration data to update a property's value

Returns:

true if the old path exists in the configuration file, false otherwise