org.yarnandtail.andhow.load

Class BaseLoader

java.lang.Object

org.yarnandtail.andhow.load.BaseLoader

All Implemented Interfaces:

Loader

Direct Known Subclasses:

FixedValueLoader, KeyValuePairLoader, MapLoader, PropFileBaseLoader, StdJndiLoader

public abstract class BaseLoader
extends Object
implements Loader

Author:

eeverman

Constructor Summary

Constructors

Constructor and Description
BaseLoader()

Method Summary

Modifier and Type	Method and Description
protected void	attemptToAdd(StaticPropertyConfigurationInternal appConfigDef, List<ValidatedValue> values, ProblemList<Problem> loaderProblems, Property prop, Object value) Util method to attempt to load an object of an unknown type to a property.
protected void	attemptToAdd(StaticPropertyConfigurationInternal appConfigDef, List<ValidatedValue> values, ProblemList<Problem> loaderProblems, String key, String strValue) Util method to load a String to a property by name.
protected <T> ValidatedValue	createValue(StaticPropertyConfigurationInternal appConfigDef, Property<T> prop, String untrimmedString)
protected ValidatedValue	findDuplicateProperty(ValidatedValue current, List<ValidatedValue> values)
Class<?>	getClassConfig() Returns a PropertyGroup used to globally configure a class of Loader.
SamplePrinter	getConfigSamplePrinter() Returns a ConfigSamplePrinter, which can be used to print a configuration sample for this Loader.
List<Property>	getInstanceConfig() A list of properties that the user has specified as being configuration properties for this Loader.
void	releaseResources() Release any resources held by this loader.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.yarnandtail.andhow.api.Loader

getLoaderDialect, getLoaderType, getSpecificLoadDescription, isTrimmingRequiredForStringValues, load

Constructor Detail

BaseLoader

public BaseLoader()

Method Detail

getClassConfig

public Class<?> getClassConfig()

Description copied from interface: Loader

Returns a PropertyGroup used to globally configure a class of Loader. For loaders that are intended to be single instance and thus have a single set of configuration properties, this method allows them to report their configuration PropertyGroup so it can be included in the list of registered groups. Examples of such loaders would be as system wide naming services like JNDI or a JNDI derivative (like LDAP via JNDI). The Group returned from this method will be registered and included in generated sample config files. Loader classes should provide default Property values so they work w/o configuration if possible. For configuration properties that should vary between instances of the same loader class, the loader class should accept Properties in its constructor. Those properties should then be returned by getInstanceConfig().

Specified by:

getClassConfig in interface Loader

Returns:

A PropertyGroup that defines configuration for this class, or null if there is none.

getInstanceConfig

public List<Property> getInstanceConfig()

Description copied from interface: Loader

A list of properties that the user has specified as being configuration properties for this Loader. Typically these Properties have been specified in the Loader constructor or builder. An example usage would be passing in a Property that specifies the location of a properties file to read from. This is the preferred way to configure a loader because its clear to the user and it allows each instance of a loader to be configured differently, e.g., so PropertyFile loaders that load from different locations. Any Properties returned from this method must have been registered for configuration.

Specified by:

getInstanceConfig in interface Loader

Returns:

Never null. Either an empty list or populated.

getConfigSamplePrinter

public SamplePrinter getConfigSamplePrinter()

Description copied from interface: Loader

Returns a ConfigSamplePrinter, which can be used to print a configuration sample for this Loader. This method may return null if there is no sample printer for this loader.

Specified by:

getConfigSamplePrinter in interface Loader

Returns:

attemptToAdd

protected void attemptToAdd(StaticPropertyConfigurationInternal appConfigDef,
                            List<ValidatedValue> values,
                            ProblemList<Problem> loaderProblems,
                            String key,
                            String strValue)

Util method to load a String to a property by name. Used for text based loaders.

Parameters:

appConfigDef - Used to look up the property name for find the actual property

values - List of PropertyValues to add to, which should be only the value of this loader.

loaderProblems - A list of Problems to add to if there is a loader related problem

key - The property name

strValue - The property value

attemptToAdd

protected void attemptToAdd(StaticPropertyConfigurationInternal appConfigDef,
                            List<ValidatedValue> values,
                            ProblemList<Problem> loaderProblems,
                            Property prop,
                            Object value)

Util method to attempt to load an object of an unknown type to a property. Used for object based loaders where value are not in text form. This loader assumes the passed property is a valid property to to load to, but it will check to make sure it is not null, which is not treated as an error.

Parameters:

appConfigDef - Used to look up the property name for find the actual property

values - List of PropertyValues to add to, which should be only the value of this loader.

loaderProblems - A list of LoaderProblems to add to if there is a loader related problem

prop - The Property to load to

value - The Object to be loaded to this property

findDuplicateProperty

protected ValidatedValue findDuplicateProperty(ValidatedValue current,
                                               List<ValidatedValue> values)

createValue

protected <T> ValidatedValue createValue(StaticPropertyConfigurationInternal appConfigDef,
                                         Property<T> prop,
                                         String untrimmedString)
                                  throws ParsingException

Throws:

ParsingException

releaseResources

public void releaseResources()

Description copied from interface: Loader

Release any resources held by this loader. Loaders have done their job after loading values to properties. However, they may be held in memory for auditing and reporting. To prevent holding additional resources in memory, this method is called after loading is complete.

Specified by:

releaseResources in interface Loader