org.yarnandtail.andhow.load

Class JndiLoader

java.lang.Object

org.yarnandtail.andhow.load.BaseLoader

org.yarnandtail.andhow.load.JndiLoader

All Implemented Interfaces:

Loader

public class JndiLoader
extends BaseLoader

Loads values from a JNDI context. This loader can handle two types of objects coming from JNDI: Either the incoming object must already be of the correct destination type (such as a DateTime object), or it my be a string that is parsable by the associated ValueType to the destination type. If the incoming value is a String and the destination type is a string, this loader does not trim the value - the value is assumed to already be in final form. This loader does not consider it a problem to find unrecognized properties in the JNDI context (this would nearly always be the case).

Author:

eeverman

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	JndiLoader.CONFIG

Constructor Summary

Constructors

Constructor and Description
JndiLoader()

Method Summary

Modifier and Type	Method and Description
protected ArrayList<String>	buildJndiRoots(ValueMap values)
Class<? extends BasePropertyGroup>	getClassConfig() A group of Properties used to globally configure all instance of a type of loader.
SamplePrinter	getConfigSamplePrinter() Returns a ConfigSamplePrinter, which can be used to print a configuration sample for this Loader.
String	getLoaderDialect() The type dialect of the loader.
String	getLoaderType() The type of the loader, such as JNDI, PropertyFile, SystemProperty, etc..
String	getSpecificLoadDescription() For this particular load, where was info loaded from? This may vary from run to run based on config params.
boolean	isTrimmingRequiredForStringValues() If true, values for string properties are trimmed by the Trimmer of the property they are associated with.
boolean	isUnrecognizedPropertyNamesConsideredAProblem() If true, an unrecognized name is considered a problem that will stop application startup.
LoaderValues	load(ConstructionDefinition appConfigDef, ValueMapWithContext existingValues) Builds up a list of LoaderValues by loading property values from a configuration source.
protected List<String>	split(String rootStr)

Methods inherited from class org.yarnandtail.andhow.load.BaseLoader

attemptToAdd, attemptToAdd, createValue, findDuplicateProperty, getInstanceConfig

Methods inherited from class java.lang.Object

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

Constructor Detail

JndiLoader

public JndiLoader()

Method Detail

load

public LoaderValues load(ConstructionDefinition appConfigDef,
                         ValueMapWithContext existingValues)

Description copied from interface: Loader

Builds up a list of LoaderValues by loading property values from a configuration source.

Returns:

isTrimmingRequiredForStringValues

public boolean isTrimmingRequiredForStringValues()

Description copied from interface: Loader

If true, values for string properties are trimmed by the Trimmer of the property they are associated with. If false, no trimming is done. Non-String type property values (like Integer or Date type values) are not affected by this. Loaders that read from text files need to trim values to separate white space and carriage returns from the value. Loaders that read from more tightly defined sources, like reading properties from java.lang.System.getProperties(), can assume that trimming has already happened.

Returns:

isUnrecognizedPropertyNamesConsideredAProblem

public boolean isUnrecognizedPropertyNamesConsideredAProblem()

Description copied from interface: Loader

If true, an unrecognized name is considered a problem that will stop application startup. This is a safety feature because a unrecognized property name in a properties file could be a typo. For other property sources, however, like System.properties, there are many non-AndHow related values that are expected to be present, so this rule cannot be enforced.

Returns:

getSpecificLoadDescription

public String getSpecificLoadDescription()

Description copied from interface: Loader

For this particular load, where was info loaded from? This may vary from run to run based on config params. For instance, The PropFileLoader will look multiple places to find a properties file. This method should return the actual location it was found. Assume the text is prefixed with "This loader loaded from: ". An example would be "/home/user/config/my-props.properties" No ending punctuation should be used.

Returns:

getClassConfig

public Class<? extends BasePropertyGroup> getClassConfig()

Description copied from interface: Loader

A group of Properties used to globally configure all instance of a type of loader. For loaders that are intended to be single instance (i.e. a JNDI loader) or loaders that can be multi-instance (PropertyFile loaders) but need to share some common configuration can return a BasePropertyGroup from this method that is their global configuration interface. For configuration properties that should vary between instances of the same loader class, accept them in the Loader constructor. (See getInstanceConfig) The BasePropertyGroup returned from this method will be included in sample config files. It is up to the Loader class to read from those configured properties if the user configures them.

Specified by:

getClassConfig in interface Loader

Overrides:

getClassConfig in class BaseLoader

Returns:

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

Overrides:

getConfigSamplePrinter in class BaseLoader

Returns:

buildJndiRoots

protected ArrayList<String> buildJndiRoots(ValueMap values)

split

protected List<String> split(String rootStr)

getLoaderType

public String getLoaderType()

Description copied from interface: Loader

The type of the loader, such as JNDI, PropertyFile, SystemProperty, etc.. The actual return value is arbitrary, but should be consistent between loaders of the same type. The values returned by getLoaderType and getLoaderDialect are used to removed duplicate loader types when printing sample files. If two loader instances are of the same type and dialect, only one will print the sample file.

Returns:

Must never returns null.

getLoaderDialect

public String getLoaderDialect()

Description copied from interface: Loader

The type dialect of the loader. For property files, this might be either KeyValuePair or xml for example. The actual return value is arbitrary, but should be consistent between loaders of the same type and dialect. The values returned by getLoaderType and getLoaderDialect are used to removed duplicate loader types when printing sample files. If two loader instances are of the same type and dialect, only one will print the sample file.

Returns:

May return null if there is no meaningful dialect for this type.