org.refcodes.runtime.impls

Class RuntimePropertiesImpl

java.lang.Object

org.refcodes.collection.impls.PropertiesImpl

org.refcodes.runtime.impls.RuntimePropertiesImpl

All Implemented Interfaces:

org.refcodes.collection.Containable, org.refcodes.collection.Dictionary<String,String>, org.refcodes.collection.Keys<String,String>, org.refcodes.collection.Properties

public class RuntimePropertiesImpl
extends org.refcodes.collection.impls.PropertiesImpl

The RuntimePropertiesImpl load the first properties file found (with "key=value" entries) in one of several default locations determined by the RuntimeUtility.toAppConfigDirs() method. At the time of this writing (2015-11-12), the locations which to seek for the first occurrence of the properties file are determined as follows: The applications base directory (where your JAR or your classes reside) is taken and a list of directories relative to this base directory is generated as defined in the SystemProperty#CONFIG_DIR_NAMES: The actual directories being returned (in case them exist) are as follows, relative to your applications base directory:

• ../config"
• ../etc"
• ../settings"
• ../.config"
• ../settings"
• ."
• ./config"
• ./etc"
• ./settings"
• ./.config"
• ./settings"
In case you pass a JVM argument via "-Dconfig.dir=path_to_your_config_dir" (where path_to_your_config_dir stands for the path to the directory where you placed configuration files), then your path_to_your_config_dir is placed first in the list (in case the directory exists).See SystemProperty.CONFIG_DIR

Nested Class Summary

Nested classes/interfaces inherited from class org.refcodes.collection.impls.PropertiesImpl

org.refcodes.collection.impls.PropertiesImpl.MutablePropertiesImpl, org.refcodes.collection.impls.PropertiesImpl.PropertiesBuilderImpl

Nested classes/interfaces inherited from interface org.refcodes.collection.Properties

org.refcodes.collection.Properties.ClearableProperties, org.refcodes.collection.Properties.MutableProperties, org.refcodes.collection.Properties.PropertiesBuilder

Nested classes/interfaces inherited from interface org.refcodes.collection.Dictionary

org.refcodes.collection.Dictionary.ClearableDictionary<K,V>, org.refcodes.collection.Dictionary.MutableDictionary<K,V>

Nested classes/interfaces inherited from interface org.refcodes.collection.Keys

org.refcodes.collection.Keys.ClearableKeys<K,V>, org.refcodes.collection.Keys.MutableKeys<K,V>

Field Summary

Fields inherited from class org.refcodes.collection.impls.PropertiesImpl

_properties

Constructor Summary

Constructors

Constructor and Description
RuntimePropertiesImpl(String aPropertiesFileName) Loads a properties file from the first folder containing such a file as of the specification for the method RuntimeUtility.toAppConfigDirs().

Method Summary

Methods inherited from class org.refcodes.collection.impls.PropertiesImpl

containsKey, equals, get, hashCode, isEmpty, keySet, size, values

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.refcodes.collection.Properties

toMap, toProperties

Constructor Detail

RuntimePropertiesImpl

public RuntimePropertiesImpl(String aPropertiesFileName)
                      throws IOException

Loads a properties file from the first folder containing such a file as of the specification for the method RuntimeUtility.toAppConfigDirs().

Parameters:

aPropertiesFileName - The filename of the properties file to load.

Throws:

IOException - thrown in case accessing or processing the properties file failed.