org.yarnandtail.andhow.load.std

Class StdEnvVarLoader

java.lang.Object

org.yarnandtail.andhow.load.BaseLoader

org.yarnandtail.andhow.load.MapLoader

org.yarnandtail.andhow.load.std.StdEnvVarLoader

All Implemented Interfaces:

Loader, ReadLoader, StandardLoader

public class StdEnvVarLoader
extends MapLoader
implements StandardLoader

Reads the operating system defined environment variables and loads the value for any environmental variable who's name matches a Property.

Position in Standard Loading Order, first to last

• StdFixedValueLoader
• StdMainStringArgsLoader
• StdSysPropLoader
• StdEnvVarLoader <-- This loader
• StdJndiLoader
• StdPropFileOnFilesystemLoader
• StdPropFileOnClasspathLoader

Typical Use Case

An application might receive all or some of its configuration from OS defined environmental variables that are passed to the JVM when the JVM starts. Environment variables can be set in the OS and augmented in a startup script, which could be customized for each environment. Similar to Java system properties, this provides a relatively easy way for deployment automation or system administrators to control application configuration values across many servers.

Basic Behaviors

• Pre-trims String values: No (Individual Properties may still trim values)
• Complains about unrecognized properties: No
• Default behavior: AndHow always attempts to read environment variables and will assign property values if any of them match known property names.

Loader Details and Configuration

This loader loads values from System.getenv(). Those environmental values are provided by the host environment (the OS) as a static snapshot to the JVM at startup as a String-to-String map. The underlying OS environment variables can change, however, the JVM is unaware of it. Similarly, AndHow property values never change once loaded.
For FlgProp properties (true/false flags), the StdEnvVarLoader will set the Property's value to true if a matching environment variable is found, even if the value of the property is empty.
The Windows OS uses ALL CAPS for environment variables, while all others OS's are case sensitive - This is the primary reason AndHow is case insensitive by default. Each OS has a different way to set an environmental variables

This is a Standard Loader

Like all StandardLoader's, this loader is intended to be auto-created by AndHow. The set of standard loaders and their order can bet set via the AndHowConfiguration.setStandardLoaders() methods. Other loaders which don't implement the StandardLoader interface can be inserted into the load order via the AndHowConfiguration.insertLoaderBefore/After().

Author:

eeverman

Field Summary

Fields inherited from class org.yarnandtail.andhow.load.MapLoader

map, unknownPropertyAProblem

Constructor Summary

Constructors

Constructor and Description
StdEnvVarLoader() There is no reason to use the constructor in production application code because AndHow creates a single instance on demand at runtime.

Method Summary

Modifier and Type	Method and Description
String	getLoaderType() The type of the loader, such as JNDI, PropertyFile, SystemProperty, etc..
Map<?,?>	getMap()
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.

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

getLoaderDialect, isUnknownPropertyAProblem, load, releaseResources, setMap, setUnknownPropertyAProblem

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

attemptToAdd, attemptToAdd, attemptToAdd, attemptToAddIfNotDuplicate, createValue, findDuplicateProperty, getClassConfig, getConfigSamplePrinter, getInstanceConfig, mapNametoProperty

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

getClassConfig, getConfigSamplePrinter, getInstanceConfig, getLoaderDialect, load, releaseResources

Constructor Detail

StdEnvVarLoader

public StdEnvVarLoader()

There is no reason to use the constructor in production application code because AndHow creates a single instance on demand at runtime.

Method Detail

getMap

public Map<?,?> getMap()

Overrides:

getMap in class MapLoader

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.

Specified by:

getSpecificLoadDescription in interface Loader

Overrides:

getSpecificLoadDescription in class MapLoader

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.

Specified by:

isTrimmingRequiredForStringValues in interface Loader

Overrides:

isTrimmingRequiredForStringValues in class MapLoader

Returns:

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.

Specified by:

getLoaderType in interface Loader

Overrides:

getLoaderType in class MapLoader

Returns:

Must never returns null.