org.objectledge.parameters
Class CompoundParameters

java.lang.Object
  extended by org.objectledge.parameters.CompoundParameters
All Implemented Interfaces:
Parameters

public class CompoundParameters
extends Object
implements Parameters

A compound implementation of parameters.

Version:
$Id: CompoundParameters.java,v 1.8 2006/01/12 15:51:01 rafal Exp $
Author:
Pawel Potempski, Rafal Krzewski

Field Summary
private  List<Parameters> containers
          The underylying containers.
 
Constructor Summary
CompoundParameters(List<Parameters> list)
          Constructs a copound parameter container.
CompoundParameters(Parameters... containers)
          Constructs a copound parameter container.
 
Method Summary
 void add(Parameters parameters, boolean overwrite)
          Adds all parameters from another container to this container.
 void add(String name, boolean value)
          Add the parameter.
 void add(String name, boolean[] values)
          Add the parameter.
 void add(String name, Date value)
          Add the parameter.
 void add(String name, Date[] values)
          Add the parameter.
 void add(String name, float value)
          Add the parameter.
 void add(String name, float[] values)
          Add the parameter.
 void add(String name, int value)
          Add the parameter.
 void add(String name, int[] values)
          Add the parameter.
 void add(String name, long value)
          Add the parameter.
 void add(String name, long[] values)
          Add the parameter.
 void add(String name, String value)
          Add the parameter.
 void add(String name, String[] values)
          Add the parameter.
 String get(String name)
          Return the parameter with specified name.
 String get(String name, String defaultValue)
          Return the parameter with specified name.
 boolean getBoolean(String name)
          Return the parameter with specified name.
 boolean getBoolean(String name, boolean defaultValue)
          Return the parameter with specified name.
 boolean[] getBooleans(String name)
          Return all values of the parameter with specified name as an array.
 Parameters getChild(String prefix)
          Return a parameters object that represents a subset of parameters with specified prefix.
 Date getDate(String name)
          Return the parameter with specified name.
 Date getDate(String name, Date defaultValue)
          Return the parameter with specified name.
 Date[] getDates(String name)
          Return all values of the parameter with specified name as an array.
 float getFloat(String name)
          Return the parameter with specified name.
 float getFloat(String name, float defaultValue)
          Return the parameter with specified name.
 float[] getFloats(String name)
          Return all values of the parameter with specified name as an array.
 int getInt(String name)
          Return the parameter with specified name.
 int getInt(String name, int defaultValue)
          Return the parameter with specified name.
 int[] getInts(String name)
          Return all values of the parameter with specified name as an array.
 long getLong(String name)
          Return the parameter with specified name.
 long getLong(String name, long defaultValue)
          Return the parameter with specified name.
 long[] getLongs(String name)
          Return the parameter as array of long values.
 String[] getParameterNames()
          Return the names of all parameters.
 String[] getStrings(String name)
          Return all values of the parameter with specified name as an array.
 boolean isDefined(String name)
          Checks whether parameter is defined.
 void remove()
          Remove all parameters.
 void remove(Set keys)
          Remove all parameters with a name contained in given set.
 void remove(String name)
          Remove all parameters with a specified name.
 void remove(String name, Date value)
          Remove all parameters with a specified name and value.
 void remove(String name, float value)
          Remove all parameters with a specified name and value.
 void remove(String name, int value)
          Remove all parameters with a specified name and value.
 void remove(String name, long value)
          Remove all parameters with a specified name and value.
 void remove(String name, String value)
          Remove all parameters with a specified name and string value.
 void removeExcept(Set keys)
          Remove all except those with a keys specified in the set.
 void set(Parameters parameters)
          Reset state to equal with given parameters.
 void set(String name, boolean value)
          Set the parameter.
 void set(String name, boolean[] values)
          Set the parameter.
 void set(String name, Date value)
          Set the parameter.
 void set(String name, Date[] values)
          Set the parameter.
 void set(String name, float value)
          Set the parameter.
 void set(String name, float[] values)
          Set the parameter.
 void set(String name, int value)
          Set the parameter.
 void set(String name, int[] values)
          Set the parameter.
 void set(String name, long value)
          Set the parameter.
 void set(String name, long[] values)
          Set the parameter.
 void set(String name, String value)
          Set the parameter.
 void set(String name, String[] values)
          Set the parameter.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface org.objectledge.parameters.Parameters
toString
 

Field Detail

containers

private List<Parameters> containers
The underylying containers.

Constructor Detail

CompoundParameters

public CompoundParameters(Parameters... containers)
Constructs a copound parameter container.

The contatiners with lesser indexes will have precedence over the conainer with greater indexes.

Parameters:
containers - the containers.

CompoundParameters

public CompoundParameters(List<Parameters> list)
Constructs a copound parameter container.

The contatiners with lesser indexes will have precenence over the conainer with greater indexes.

Parameters:
list - the containers.
Method Detail

isDefined

public boolean isDefined(String name)
Checks whether parameter is defined.

Specified by:
isDefined in interface Parameters
Parameters:
name - the name of the parameter.
Returns:
true if parameter is defined.

getParameterNames

public String[] getParameterNames()
Return the names of all parameters.

Specified by:
getParameterNames in interface Parameters
Returns:
the parameter names.

get

public String get(String name)
Return the parameter with specified name.

Specified by:
get in interface Parameters
Parameters:
name - the name of the parameter.
Returns:
the string value of the parameter.

get

public String get(String name,
                  String defaultValue)
Return the parameter with specified name.

Specified by:
get in interface Parameters
Parameters:
name - the name of the parameter.
defaultValue - the default value of the parameter.
Returns:
the string value of the parameter.

getStrings

public String[] getStrings(String name)
Return all values of the parameter with specified name as an array.

Specified by:
getStrings in interface Parameters
Parameters:
name - the name of the parameters.
Returns:
the array of the string values of the parameter.

getBoolean

public boolean getBoolean(String name)
Return the parameter with specified name.

Specified by:
getBoolean in interface Parameters
Parameters:
name - the name of the parameter.
Returns:
the boolean value of the parameter.

getBoolean

public boolean getBoolean(String name,
                          boolean defaultValue)
Return the parameter with specified name.

Specified by:
getBoolean in interface Parameters
Parameters:
name - the name of the parameter.
defaultValue - the default value of the parameter.
Returns:
the boolean value of the parameter.

getBooleans

public boolean[] getBooleans(String name)
Return all values of the parameter with specified name as an array.

Specified by:
getBooleans in interface Parameters
Parameters:
name - the name of the parameters.
Returns:
the array of the boolean values of the parameter.

getDate

public Date getDate(String name)
Return the parameter with specified name. The assumed String value of this parameter is a decimal representation of a Unix time-stamp.

Specified by:
getDate in interface Parameters
Parameters:
name - the name of the parameter.
Returns:
the date value of the parameter.

getDate

public Date getDate(String name,
                    Date defaultValue)
Return the parameter with specified name. The assumed String value of this parameter is a decimal representation of a Unix time-stamp.

Specified by:
getDate in interface Parameters
Parameters:
name - the name of the parameter.
defaultValue - the default value of the parameter.
Returns:
the date value of the parameter.

getDates

public Date[] getDates(String name)
Return all values of the parameter with specified name as an array. The assumed String values of this parameter is are decimal representations of Unix time-stamps.

Specified by:
getDates in interface Parameters
Parameters:
name - the name of the parameters.
Returns:
the array of the date values of the parameter.

getInt

public int getInt(String name)
Return the parameter with specified name.

Specified by:
getInt in interface Parameters
Parameters:
name - the name of the parameter.
Returns:
the integer value of the parameter.

getInt

public int getInt(String name,
                  int defaultValue)
Return the parameter with specified name.

Specified by:
getInt in interface Parameters
Parameters:
name - the name of the parameter.
defaultValue - the default value of the parameter.
Returns:
the integer value of the parameter.

getInts

public int[] getInts(String name)
Return all values of the parameter with specified name as an array.

Specified by:
getInts in interface Parameters
Parameters:
name - the name of the parameters.
Returns:
the array of the integer values of the parameter.

getLong

public long getLong(String name)
Return the parameter with specified name.

Specified by:
getLong in interface Parameters
Parameters:
name - the name of the parameter.
Returns:
the integer value of the parameter.

getLong

public long getLong(String name,
                    long defaultValue)
Return the parameter with specified name.

Specified by:
getLong in interface Parameters
Parameters:
name - the name of the parameter.
defaultValue - the default value of the parameter.
Returns:
the integer value of the parameter.

getLongs

public long[] getLongs(String name)
Return the parameter as array of long values.

Specified by:
getLongs in interface Parameters
Parameters:
name - the name of the parameter.
Returns:
the array of parameter values.

getFloat

public float getFloat(String name)
Return the parameter with specified name.

Specified by:
getFloat in interface Parameters
Parameters:
name - the name of the parameter.
Returns:
the float value of the parameter.

getFloat

public float getFloat(String name,
                      float defaultValue)
Return the parameter with specified name.

Specified by:
getFloat in interface Parameters
Parameters:
name - the name of the parameter.
defaultValue - the default value of the parameter.
Returns:
the float value of the parameter.

getFloats

public float[] getFloats(String name)
Return all values of the parameter with specified name as an array.

Specified by:
getFloats in interface Parameters
Parameters:
name - the name of the parameters.
Returns:
the array of the float values of the parameter.

getChild

public Parameters getChild(String prefix)
Return a parameters object that represents a subset of parameters with specified prefix.

Specified by:
getChild in interface Parameters
Parameters:
prefix - the prefix.
Returns:
the nested parameters object.

remove

public void remove()
Remove all parameters.

Specified by:
remove in interface Parameters

remove

public void remove(String name)
Remove all parameters with a specified name.

Specified by:
remove in interface Parameters
Parameters:
name - the parameter name.

remove

public void remove(String name,
                   String value)
Remove all parameters with a specified name and string value.

Specified by:
remove in interface Parameters
Parameters:
name - the parameter name.
value - the parameter value.

remove

public void remove(String name,
                   Date value)
Remove all parameters with a specified name and value.

Specified by:
remove in interface Parameters
Parameters:
name - the parameter name.
value - the parameter value.

remove

public void remove(String name,
                   float value)
Remove all parameters with a specified name and value.

Specified by:
remove in interface Parameters
Parameters:
name - the parameter name.
value - the parameter value.

remove

public void remove(String name,
                   int value)
Remove all parameters with a specified name and value.

Specified by:
remove in interface Parameters
Parameters:
name - the parameter name.
value - the parameter value.

remove

public void remove(String name,
                   long value)
Remove all parameters with a specified name and value.

Specified by:
remove in interface Parameters
Parameters:
name - the parameter name.
value - the parameter value.

remove

public void remove(Set keys)
Remove all parameters with a name contained in given set.

Specified by:
remove in interface Parameters
Parameters:
keys - the set of keys.

removeExcept

public void removeExcept(Set keys)
Remove all except those with a keys specified in the set.

Specified by:
removeExcept in interface Parameters
Parameters:
keys - the set of names.

set

public void set(String name,
                String value)
Set the parameter.

Specified by:
set in interface Parameters
Parameters:
name - the parameter name.
value - the parameter value.

set

public void set(String name,
                String[] values)
Set the parameter.

Specified by:
set in interface Parameters
Parameters:
name - the parameter name.
values - the parameter values.

set

public void set(String name,
                Date value)
Set the parameter.

Specified by:
set in interface Parameters
Parameters:
name - the parameter name.
value - the parameter value.

set

public void set(String name,
                Date[] values)
Set the parameter.

Specified by:
set in interface Parameters
Parameters:
name - the parameter name.
values - the parameter values.

set

public void set(String name,
                boolean value)
Set the parameter.

Specified by:
set in interface Parameters
Parameters:
name - the parameter name.
value - the parameter value.

set

public void set(String name,
                boolean[] values)
Set the parameter.

Specified by:
set in interface Parameters
Parameters:
name - the parameter name.
values - the parameter values.

set

public void set(String name,
                float value)
Set the parameter.

Specified by:
set in interface Parameters
Parameters:
name - the parameter name.
value - the parameter value.

set

public void set(String name,
                float[] values)
Set the parameter.

Specified by:
set in interface Parameters
Parameters:
name - the parameter name.
values - the parameter values.

set

public void set(String name,
                int value)
Set the parameter.

Specified by:
set in interface Parameters
Parameters:
name - the parameter name.
value - the parameter value.

set

public void set(String name,
                int[] values)
Set the parameter.

Specified by:
set in interface Parameters
Parameters:
name - the parameter name.
values - the parameter values.

set

public void set(String name,
                long value)
Set the parameter.

Specified by:
set in interface Parameters
Parameters:
name - the parameter name.
value - the parameter value.

set

public void set(String name,
                long[] values)
Set the parameter.

Specified by:
set in interface Parameters
Parameters:
name - the parameter name.
values - the parameter values.

set

public void set(Parameters parameters)
Reset state to equal with given parameters.

Specified by:
set in interface Parameters
Parameters:
parameters - the source parameters.

add

public void add(String name,
                String value)
Add the parameter.

Specified by:
add in interface Parameters
Parameters:
name - the parameter name.
value - the parameter value.

add

public void add(String name,
                String[] values)
Add the parameter.

Specified by:
add in interface Parameters
Parameters:
name - the parameter name.
values - the parameter values.

add

public void add(String name,
                Date value)
Add the parameter.

Specified by:
add in interface Parameters
Parameters:
name - the parameter name.
value - the parameter value.

add

public void add(String name,
                Date[] values)
Add the parameter.

Specified by:
add in interface Parameters
Parameters:
name - the parameter name.
values - the parameter values.

add

public void add(String name,
                boolean value)
Add the parameter.

Specified by:
add in interface Parameters
Parameters:
name - the parameter name.
value - the parameter value.

add

public void add(String name,
                boolean[] values)
Add the parameter.

Specified by:
add in interface Parameters
Parameters:
name - the parameter name.
values - the parameter values.

add

public void add(String name,
                float value)
Add the parameter.

Specified by:
add in interface Parameters
Parameters:
name - the parameter name.
value - the parameter value.

add

public void add(String name,
                float[] values)
Add the parameter.

Specified by:
add in interface Parameters
Parameters:
name - the parameter name.
values - the parameter values.

add

public void add(String name,
                int value)
Add the parameter.

Specified by:
add in interface Parameters
Parameters:
name - the parameter name.
value - the parameter value.

add

public void add(String name,
                int[] values)
Add the parameter.

Specified by:
add in interface Parameters
Parameters:
name - the parameter name.
values - the parameter values.

add

public void add(String name,
                long value)
Add the parameter.

Specified by:
add in interface Parameters
Parameters:
name - the parameter name.
value - the parameter value.

add

public void add(String name,
                long[] values)
Add the parameter.

Specified by:
add in interface Parameters
Parameters:
name - the parameter name.
values - the parameter values.

add

public void add(Parameters parameters,
                boolean overwrite)
Adds all parameters from another container to this container. If overwrite is set to true all conflicting parameters from this container will be replaced, otherwise all parameters from another container will be added.

Specified by:
add in interface Parameters
Parameters:
parameters - the parameters object.
overwrite - the overwrite switch.


Copyright © 2003-2006 objectledge.org. All Rights Reserved.