A read/write extension of the Configuration interface.
addAll
public void addAll(Configuration other)
Add all the attributes, children and value
from specified configuration element to current
configuration element.
other
- the Configuration
element
addAllAttributes
public void addAllAttributes(Configuration other)
Add all attributes from specified configuration
element to current configuration element.
other
- the Configuration
element
addAllChildren
public void addAllChildren(Configuration other)
Add all child Configuration
objects from specified
configuration element to current configuration element.
other
- the other Configuration
value
addChild
public void addChild(Configuration configuration)
Add a child Configuration
to this configuration element.
configuration
- a Configuration
value
getMutableChild
public MutableConfiguration getMutableChild(String name)
throws ConfigurationException
Equivalent to getMutableChild( name, true )
getMutableChild
public MutableConfiguration getMutableChild(String name,
boolean autoCreate)
throws ConfigurationException
Gets a child node of this configuration. If a mutable child with the
given name exists, it is returned. If an immutable child with the
given name exists, it is converted into a mutable child and returned.
In this case, the immutable child will be replaced with the mutable
child in this configuration (that is, it will be as if the child
node always had been mutable).
If no child with the given name exists, and autoCreate
is true
, a new mutable child is created and added to
this configuration before being returned.
name
- the name of the child.autoCreate
- set to true to create the child node if it doesn't exist.
- the child MutableConfiguration, or
null
if autoCreate
was false and no child by the given name existed.
getMutableChildren
public MutableConfiguration[] getMutableChildren()
throws ConfigurationException
Returns an array of mutable children. Immutable children
are converted just as for getMutableChild
.
getMutableChildren
public MutableConfiguration[] getMutableChildren(String name)
throws ConfigurationException
Returns an array of mutable children with the given name. Immutable children
are converted just as for getMutableChild
.
removeChild
public void removeChild(Configuration configuration)
Remove a child Configuration
to this configuration element.
configuration
- a Configuration
value
setAttribute
public void setAttribute(String name,
String value)
Set the value of the specified attribute to the specified string.
name
- name of the attribute to setvalue
- a String
value. If null, the attribute is removed.
setAttribute
public void setAttribute(String name,
boolean value)
Set the value of the specified attribute to the specified boolean.
name
- name of the attribute to setvalue
- an boolean
value
setAttribute
public void setAttribute(String name,
float value)
Set the value of the specified attribute to the specified float.
name
- name of the attribute to setvalue
- an float
value
setAttribute
public void setAttribute(String name,
int value)
Set the value of the specified attribute to the specified int.
name
- name of the attribute to setvalue
- an int
value
setAttribute
public void setAttribute(String name,
long value)
Set the value of the specified attribute to the specified long.
name
- name of the attribute to setvalue
- an long
value
setValue
public void setValue(String value)
Set the value of this Configuration
object to the specified string.
setValue
public void setValue(boolean value)
Set the value of this Configuration
object to the specified boolean.
setValue
public void setValue(float value)
Set the value of this Configuration
object to the specified float.
setValue
public void setValue(int value)
Set the value of this Configuration
object to the specified int.
setValue
public void setValue(long value)
Set the value of this Configuration
object to the specified long.