nl.knowledgeplaza.util.configuration
Class Configuration

java.lang.Object
  nl.knowledgeplaza.util.configuration.Configuration

public class Configuration
extends java.lang.Object

Field Summary

static java.lang.String	ID_APPLICATION
static java.lang.String	ID_HOST
static java.lang.String	ID_OS
static java.lang.String	ID_PORT
static java.lang.String	ID_SYSTEM
static java.lang.String	ID_USER
static java.lang.String	SOURCECODE_VERSION Standard variable for determining version of a class file.

Constructor Summary

Configuration()
create and initialize with default settings

Configuration(java.io.File... files)
Specify what files to use

Configuration(java.util.Map<java.lang.String,java.lang.String> identifiers)
get all the settings from the system properties then override with provided identifiers

Method Summary

static Configuration	get() Singleton or thread related
java.lang.String	get(java.lang.Class contextClass, java.lang.String propertyName)
java.lang.String	get(java.lang.Class contextClass, java.lang.String propertyName, java.lang.String defaultValue) convenience method: first check full name, then simple name then property only
java.lang.String	get(java.lang.Object contextObject, java.lang.String propertyName)
java.lang.String	get(java.lang.Object contextObject, java.lang.String propertyName, java.lang.String defaultValue) convenience method: use the class of the object
java.lang.String	get(java.lang.String propertyName) find the first definition of a property and return its value
java.lang.String	get(java.lang.String context, java.lang.String propertyName)
java.lang.String	get(java.lang.String context, java.lang.String propertyName, java.lang.String defaultValue) convenience method: first check the context then the pure property name
java.util.List<java.io.File>	getAdditionalPaths() AdditionalPaths
java.util.Map<java.lang.String,java.lang.String>	getCollection(java.lang.Class contextClass, java.lang.String propertyName) convenience method: first check full name, then simple name then property only
java.util.Map<java.lang.String,java.lang.String>	getCollection(java.lang.Object contextObject, java.lang.String propertyName) convenience method: use the class of the object
java.util.Map<java.lang.String,java.lang.String>	getCollection(java.lang.String prefix) get all properties that match a prefix as a map For example: my.collection.1.f.1=A1 my.collection.1.f.2=B1 my.collection.1.f.3=C1 my.collection.3.f.1=A3 my.collection.3.f.2=B3 my.collection.3.f.3=C3 Calling this method with prefix my.collection.1, returns a map with: f.1=A1 f.2=B1 f.3=C1
java.util.Map<java.lang.String,java.lang.String>	getCollection(java.lang.String context, java.lang.String propertyName) convenience method: first check the context then the pure property name
java.util.List<java.io.File>	getForcedFiles()
java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>>	getGroupedCollection(java.lang.String prefix) Get all properties that match a prefix and group them.
java.lang.String	getIdentifier(java.lang.String key) identifier
boolean	getIdentifierLock() IdentifierLock
java.util.Map<java.lang.String,java.lang.String>	getIdentifiers()
java.lang.String	getPrefix() the prefix is configurable
static Configuration	getThreadRelatedConfiguration()
void	log4jDebug(java.lang.String s)
static Configuration	removeThreadRelatedConfiguration()
static java.lang.String	sanatizeIdentifier(java.lang.String s)
static void	set(Configuration Configuration)
void	setAdditionalPaths(java.io.File... value)
void	setAdditionalPaths(java.util.List<java.io.File> value)
void	setIdentifier(java.lang.String key, java.lang.String value) null removes the identifier
void	setIdentifierLock(boolean value)
void	setPrefix(java.lang.String value)
static void	setThreadRelatedConfiguration(Configuration value) ThreadRelatedConfiguration This is the cached Configuration so it only is created only once per thread.
Configuration	withAdditionalPaths(java.util.List<java.io.File> value)
Configuration	withIdentifier(java.lang.String key, java.lang.String value)
Configuration	withPrefix(java.lang.String value)

Methods inherited from class java.lang.Object

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

Field Detail

SOURCECODE_VERSION

public static final java.lang.String SOURCECODE_VERSION

Standard variable for determining version of a class file.

See Also:

Constant Field Values

ID_SYSTEM

public static final java.lang.String ID_SYSTEM

See Also:

Constant Field Values

ID_USER

public static final java.lang.String ID_USER

See Also:

Constant Field Values

ID_OS

public static final java.lang.String ID_OS

See Also:

Constant Field Values

ID_APPLICATION

public static final java.lang.String ID_APPLICATION

See Also:

Constant Field Values

ID_HOST

public static final java.lang.String ID_HOST

See Also:

Constant Field Values

ID_PORT

public static final java.lang.String ID_PORT

See Also:

Constant Field Values

Constructor Detail

Configuration

public Configuration()

create and initialize with default settings

Configuration

public Configuration(java.util.Map<java.lang.String,java.lang.String> identifiers)

get all the settings from the system properties then override with provided identifiers

Configuration

public Configuration(java.io.File... files)

Specify what files to use

Method Detail

get

public static Configuration get()

Singleton or thread related

set

public static void set(Configuration Configuration)

setThreadRelatedConfiguration

public static void setThreadRelatedConfiguration(Configuration value)

ThreadRelatedConfiguration This is the cached Configuration so it only is created only once per thread. It can also be used to preset a Configuration (for example from a session in a webapp).

getThreadRelatedConfiguration

public static Configuration getThreadRelatedConfiguration()

removeThreadRelatedConfiguration

public static Configuration removeThreadRelatedConfiguration()

getForcedFiles

public java.util.List<java.io.File> getForcedFiles()

sanatizeIdentifier

public static java.lang.String sanatizeIdentifier(java.lang.String s)

Parameters:

s -

Returns:

getIdentifier

public java.lang.String getIdentifier(java.lang.String key)

identifier

setIdentifier

public void setIdentifier(java.lang.String key,
                          java.lang.String value)

null removes the identifier

withIdentifier

public Configuration withIdentifier(java.lang.String key,
                                    java.lang.String value)

getIdentifiers

public java.util.Map<java.lang.String,java.lang.String> getIdentifiers()

getIdentifierLock

public boolean getIdentifierLock()

IdentifierLock

setIdentifierLock

public void setIdentifierLock(boolean value)

getPrefix

public java.lang.String getPrefix()

the prefix is configurable

setPrefix

public void setPrefix(java.lang.String value)

withPrefix

public Configuration withPrefix(java.lang.String value)

getAdditionalPaths

public java.util.List<java.io.File> getAdditionalPaths()

AdditionalPaths

setAdditionalPaths

public void setAdditionalPaths(java.util.List<java.io.File> value)

setAdditionalPaths

public void setAdditionalPaths(java.io.File... value)

withAdditionalPaths

public Configuration withAdditionalPaths(java.util.List<java.io.File> value)

get

public java.lang.String get(java.lang.String propertyName)

find the first definition of a property and return its value

get

public java.lang.String get(java.lang.String context,
                            java.lang.String propertyName,
                            java.lang.String defaultValue)

convenience method: first check the context then the pure property name

get

public java.lang.String get(java.lang.String context,
                            java.lang.String propertyName)

get

public java.lang.String get(java.lang.Class contextClass,
                            java.lang.String propertyName,
                            java.lang.String defaultValue)

convenience method: first check full name, then simple name then property only

get

public java.lang.String get(java.lang.Class contextClass,
                            java.lang.String propertyName)

get

public java.lang.String get(java.lang.Object contextObject,
                            java.lang.String propertyName,
                            java.lang.String defaultValue)

convenience method: use the class of the object

get

public java.lang.String get(java.lang.Object contextObject,
                            java.lang.String propertyName)

getCollection

public java.util.Map<java.lang.String,java.lang.String> getCollection(java.lang.String prefix)

get all properties that match a prefix as a map For example: my.collection.1.f.1=A1 my.collection.1.f.2=B1 my.collection.1.f.3=C1 my.collection.3.f.1=A3 my.collection.3.f.2=B3 my.collection.3.f.3=C3 Calling this method with prefix my.collection.1, returns a map with: f.1=A1 f.2=B1 f.3=C1

Parameters:

prefix -

Returns:

getCollection

public java.util.Map<java.lang.String,java.lang.String> getCollection(java.lang.String context,
                                                                      java.lang.String propertyName)

convenience method: first check the context then the pure property name

getCollection

public java.util.Map<java.lang.String,java.lang.String> getCollection(java.lang.Class contextClass,
                                                                      java.lang.String propertyName)

convenience method: first check full name, then simple name then property only

getCollection

public java.util.Map<java.lang.String,java.lang.String> getCollection(java.lang.Object contextObject,
                                                                      java.lang.String propertyName)

convenience method: use the class of the object

getGroupedCollection

public java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> getGroupedCollection(java.lang.String prefix)

Get all properties that match a prefix and group them. For example: my.collection.1.f.1=A1 my.collection.1.f.2=B1 my.collection.1.f.3=C1 my.collection.3.f.1=A3 my.collection.3.f.2=B3 my.collection.3.f.3=C3 Calling this method with prefix my.collection, returns a map with under the key "1" and "3" two maps containing "f.1" with their respective values. So the result is: [1=>[f.1=>A1, f.3=>C1, f.2=>B1], 3=>[f.1=>A3, f.3=>C3, f.2=>B3]] Often de index is not relevant, but having it in a map makes it a bit of a hassle to navigate (pre 1.5) Using " list.addAll(map.values()); " makes it easier.

Parameters:

prefix -

Returns:

log4jDebug

public void log4jDebug(java.lang.String s)