er.extensions.foundation

Class ERXSystem

java.lang.Object

er.extensions.foundation.ERXSystem

All Implemented Interfaces:

com.webobjects.foundation.NSKeyValueCoding, com.webobjects.foundation.NSKeyValueCodingAdditions

public class ERXSystem
extends Object
implements com.webobjects.foundation.NSKeyValueCoding, com.webobjects.foundation.NSKeyValueCodingAdditions

ERXSystem provides support for variable replacement in Properties with @@key@@ references in values. Additionally, it provides an NSKVC implementation on top of System properties.

Author:

david teran

Nested Class Summary

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

com.webobjects.foundation.NSKeyValueCodingAdditions.DefaultImplementation, com.webobjects.foundation.NSKeyValueCodingAdditions.Utility

Nested classes/interfaces inherited from interface com.webobjects.foundation.NSKeyValueCoding

com.webobjects.foundation.NSKeyValueCoding._BooleanFieldBinding, com.webobjects.foundation.NSKeyValueCoding._BooleanMethodBinding, com.webobjects.foundation.NSKeyValueCoding._FieldBinding, com.webobjects.foundation.NSKeyValueCoding._ForwardingBinding, com.webobjects.foundation.NSKeyValueCoding._KeyBinding, com.webobjects.foundation.NSKeyValueCoding._KeyBindingCreation, com.webobjects.foundation.NSKeyValueCoding._MethodBinding, com.webobjects.foundation.NSKeyValueCoding._NumberFieldBinding, com.webobjects.foundation.NSKeyValueCoding._NumberMethodBinding, com.webobjects.foundation.NSKeyValueCoding._ReflectionKeyBindingCreation, com.webobjects.foundation.NSKeyValueCoding.ErrorHandling, com.webobjects.foundation.NSKeyValueCoding.MapImplementation, com.webobjects.foundation.NSKeyValueCoding.Null<T>, com.webobjects.foundation.NSKeyValueCoding.UnknownKeyException, com.webobjects.foundation.NSKeyValueCoding.ValueAccessor

Field Summary

Fields inherited from interface com.webobjects.foundation.NSKeyValueCodingAdditions

_CLASS, _KeyPathSeparatorChar, KeyPathSeparator

Fields inherited from interface com.webobjects.foundation.NSKeyValueCoding

NullValue

Method Summary

Modifier and Type	Method and Description
static void	convertProperties(Properties originalProperties, Properties destinationProperties) Converts the property names defined in originalProperties with the ERXSystem.getProperty(..) method and puts the resulting values into the destinationProperties.
static Properties	getProperties() Returns a copy of NSProperties._getProperties() that has been passed variable evaluation.
static String	getProperty(String key) Looks up the given key in the ERXSystem properties, converts any property variables, and returns the converted value.
static String	getProperty(String key, Properties properties) Looks up the given key in the given properties, converts any property variables, and returns the converted value.
static String	getProperty(String key, String defaultValue) Retrieves the value of the given key from the ERXSystem properties store, return defaultValue if the key does not exist.
void	takeValueForKey(Object value, String key)
void	takeValueForKeyPath(Object value, String key)
static void	updateProperties() Converts and evaluates the properties from NSProperties._getProperties() and replaces the converted values in-place.
static void	updateProperties(Properties properties) Converts and evaluates the properties from the given properties and replaces the converted values in-place.
Object	valueForKey(String key)
Object	valueForKeyPath(String key)

Methods inherited from class java.lang.Object

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

Method Detail

getProperty

public static String getProperty(String key)

Looks up the given key in the ERXSystem properties, converts any property variables, and returns the converted value.

Parameters:

key - the key to lookup

Returns:

the converted value

getProperty

public static String getProperty(String key,
                                 Properties properties)

Looks up the given key in the given properties, converts any property variables, and returns the converted value.

Parameters:

key - the key to lookup

properties - The given properties

Returns:

the converted value

getProperty

public static String getProperty(String key,
                                 String defaultValue)

Retrieves the value of the given key from the ERXSystem properties store, return defaultValue if the key does not exist.

Parameters:

key - the key to lookup

defaultValue - the default value to return

Returns:

the corresponding value or defaultValue if the key doesn't exist

convertProperties

public static void convertProperties(Properties originalProperties,
                                     Properties destinationProperties)

Converts the property names defined in originalProperties with the ERXSystem.getProperty(..) method and puts the resulting values into the destinationProperties.

Parameters:

originalProperties - the properties to convert

destinationProperties - the properties to copy into

getProperties

public static Properties getProperties()

Returns a copy of NSProperties._getProperties() that has been passed variable evaluation.

Returns:

a converted copy of NSProperties._getProperties()

updateProperties

public static void updateProperties()

Converts and evaluates the properties from NSProperties._getProperties() and replaces the converted values in-place.

updateProperties

public static void updateProperties(Properties properties)

Converts and evaluates the properties from the given properties and replaces the converted values in-place.

Parameters:

properties - the properties to convert and evaluate

valueForKey

public Object valueForKey(String key)

Specified by:

valueForKey in interface com.webobjects.foundation.NSKeyValueCoding

takeValueForKey

public void takeValueForKey(Object value,
                            String key)

Specified by:

takeValueForKey in interface com.webobjects.foundation.NSKeyValueCoding

valueForKeyPath

public Object valueForKeyPath(String key)

Specified by:

valueForKeyPath in interface com.webobjects.foundation.NSKeyValueCodingAdditions

takeValueForKeyPath

public void takeValueForKeyPath(Object value,
                                String key)

Specified by:

takeValueForKeyPath in interface com.webobjects.foundation.NSKeyValueCodingAdditions