org.refcodes.configuration

Class RuntimePropertiesComposite

java.lang.Object

org.refcodes.configuration.AbstractPropertiesDecorator<Properties>

org.refcodes.configuration.RuntimePropertiesComposite

All Implemented Interfaces:

Properties, org.refcodes.mixin.DelimiterAccessor, org.refcodes.mixin.Dumpable, org.refcodes.mixin.TypeAccessor<String>, org.refcodes.structure.CanonicalMap, org.refcodes.structure.Containable, org.refcodes.structure.Dictionary<String,String>, org.refcodes.structure.Keys<String,String>, org.refcodes.structure.PathMap<String>, org.refcodes.structure.PropertiesAccessorMixin

public class RuntimePropertiesComposite
extends AbstractPropertiesDecorator<Properties>
implements Properties

The RuntimePropertiesComposite composite represent the system properties as well as the environment variables (in that order) and Java properties and are actually constructed from SystemProperties, EnvironmentProperties and JavaProperties instances (in that precedence).

Nested Class Summary

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

Properties.MutableProperties, Properties.PropertiesBuilder

Nested classes/interfaces inherited from interface org.refcodes.structure.CanonicalMap

org.refcodes.structure.CanonicalMap.CanonicalMapBuilder, org.refcodes.structure.CanonicalMap.MutableCanonicalMap

Nested classes/interfaces inherited from interface org.refcodes.structure.PathMap

org.refcodes.structure.PathMap.MutablePathMap<T>, org.refcodes.structure.PathMap.PathMapBuilder<T>

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

org.refcodes.structure.Dictionary.MutableDictionary<K,V>

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

org.refcodes.structure.Keys.MutableKeys<K,V>, org.refcodes.structure.Keys.MutableValues<K,V>

Nested classes/interfaces inherited from interface org.refcodes.mixin.DelimiterAccessor

org.refcodes.mixin.DelimiterAccessor.DelimiterBuilder<B extends org.refcodes.mixin.DelimiterAccessor.DelimiterBuilder<B>>, org.refcodes.mixin.DelimiterAccessor.DelimiterMutator, org.refcodes.mixin.DelimiterAccessor.DelimiterProperty

Nested classes/interfaces inherited from interface org.refcodes.mixin.TypeAccessor

org.refcodes.mixin.TypeAccessor.TypeMutator<T>, org.refcodes.mixin.TypeAccessor.TypeProperty<T>

Nested classes/interfaces inherited from interface org.refcodes.structure.PropertiesAccessorMixin

org.refcodes.structure.PropertiesAccessorMixin.PropertiesBuilderMixin<T>, org.refcodes.structure.PropertiesAccessorMixin.PropertiesMixin, org.refcodes.structure.PropertiesAccessorMixin.PropertiesMutatorMixin

Field Summary

Fields inherited from class org.refcodes.configuration.AbstractPropertiesDecorator

_properties

Fields inherited from interface org.refcodes.configuration.Properties

DEFAULT_COMMENT

Constructor Summary

Constructors

Constructor and Description
RuntimePropertiesComposite(File aFile) Constructs RuntimePropertiesComposite delegating to SystemProperties and EnvironmentProperties as well as to the JavaProperties (in that order).
RuntimePropertiesComposite(InputStream aInputStream) Reads the properties from the given InputStream.
RuntimePropertiesComposite(String aFilePath) Constructs RuntimePropertiesComposite delegating to SystemProperties and EnvironmentProperties as well as to the JavaProperties (in that order).
RuntimePropertiesComposite(URL aUrl) Loads the properties from the given URL.

Method Summary

Methods inherited from class org.refcodes.configuration.AbstractPropertiesDecorator

childrenOf, containsKey, get, getDelimiter, isEmpty, keySet, retrieveFrom, retrieveTo, size, toDataStructure, values

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.refcodes.configuration.Properties

childrenOf, containsValue, getType, retrieve, retrieveFrom, retrieveTo, toMap, toProperties, toPropertyPath

Methods inherited from interface org.refcodes.structure.CanonicalMap

toInstance, toInstance, toType, toType

Methods inherited from interface org.refcodes.structure.PathMap

directories, directories, entries, entries, fromExternalKey, getArray, getArray, hasParentPath, isArray, isArray, isDirectory, isEntry, isRecord, isRootPath, keySet, paths, paths, records, records, toDataStructure, toDataStructure, toExternalKey, toMap, toNormalizedPath, toNormalizedPath, toParentPath, toPath, toRootPath

Methods inherited from interface org.refcodes.structure.Keys

containsKey, get, keySet, use, values

Methods inherited from interface org.refcodes.structure.Containable

isEmpty, size

Methods inherited from interface org.refcodes.mixin.DelimiterAccessor

getDelimiter

Methods inherited from interface org.refcodes.mixin.Dumpable

toDump, toDump

Methods inherited from interface org.refcodes.structure.PropertiesAccessorMixin

containsKey, get, getBoolean, getBoolean, getByte, getByte, getCharacter, getCharacter, getDouble, getDouble, getFloat, getFloat, getInteger, getInteger, getLong, getLong, getShort, getShort, use, useBoolean, useBoolean, useByte, useByte, useDouble, useDouble, useFloat, useFloat, useInteger, useInteger, useLong, useLong, useShort, useShort

Constructor Detail

RuntimePropertiesComposite

public RuntimePropertiesComposite(InputStream aInputStream)
                           throws IOException,
                                  ParseException

Reads the properties from the given InputStream.

Parameters:

aInputStream - The InputStream from which to read the properties.

Throws:

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

ParseException - Signals that an error has been reached unexpectedly while parsing the data to be loaded.

RuntimePropertiesComposite

public RuntimePropertiesComposite(URL aUrl)
                           throws IOException,
                                  ParseException

Loads the properties from the given URL.

Parameters:

aUrl - The URL from which to read the properties.

Throws:

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

ParseException - Signals that an error has been reached unexpectedly while parsing the data to be loaded.

RuntimePropertiesComposite

public RuntimePropertiesComposite(File aFile)
                           throws IOException,
                                  ParseException

Constructs RuntimePropertiesComposite delegating to SystemProperties and EnvironmentProperties as well as to the JavaProperties (in that order). Loads a properties file from the file directly or (if not found) from first folder containing such a file as of the specification for the method RuntimeUtility.toConfigDirs().

Parameters:

aFile - The file of the properties to load.

Throws:

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

ParseException - Signals that an error has been reached unexpectedly while parsing the data to be loaded.

RuntimePropertiesComposite

public RuntimePropertiesComposite(String aFilePath)
                           throws IOException,
                                  ParseException

Constructs RuntimePropertiesComposite delegating to SystemProperties and EnvironmentProperties as well as to the JavaProperties (in that order). Loads a properties file from the file directly or (if not found) from first folder containing such a file as of the specification for the method RuntimeUtility.toConfigDirs().

Parameters:

aFilePath - The file of the properties file to load.

Throws:

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

ParseException - Signals that an error has been reached unexpectedly while parsing the data to be loaded.