|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.apache.commons.configuration.AbstractConfiguration
org.apache.commons.configuration.SubsetConfiguration
A subset of another configuration. The new Configuration object contains every key from the parent Configuration that starts with prefix. The prefix is removed from the keys in the subset.
It is usually not necessary to use this class directly. Instead the
method should be used,
which will return a correctly initialized instance.Configuration.subset(String)
Field Summary | |
protected String |
delimiter
The prefix delimiter |
protected Configuration |
parent
The parent configuration. |
protected String |
prefix
The prefix used to select the properties. |
Fields inherited from class org.apache.commons.configuration.AbstractConfiguration |
END_TOKEN, START_TOKEN |
Constructor Summary | |
SubsetConfiguration(Configuration parent,
String prefix)
Create a subset of the specified configuration |
|
SubsetConfiguration(Configuration parent,
String prefix,
String delimiter)
Create a subset of the specified configuration |
Method Summary | |
void |
addPropertyDirect(String key,
Object value)
Adds a key/value pair to the Configuration. Override this method to provide write acces to underlying Configuration store. |
void |
clearProperty(String key)
Remove a property from the configuration. |
boolean |
containsKey(String key)
Check if the configuration contains the specified key. |
protected String |
getChildKey(String key)
Return the key in the subset configuration associated to the specified key in the parent configuration. |
Iterator |
getKeys()
Get the list of the keys contained in the configuration. |
Iterator |
getKeys(String prefix)
Get the list of the keys contained in the configuration that match the specified prefix. |
Configuration |
getParent()
Return the parent configuation for this subset. |
protected String |
getParentKey(String key)
Return the key in the parent configuration associated to the specified key in this subset. |
String |
getPrefix()
Return the prefix used to select the properties in the parent configuration. |
Object |
getProperty(String key)
Gets a property from the configuration. |
protected String |
interpolate(String base)
interpolate key names to handle ${key} stuff |
boolean |
isEmpty()
Check if the configuration is empty. |
boolean |
isThrowExceptionOnMissing()
Returns true if missing values throw Exceptions. The subset inherits this feature from its parent if it supports this feature. |
void |
setPrefix(String prefix)
Set the prefix used to select the properties in the parent configuration. |
void |
setProperty(String key,
Object value)
Set a property, this will replace any previously set values. Set values is implicitly a call to clearProperty(key), addProperty(key, value). |
void |
setThrowExceptionOnMissing(boolean throwExceptionOnMissing)
If set to false, missing elements return null if possible (for objects). Change the behaviour of the parent configuration if it supports this feature. |
Configuration |
subset(String prefix)
Return a decorator Configuration containing every key from the current Configuration that starts with the specified prefix. The prefix is removed from the keys in the subset. For example, if the configuration contains the following properties: prefix.number = 1 prefix.string = Apache prefixed.foo = bar prefix = Jakartathe Configuration returned by subset("prefix") will contain
the properties:
number = 1 string = Apache = Jakarta(The key for the value "Jakarta" is an empty string) Since the subset is a decorator and not a modified copy of the initial Configuration, any change made to the subset is available to the Configuration, and reciprocally. |
Methods inherited from class org.apache.commons.configuration.AbstractConfiguration |
addProperty, clear, getBigDecimal, getBigDecimal, getBigInteger, getBigInteger, getBoolean, getBoolean, getBoolean, getByte, getByte, getByte, getDelimiter, getDouble, getDouble, getDouble, getFloat, getFloat, getFloat, getInt, getInt, getInteger, getList, getList, getLong, getLong, getLong, getProperties, getProperties, getShort, getShort, getShort, getString, getString, getStringArray, interpolateHelper, resolveContainerStore, setDelimiter |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
protected Configuration parent
protected String prefix
protected String delimiter
Constructor Detail |
public SubsetConfiguration(Configuration parent, String prefix)
parent
- The parent configurationprefix
- The prefix used to select the propertiespublic SubsetConfiguration(Configuration parent, String prefix, String delimiter)
parent
- The parent configurationprefix
- The prefix used to select the propertiesdelimiter
- The prefix delimiterMethod Detail |
protected String getParentKey(String key)
key
- The key in the subset.protected String getChildKey(String key)
key
- The key in the parent configuration.public Configuration getParent()
public String getPrefix()
public void setPrefix(String prefix)
public Configuration subset(String prefix)
prefix.number = 1 prefix.string = Apache prefixed.foo = bar prefix = Jakartathe Configuration returned by
subset("prefix")
will contain
the properties:
number = 1 string = Apache = Jakarta(The key for the value "Jakarta" is an empty string)
Since the subset is a decorator and not a modified copy of the initial Configuration, any change made to the subset is available to the Configuration, and reciprocally.
subset
in interface Configuration
subset
in class AbstractConfiguration
public boolean isEmpty()
isEmpty
in interface Configuration
isEmpty
in class AbstractConfiguration
public boolean containsKey(String key)
containsKey
in interface Configuration
containsKey
in class AbstractConfiguration
public void addPropertyDirect(String key, Object value)
addPropertyDirect
in class AbstractConfiguration
key
- key to use for mappingvalue
- object to storepublic void setProperty(String key, Object value)
setProperty
in interface Configuration
setProperty
in class AbstractConfiguration
public void clearProperty(String key)
clearProperty
in interface Configuration
clearProperty
in class AbstractConfiguration
public Object getProperty(String key)
key
- property to retrieve
public Iterator getKeys(String prefix)
getKeys
in interface Configuration
getKeys
in class AbstractConfiguration
public Iterator getKeys()
getKeys
in interface Configuration
getKeys
in class AbstractConfiguration
protected String interpolate(String base)
interpolate
in class AbstractConfiguration
base
- string to interpolate
public void setThrowExceptionOnMissing(boolean throwExceptionOnMissing)
setThrowExceptionOnMissing
in class AbstractConfiguration
throwExceptionOnMissing
- The new value for the propertypublic boolean isThrowExceptionOnMissing()
isThrowExceptionOnMissing
in class AbstractConfiguration
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |