ch.jalu.configme.properties

Class BaseProperty<T>

java.lang.Object

ch.jalu.configme.properties.BaseProperty<T>

Type Parameters:

T - the property type

All Implemented Interfaces:

Property<T>

Direct Known Subclasses:

BeanProperty, BooleanProperty, DoubleProperty, EnumProperty, IntegerProperty, LowercaseStringSetProperty, OptionalProperty, StringListProperty, StringProperty

public abstract class BaseProperty<T>
extends Object
implements Property<T>

Base implementation of Property. All properties should extend from this class.

This base implementation makes interacting with properties null safe by guaranteeing that the default value and its determined value can never be null.

Constructor Summary

Constructors

Constructor and Description
BaseProperty(String path, T defaultValue) Constructor.

Method Summary

Modifier and Type	Method and Description
T	determineValue(PropertyReader reader) Returns the value, based on the given reader, which should be used for this property.
T	getDefaultValue() Returns the default value of this property.
protected abstract T	getFromReader(PropertyReader reader) Constructs the value of the property from the property reader.
String	getPath()
boolean	isPresent(PropertyReader reader) Returns true if a valid value for this property is present in the property reader, i.e.
boolean	isValidValue(T value) Returns whether the value can be associated to the given property, i.e.
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface ch.jalu.configme.properties.Property

toExportValue

Constructor Detail

BaseProperty

public BaseProperty(String path,
                    T defaultValue)

Constructor.

Parameters:

path - the path of the property

defaultValue - the default value of the property

Method Detail

getPath

public String getPath()

Specified by:

getPath in interface Property<T>

Returns:

the path of the property

getDefaultValue

public T getDefaultValue()

Description copied from interface: Property

Returns the default value of this property.

Specified by:

getDefaultValue in interface Property<T>

Returns:

the default value

determineValue

public T determineValue(PropertyReader reader)

Description copied from interface: Property

Returns the value, based on the given reader, which should be used for this property. By default this is the value as constructed from the reader, and otherwise the default value. Implementations of BaseProperty never return null. The return value must be in sync with Property.isValidValue(Object).

Specified by:

determineValue in interface Property<T>

Parameters:

reader - the reader to construct the value from (if possible)

Returns:

the value to associate to this property

isPresent

public boolean isPresent(PropertyReader reader)

Description copied from interface: Property

Returns true if a valid value for this property is present in the property reader, i.e. true if and only if there is a value at the property's path in the reader and it can be used to construct a value for the property.

Specified by:

isPresent in interface Property<T>

Parameters:

reader - the reader to use

Returns:

true if a valid value is present in the reader, false otherwise

isValidValue

public boolean isValidValue(T value)

Description copied from interface: Property

Returns whether the value can be associated to the given property, i.e. whether it fulfills all requirements which may be imposed by the property type.

This method is used in ConfigurationDataImpl.setValue(ch.jalu.configme.properties.Property<T>, T), which throws an exception if this method returns false. Therefore, this method is intended as a last catch for invalid values and to ensure that programmatically no invalid value can be set. Extended validation of values encountered in the property reader should be preferably handled Property.determineValue(ch.jalu.configme.resource.PropertyReader) or in a MigrationService.

Specified by:

isValidValue in interface Property<T>

Parameters:

value - the value to check

Returns:

true if the value can be used for the property, false otherwise

getFromReader

@Nullable
protected abstract T getFromReader(PropertyReader reader)

Constructs the value of the property from the property reader. Returns null if no value is available in the reader or if it cannot be used to construct a value for this property.

Parameters:

reader - the reader to read from

Returns:

value based on the reader, or null if not applicable

toString

public String toString()

Overrides:

toString in class Object