org.apache.excalibur.configuration
Class ConfigurationUtil

java.lang.Object
  extended byorg.apache.excalibur.configuration.ConfigurationUtil

public class ConfigurationUtil
extends Object

General utility supporting static operations for generating string representations of a configuration suitable for debugging.

Author:
Stephen McConnell , Peter Royal

Constructor Summary
ConfigurationUtil()
           
 
Method Summary
static boolean equals(Configuration c1, Configuration c2)
          Test to see if two Configuration's can be considered the same.
static String list(Configuration config)
          Returns a simple string representation of the the supplied configuration.
static void list(StringBuffer buffer, String lead, Configuration config)
          populates a string buffer with an XML representation of a supplied configuration.
static Configuration[] match(Configuration config, String element, String attribute)
          Return all occurance of a configuration child containing the supplied attribute name.
static Configuration[] match(Configuration config, String element, String attribute, String value)
          Return occurance of a configuration child containing the supplied attribute name and value.
static Configuration matchFirstOccurance(Configuration config, String element, String attribute, String value)
          Return the first occurance of a configuration child containing the supplied attribute name and value or create a new empty configuration if no match found.
static Configuration matchFirstOccurance(Configuration config, String element, String attribute, String value, boolean create)
          Return the first occurance of a configuration child containing the supplied attribute name and value.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ConfigurationUtil

public ConfigurationUtil()
Method Detail

list

public static String list(Configuration config)
Returns a simple string representation of the the supplied configuration.

Parameters:
config - a configuration
Returns:
a simplified text representation of a configuration suitable for debugging

list

public static void list(StringBuffer buffer,
                        String lead,
                        Configuration config)
populates a string buffer with an XML representation of a supplied configuration.

Parameters:
buffer - the string buffer
lead - padding offset
config - a configuration
Returns:
a simplified text representation of a configuration suitable for debugging

match

public static Configuration[] match(Configuration config,
                                    String element,
                                    String attribute)
Return all occurance of a configuration child containing the supplied attribute name.

Parameters:
config - the configuration
element - the name of child elements to select from the configuration
attribute - the attribute name to filter (null will match any attribute name)
Returns:
an array of configuration instances matching the query

match

public static Configuration[] match(Configuration config,
                                    String element,
                                    String attribute,
                                    String value)
Return occurance of a configuration child containing the supplied attribute name and value.

Parameters:
config - the configuration
element - the name of child elements to select from the configuration
attribute - the attribute name to filter (null will match any attribute name )
value - the attribute value to match (null will match any attribute value)
Returns:
an array of configuration instances matching the query

matchFirstOccurance

public static Configuration matchFirstOccurance(Configuration config,
                                                String element,
                                                String attribute,
                                                String value)
Return the first occurance of a configuration child containing the supplied attribute name and value or create a new empty configuration if no match found.

Parameters:
config - the configuration
element - the name of child elements to select from the configuration
attribute - the attribute name to filter
value - the attribute value to match (null will match any attribute value)
Returns:
a configuration instances matching the query or empty configuration

matchFirstOccurance

public static Configuration matchFirstOccurance(Configuration config,
                                                String element,
                                                String attribute,
                                                String value,
                                                boolean create)
Return the first occurance of a configuration child containing the supplied attribute name and value. If the supplied creation policy if TRUE and no match is found, an empty configuration instance is returned, otherwise a null will returned.

Parameters:
config - the configuration
element - the name of child elements to select from the configuration
attribute - the attribute name to filter
value - the attribute value to match (null will match any attribute value)
create - the creation policy if no match
Returns:
a configuration instances matching the query

equals

public static boolean equals(Configuration c1,
                             Configuration c2)
Test to see if two Configuration's can be considered the same. Name, value, attributes and children are test. The order of children is not taken into consideration for equality.

Parameters:
c1 - Configuration to test
c2 - Configuration to test
Returns:
true if the configurations can be considered equals


Copyright © 2002-2003 Apache Software Foundation. All Rights Reserved.