ch.jalu.configme.utils

Class SettingsHolderClassValidator

java.lang.Object

ch.jalu.configme.utils.SettingsHolderClassValidator

public class SettingsHolderClassValidator
extends Object

Validates various characteristics of the property implementations of SettingsHolder classes for consistency. Finds potential technical or quality issues with a project's property declarations. This class is intended to be used in a unit test.

This class' methods can be overridden for custom behavior. Depending on your needs, you can call the main validate method and override single validation methods you want to customize or disable, or call the individual validation methods separately.

Constructor Summary

Constructors

Constructor and Description
SettingsHolderClassValidator()

Method Summary

Modifier and Type	Method and Description
protected ConfigurationData	createConfigurationData(Iterable<Class<? extends SettingsHolder>> classes)
protected Predicate<String>	createValidLengthPredicate(Integer minLength, Integer maxLength) Creates a predicate based on input min length and max length that evaluates successfully for a string if its length is within the given bounds: minLength <= length <= maxLength.
protected List<String>	gatherExpectedEnumNames(Class<? extends Enum<?>> enumClass)
protected Stream<Field>	getAllFields(Class<?> clazz) Returns all fields of the class, including all fields of parent classes, recursively.
protected Class<? extends Enum<?>>	getEnumTypeOfProperty(Property<?> property) Returns the type of the given property if it is an enum, otherwise null.
protected boolean	hasNonEmptyComment(List<String> comments)
protected boolean	hasValidConstructorSetup(Class<? extends SettingsHolder> clazz)
protected boolean	isValidConstantField(Field field)
void	validate(Class<? extends SettingsHolder>... settingHolders) Runs all validations of this class with the given settings holder classes.
void	validate(Iterable<Class<? extends SettingsHolder>> settingHolders) Runs all validations of this class with the given settings holder classes.
void	validateAllPropertiesAreConstants(Iterable<Class<? extends SettingsHolder>> settingHolders) Throws an exception if any Property field of the given classes is not public, static, or final.
void	validateClassesHaveHiddenNoArgConstructor(Iterable<Class<? extends SettingsHolder>> settingHolders) Throws an exception if any of the provided setting holder classes does not have a single private no-args constructor.
void	validateCommentLengthsAreWithinBounds(ConfigurationData configurationData, Integer minLength, Integer maxLength) Throws an exception if any comment line in the configuration data has a length is not between the given minLength and maxLength, inclusive: minLength <= length <= maxLength.
void	validateConfigurationDataValidForMigrationService(ConfigurationData configurationData, PropertyResource resource, MigrationService migrationService) Validates that the migration service does not declare that a migration is required for the given configuration data, which gets saved to the provided resource beforehand.
void	validateHasAllEnumEntriesInComment(ConfigurationData configurationData, Predicate<Property<?>> propertyFilter) Throws an exception if the comments of an enum property do not list all entries of the enum type.
void	validateHasCommentOnEveryProperty(ConfigurationData configurationData, Predicate<Property<?>> propertyFilter) Throws an exception if there isn't a non-empty comment for every property in the configuration data.
void	validateSettingsHolderClassesFinal(Iterable<Class<? extends SettingsHolder>> settingHolders) Throws an exception if any of the provided settings holder classes is not final.

Methods inherited from class java.lang.Object

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

Constructor Detail

SettingsHolderClassValidator

public SettingsHolderClassValidator()

Method Detail

validate

@SafeVarargs
public final void validate(Class<? extends SettingsHolder>... settingHolders)

Runs all validations of this class with the given settings holder classes. More details at validate(Iterable).

Parameters:

settingHolders - settings holder classes that make up the configuration data of the project

validate

public void validate(Iterable<Class<? extends SettingsHolder>> settingHolders)

Runs all validations of this class with the given settings holder classes. Some of the validations are not needed from a technical point of view and may be undesired in your project. They can all be run individually and can be customized by supplying different method parameters or by overriding methods in this class.

Parameters:

settingHolders - settings holder classes that make up the configuration data of the project

validateConfigurationDataValidForMigrationService

public void validateConfigurationDataValidForMigrationService(ConfigurationData configurationData,
                                                              PropertyResource resource,
                                                              MigrationService migrationService)

Validates that the migration service does not declare that a migration is required for the given configuration data, which gets saved to the provided resource beforehand. This is intended to validate that the default values of a configuration do not trigger a migration:

• the configuration data should only have default values
• the resource should only be for this method and thus use a temporary file

Parameters:

configurationData - the configuration data (with default values, i.e. as created from the properties)

resource - property resource to save to and read from (temporary medium for testing)

migrationService - the migration service to check

validateAllPropertiesAreConstants

public void validateAllPropertiesAreConstants(Iterable<Class<? extends SettingsHolder>> settingHolders)

Throws an exception if any Property field of the given classes is not public, static, or final.

Parameters:

settingHolders - the classes to check

validateSettingsHolderClassesFinal

public void validateSettingsHolderClassesFinal(Iterable<Class<? extends SettingsHolder>> settingHolders)

Throws an exception if any of the provided settings holder classes is not final.

Parameters:

settingHolders - the classes to check

validateClassesHaveHiddenNoArgConstructor

public void validateClassesHaveHiddenNoArgConstructor(Iterable<Class<? extends SettingsHolder>> settingHolders)

Throws an exception if any of the provided setting holder classes does not have a single private no-args constructor.

Parameters:

settingHolders - the classes to check

validateHasCommentOnEveryProperty

public void validateHasCommentOnEveryProperty(ConfigurationData configurationData,
                                              @Nullable
                                              Predicate<Property<?>> propertyFilter)

Throws an exception if there isn't a non-empty comment for every property in the configuration data.

Parameters:

configurationData - the configuration data to check

propertyFilter - predicate determining which properties are checked (if null, are properties are checked)

validateCommentLengthsAreWithinBounds

public void validateCommentLengthsAreWithinBounds(ConfigurationData configurationData,
                                                  @Nullable
                                                  Integer minLength,
                                                  @Nullable
                                                  Integer maxLength)

Throws an exception if any comment line in the configuration data has a length is not between the given minLength and maxLength, inclusive: minLength <= length <= maxLength. Either argument is nullable if no min or max, respectively, is desired, but both arguments may not be null.

Parameters:

configurationData - the configuration data with the comments to check

minLength - the number of characters each comment line must at least have (null to disable check)

maxLength - the number of characters each comment may not surpass (null to disable check)

validateHasAllEnumEntriesInComment

public void validateHasAllEnumEntriesInComment(ConfigurationData configurationData,
                                               @Nullable
                                               Predicate<Property<?>> propertyFilter)

Throws an exception if the comments of an enum property do not list all entries of the enum type.

Parameters:

configurationData - the configuration data whose properties and comments should be checked

propertyFilter - predicate determining which properties are checked (if null, are properties are checked)

isValidConstantField

protected boolean isValidConstantField(Field field)

createConfigurationData

protected ConfigurationData createConfigurationData(Iterable<Class<? extends SettingsHolder>> classes)

hasNonEmptyComment

protected boolean hasNonEmptyComment(@Nullable
                                     List<String> comments)

createValidLengthPredicate

protected Predicate<String> createValidLengthPredicate(@Nullable
                                                       Integer minLength,
                                                       @Nullable
                                                       Integer maxLength)

Creates a predicate based on input min length and max length that evaluates successfully for a string if its length is within the given bounds: minLength <= length <= maxLength. Either length may be null, but an exception is thrown if both are null.

Parameters:

minLength - the min length (nullable)

maxLength - the max length (nullable)

Returns:

predicate based on the supplied length parameters

getEnumTypeOfProperty

@Nullable
protected Class<? extends Enum<?>> getEnumTypeOfProperty(Property<?> property)

Returns the type of the given property if it is an enum, otherwise null.

Parameters:

property - the property to process

Returns:

the enum type it wraps, or null if not applicable

gatherExpectedEnumNames

protected List<String> gatherExpectedEnumNames(Class<? extends Enum<?>> enumClass)

hasValidConstructorSetup

protected boolean hasValidConstructorSetup(Class<? extends SettingsHolder> clazz)

getAllFields

protected Stream<Field> getAllFields(Class<?> clazz)

Returns all fields of the class, including all fields of parent classes, recursively.

Parameters:

clazz - the class whose fields should be retrieved

Returns:

all fields of the class, including its parents