##### Configuration

- Home
- Download
- User's Guide
- Howtos (Release 1.2)
- Runtime Dependencies
- Building
- Roadmap
- Javadoc (Release 1.3)
- Javadoc (Release 1.2)
- Javadoc (Release 1.1)
- Javadoc (Release 1.0)
- SVN

##### Extensions

- Avalon Component

##### Project Documentation

- About
- Downloads
- Project Info
- Project Reports
  - Metrics
  - Checkstyle
  - Changes
  - Change Log
  - File Activity
  - Developer Activity
  - JavaDocs
  - JavaDoc Report
  - Source Xref
  - Test Xref
  - Unit Tests
  - Task List
  - PMD Report
  - Cobertura
  - Tasks
  - FindBugs Report
- Development Process

##### Commons

- Home
- Components
- Sandbox
- Dormant
- Volunteering
- Contributing Patches
- Building Components
- Releasing Components
- Wiki

##### Legend

- External Link
- Opens in a new window

## Release History

Version | Date | Description
--- | --- | ---
1.3 | 2006-09-24 |
1.3-rc2 | 2006-09-03 |
1.3-rc1 | 2006-07-30 |
1.2 | 2005-12-17 |
1.2-rc3 | 2005-12-07 |
1.2-rc2 | 2005-11-23 |
1.2-rc1 | 2005-11-11 |
1.1 | 2005-04-02 |
1.1-rc2 | 2005-03-06 |
1.1-rc1 | 2005-02-13 |
1.0 | 2004-10-11 |
1.0-rc2 | 2004-09-24 |
1.0-rc1 | 2004-08-14 |

Get the RSS feed of the last changes

## Release 1.3 - 2006-09-24

Type | Changes | By
--- | --- | ---

## Release 1.3-rc2 - 2006-09-03

Type | Changes | By
--- | --- | ---
| AbstractFileConfiguration now overrides addProperty() and setProperty() instead of addPropertyDirect() to implement the auto save feature. This was necessary to properly integrate PropertiesConfigurationLayout. It has also the advantage that an auto save is triggered only once if multi-valued properties are involved (before a save operation was performed for each property value). Fixes CONFIGURATION-223. Thanks to Gabriele Garuglieri . | oheger
| The new PropertiesConfigurationLayout class broke the save() operation of PropertiesConfiguration when an instance was newly created and populated in memory. This is fixed now by ensuring that a layout object is immediately created and registered as event listener at the con figuration. Fixes CONFIGURATION-222. Thanks to Gabriele Garuglieri . | oheger
| ConfigurationFactory now supports variables in its configuration definition files. These variables are resolved using system properties and have the typical ${} syntax. Fixes CONFIGURATION-221. Thanks to Rainer Jung . | oheger
| There were still some problems with resolving relative paths when configuration files are loaded from classpath. This fix addresses these issues. Fixes CONFIGURATION-216. Thanks to Gabriele Garuglieri . | oheger
| DataConfiguration.getDateArray() used to ignore the format argument. This was fixed. Fixes CONFIGURATION-220. | oheger
| PropertiesConfiguration now defines its own clone() method to handle the associated PropertiesConfigurationLayout object correctly. Fixes CONFIGURATION-219. | oheger

## Release 1.3-rc1 - 2006-07-30

Type | Changes | By
--- | --- | ---
| The dependency to servletapi was updated from version 2.3 to version 2.4, but version 2.3 will still work. Fixes CONFIGURATION-217. | oheger
| A new class PropertiesConfigurationLayout was introduced whose task is to preserve the structure (e.g. comments, blanc lines) of a file loaded by PropertiesConfiguration. Each PropertiesConfiguration object is now associated with such a layout object. A saved properties file will look very similar to its original. Fixes CONFIGURATION-104. | oheger
| clone() methods have been added to BaseConfiguration, AbstractFileConfiguration, MapConfiguration, CompositeConfiguration, and CombinedConfiguration. So the most important Configuration imple mentations now support cloning. To ConfigurationUtils an utility method cloneConfiguration() was added that allows to conveniently clone a configuration. Fixes CONFIGURATION-145. | oheger
| If a configuration file was to be loaded from classpath, the constructor of AbstractFileConfiguration dropped the file's path. The path is now taken into account. Fixes CONFIGURATION-216. | oheger
| The getter methods for numeric data types in AbstractConfiguration now support conversions between different Number types, e.g. you can now call getLong(key) when key points to an Integer value. Fixes CONFIGURATION-214. | oheger
| The new class DefaultConfigurationBuilder was added as an alternative to ConfigurationFactory. It provides some more features and creates a CombinedConfiguration object | oheger
| The new class CombinedConfiguration was added as a hierarchical alternative to CompositeConfiguration. | oheger
| Support for low-level configuration events was added to all classes derived from AbstractConfiguration. The major part of this is handled by the new super class EventSource of AbstractConfiguration. Fixes CONFIGURATION-143. | oheger
| A new method convertToHierarchical() was added to ConfigurationUtils, which is able to convert an arbitrary configuration object into a hierarchical configuration. | oheger
| Loading of file-based configurations no longer throws a NullPointerException in setups where the thread context class loader is not set. Fixes CONFIGURATION-63. | oheger
| The dependency to dom4j was removed; it was only used by two test classes, which have been re-written. | oheger
| XMLConfiguration used to drop the DOCTYPE declaration when saving the configuration. It is now able to extract the DTD's public and system ID and write them back (more complex DOCTYPE declarations are still not supported). With the new methods setSystemID() and setPublicID(), the DOCTYPE declaration can be configured. Fixes CONFIGURATION-100. | oheger
| Added two new constructors in CompositeConfiguration accepting a collection of configurations as a parameter. Fixes CONFIGURATION-178. | ebourg
| (Basic) Support for declaring beans in configuration files was added. Some new classes in the beanutils package allow to create instances from these declarations. Fixes CONFIGURATION-186. | oheger
| The implementation of the interpolation features have been extracted out off AbstractConfiguration and moved to PropertyConverter. The interpolateHelper() method of AbstractConfiguration is now deprectated and will not be called any more during interpolation. | oheger
| A new method configurationsAt() was added to HierarchicalConfiguration that provides a convenient way of iterating over complex list-like structures without the need of manually constructing configuration keys with indices. Fixes CONFIGURATION-182. | oheger
| A new class SubnodeConfiguration was introduced that wraps a configuration node of a HierarchicalConfiguration. All operations performed on this configuration use this wrapped node as root. The new configurationA t() method of HierarchicalConfiguration returns such a SubnodeConfiguration for a specified sub node. | oheger
| With XPathExpressionEngine an expression engine for hierarchical configurations is now available that can evaluate XPATH expressions in property keys. This expression engine implementation is based on Commons JXPath, which is now declared as a new dependency (but at runtime it is only needed if the XPathExpressionEngine class is used). Fixes CONFIGURATION-173. | oheger
| The code for interpreting property keys was refactored out off HierarchicalConfiguration. Instead this class now supports pluggable expression engines (using the setExpressionEngine() method). So it is possible to plug in different expression languages. A default expression engine is provided that understands the native expression language used by hierarchical configurations in older versions. During the process of this refactoring some methods of HierarchicalConfiguration have been deprecated; they will not be called any more when searching or adding properties. These are the following: createAddPath(), fetchAddNode(), findLastPathNode(), findPropertyNodes(). | oheger
| A larger refactoring was performed on the inner Node class of HierarchicalConfiguration: A ConfigurationNode interface was extracted for which a default implementation (DefaultConfigurationNode) is provided. HierarchicalConfiguration.Node now extends this default implementation. The new ConfigurationNode interface defines some more methods than the Node class did originally for conveniently dealing with sub nodes and attributes. HierarchicalConfiguration now uses the new type ConfigurationNode whereever possi ble. Some methods dealing with Node objects have been deprecated and replaced by versions operating on ConfigurationNode objects instead. | oheger
| All configuration classes derived from AbstractConfiguration now allow to set an instance specific list delimiter. This can be done through the new method setListDelimiter(). As before it is possible to define a default list delimiter, which will be used if no instance specific delimiter is set. This can be done using the new setDefaultListDelimiter() method (the methods get/setDelimiter() have been deprecated). With the new setDelimiterParsingDisabled() method parsing of lists can be disabled at all. Fixes CONFIGURATION-155. Thanks to Jorge Ferrer . | oheger

## Release 1.2 - 2005-12-17

Type | Changes | By
--- | --- | ---

## Release 1.2-rc3 - 2005-12-07

Type | Changes | By
--- | --- | ---
| Commons Configuration now declares a dependency to Xalan. As with Xerces this dependency is only needed for JDK 1.3. It was introduced in a process of making Configuration buildable on a JDK 1.3. Documentation about the build process was also added. | oheger
| The dependency to Commons Beanutils Collections was unnecessary and thus removed. | oheger
| Commons Configuration now depends on Commons Digester 1.6 instead of 1.5. (This was done only to pick up the latest available release of digester.) | oheger

## Release 1.2-rc2 - 2005-11-23

Type | Changes | By
--- | --- | ---
| ConfigurationDynaBean now implements the java.util.Map interface (as was stated in the javadocs). This was done by deriving the class from ConfigurationMap. Fixes CONFIGURATION-2. | oheger

## Release 1.2-rc1 - 2005-11-11

Type | Changes | By
--- | --- | ---
| The reload() method in AbstractFileConfiguration was updated to prevent reentrant invocation, which may be caused by some methods when they are called during a reloading operation. Fixes CONFIGURATION-33. | oheger
| AbstractHierarchicalFileConfiguration, a new base class for file based hierarchical configurations, was introduced. XMLConfiguration now extends this class. | ebourg, oheger
| XMLConfiguration now prints the used encoding in the xml declaration of generated files. In earlier versions always the default encoding was written. PropertiesConfiguration now always uses the platform specific line separator when saving files. Fixes CONFIGURATION-41. Thanks to Kay Doebl . | oheger
| PropertiesConfiguration now translates properly the escaped unicode characters (like \u1234) used in the property keys. This complies with the specification of java.util.Properties. Fixes CONFIGURATION-8. | ebourg
| ConfigurationConverter.getProperties() now uses the delimiter of the specified configuration to convert the list properties into strings. Fixes CONFIGURATION-123. | ebourg
| The interpolation of variables (${foo}) is now performed in all property getters of AbstractConfiguration and DataConfiguration. As a side effect the Properties object returned by ConfigurationConverter.getProperties() contains only interpolated values. Fixes CONFIGURATION-123. | ebourg
| PropertiesConfiguration now uses the ISO -8859-1 encoding by default instead of the system encoding to comply with the specification of java.util.Properties. Fixes CONFIGURATION-35. | ebourg
| JNDIConfiguration no longer logs an error when attempting to get a property that doesn't exist in the configuration. Fixes CONFIGURATION-44. | ebourg
| Attempting to load a configuration from a directory instead of a file will now throw a ConfigurationException. Fixes CONFIGURATION-99. | ebourg
| If a multi-valued property was involved in an interpolation operation, AbstractConfiguration created a string representation of the list of all values. This was changed to only use the first value, which makes more sense in this context and is consistent with other getters for single valued properties. Fixes CONFIGURATION-28. | oheger
| If an include file with a relative path cannot be found in the base path, PropertiesConfiguration now also tries to resolve it based on its own location. Fixes CONFIGURATION-83. | oheger
| Fixed MapConfiguration to store the list of values added under a same key instead of the last value added. Fixes CONFIGURATION-117. Thanks to Steve Bate . | ebourg
| Fixed a bug in the handling of relative file names in ConfigurationFactory: In most cases relative file names were not resolved relative to the location of the configuration definition file as stated in the documentation. This behavior was now changed to always be in sync with the documentation. This may have an impact on existing code which uses workarounds for the erroneous resolving mechanism. Fixes CONFIGURATION-80. | oheger
| Empty elements or elements whose content consists only of comments or whitespace are now taken into account by XMLConfiguration. They are added to the configuration; their value is an empty string. Fixes CONFIGURATION-6. | oheger
| XMLConfiguration now sets a valid system id in the InputSource used for loading files. This enables XML parsers to correctly resolve relative files, e.g. DTDs. | oheger
| getKeys() in HierarchicalConfiguration now returns the keys in the same order the properties were inserted. Fixes CONFIGURATION-74. | ebourg
| Commons Configuration now depends on Commons Collections 3.1 instead of 3.0 | ebourg
| New configurations implementing the "property list" format used in NeXT/OpenStep and its XML variant used in Mac OS X. (PropertyListConfiguration and XMLPropertyListConfiguration) Fixes CONFIGURATION-195. | ebourg
| Resolved some issues with XMLConfiguration and properties containing the delimiter character. These properties are now correctly treated, escaping the delimiter will work, too. Fixes CONFIGURATION-97. | oheger
| Added support for XMLPropertiesConfiguration in ConfigurationFactory. A < properties> element will generate a XMLPropertiesConfiguration if the filename ends with ".xml". | ebourg
| PropertiesConfiguration now supports escaped key/value separators in the keys (i.e foo\:key = bar). Fixes CONFIGURATION-184. | ebourg
| PropertiesConfiguration now supports all key/value separators supported by java.util.Properties ('=', ':' and white space characters). Fixes CONFIGURATION-166. | ebourg
| Commons Configuration now depends on Commons Lang 2.1 instead of 2.0 | ebourg
| Comment lines for PropertiesConfiguration can start with the '!' char (compatibility with java.util.Properties). Fixes CONFIGURATION-207. | ebourg
| Because ConfigurationUtils.copy() does not fully support hierarchical configurations a clone() method was added to HierarchicalConfiguration that can be used instead. Fixes CONFIGURATION-84. | oheger
| XMLConfiguration now provides some support for validating XML documents. With the setValidating() method DTD validation can be enabled. It is also possible to set a custom DocumentBuilder allowing a caller to perform enhanced configuration of the XML loading process. Fixes CONFIGURATION-206. | oheger
| AbstractFileConfiguration now always sets a valid base path if the configuration file could be located. This allows PropertiesConfiguration to resolve include files even when loaded from class path. Fixes CONFIGURATION-121. | oheger
| Updated XMLConfiguration to correctly deal with properties containing dots in their names. Such properties could not be accessed before. Fixes CONFIGURATION-85. | oheger
| PropertiesConfiguration's handling of backslash characters at the end of line was incorrect when there was an even number of trailing backslashes. This is now fixed. Fixes CONFIGURATION-9. | oheger
| Fixed a problem related to file based configurations that are loaded from a URL which is application/x-www-form-urlencoded: the save() method would store such files at a wrong location. Fixes CONFIGURATION-130. | oheger
| Updated FileChangedReloadingStrategy to use the file based configuration's source URL to find the file to watch. Before that it was possible that the strategy checked the wrong file. For configuration files loaded from a jar FileChangedReloadingStrategy now checks the jar file itself for changes. Finally a bug was fixed which caused the strategy to check the watched file's last change date on every invocation of its reloadingRequired() method ignoring its refresh delay. Thanks to Jorge Ferrer. Fixes CONFIGURATION-50. | oheger
| Fixed a bug in the collaboration between XMLConfiguration and its reloading strategy: The configuration did not check its reloading strategy, so no reload was performed. Fixes CONFIGURATION-62. | oheger
| Disabled auto save mode during PropertiesConfiguration.load(). Prior it was possible that the properties file to be loaded was immideately overwritten. Fixes CONFIGURATION-119. | oheger
| Under certain circumstances it was possible that a reloading strategy set for PropertiesConfiguration interferred with the save() method causing the configuration file to be erased. This has now been fixed. Fixes CONFIGURATION-89. | oheger
| AbstractFileConfiguration now stores the URL of the config file in the load() methods. This URL is reused by the save() method to ensure that the same file is written. Fixes CONFIGURATION-94. Thanks to Jamie M. Guillemette . | oheger
| XMLPropertiesConfiguration no longer depends on Digester to parse the configuration file, it's now implemented with a pure SAX parser. Thanks to Alistair Young . | ebourg
| Fixed a bug which causes XMLConfiguration.save to lose attribute values under some circumstances. The clear() method now also ensures that the associated DOM document is always cleared. Fixes CONFIGURATION-49. Thanks to Mi Zhang . | oheger
| XMLConfiguration now parse the configuration using the encoding declared in the XML header instead of the OS default encoding. Fixes CONFIGURATION-13. Thanks to Kunihara Tetsuya . | ebourg
| XMLConfiguration now uses the delimiter set by setDelimiter(char). Thanks to Zsolt Koppany . | ebourg

## Release 1.1 - 2005-04-02

Type | Changes | By
--- | --- | ---
| Fixed a ConcurrentModificationException thrown when calling clear() on a SubsetConfiguration applied to a BaseConfiguration. Fixes CONFIGURATION-134. | ebourg
| The resolveContainerStore() method in AbstractConfiguration now works properly with arrays of objects and arrays of primitives. This means it is possible to store an array of value in the configuration and retrieve the first element with the getString(), getInt()... methods. Fixes CONFIGURATION-81. | ebourg

## Release 1.1-rc2 - 2005-03-06

Type | Changes | By
--- | --- | ---
| Updated documentation for FileConfiguration's load() methods. Fixed a problem in XMLConfiguration with the output of the save() method when multiple files were loaded. Fixes CONFIGURATION-118. | oheger
| Fixed a bug in FileChangedReloadingStrategy preventing the detection of a file change in some cases. | ebourg
| Changed getXXXArray() and getXXXList() in DataConfiguration to return an empty array/list for empty values. | ebourg
| Fixed getLongArray(), getFloatArray() and getDoubleArray() in DataConfiguration, the values were cast into integers. Fixes CONFIGURATION-58. | ebourg

## Release 1.1-rc1 - 2005-02-13

Type | Changes | By
--- | --- | ---
| ConfigurationFactory now always configures digester to use the context classloader. This avoids problems in application server environments, which use their own version of digester. Thanks to Mike Colbert for the patch! Fixes CONFIGURATION-88. | oheger
| Added a new configuration, XMLPropertiesConfiguration, supporting the new XML format for java.util.Properties introduced in Java 1.5. A 1.5 runtime is not required to use this class. Fixes CONFIGURATION-148. | ebourg
| Added a comment header to PropertiesConfiguration. The header is not parsed when the file is loaded yet. Fixes CONFIGURATION-190. | ebourg
| Added the setEncoding(String) and the getEncoding() methods to the FileConfiguration interface to control the encoding of the configuration file. | ebourg
| Access to the top level element of the XML document is now provided. For newly created configurations this element can be changed before the document is written. Fixes CONFIGURATION-210. | oheger
| Merg ed the two XML related configuration classes into one new class XMLConfiguration. This new class should provide the best of its ancestors. Fixes CONFIGURATION-168. | oheger
| Replaced the PropertyTokenizer inner class in AbstractConfiguration with the split method in PropertyConverter. Also moved the method building an iterator on the elements of a composite value in PropertyConverter as toIterator(). | ebourg
| Some cleanup of the handling of the base path in file based configurations. The base path is now always taken into account. Fixes CONFIGURATION-15. | oheger
| Calling getProperties on a JNDIConfiguration no longer throws an UnsupportedOperationException. | ebourg
| Removed the getPropertyDirect method from AbstractConfiguration, concrete configurations now implement directly the getProperty method from the Configuration interface. | ebourg
| Added implementation of a save() method for HierarchicalXMLConfiguration. Fixes CONFIGURATION-187. | oheger
| Constructing a file based configuration with a File no longer throws an exception when the file doesn't exist. | ebourg
| Saving a configuration now creates the path to the file if it doesn't exist. | ebourg
| AbstractFileConfiguration.save(File) no longer fails silently when an error occurs, a ConfigurationException is thrown instead. Fixes CONFIGURATION-45. | ebourg
| ConfigurationUtils.locate() now checks if the URL based resources exist. This fixes a bug preventing c onfiguration files from being found if the configuration descriptor is in a JAR file (reported by Grant Ingersoll). | ebourg
| Fixed NPE that were caused in the constructors of file based configurations if an invalid file name was specified. Fixes CONFIGURATION-96. | oheger
| Added support for optional configuration sources in definition files for ConfigurationFactory. A new optional attribute allows to specify whether a configuration source is mandatory or optional. Fixes CONFIGURATION-162. | oheger
| JNDIConfiguration.getKeys() now returns an empty iterator instead of throwing a ConfigurationRuntimeException when a NamingException occurs. The NamingExceptions are now logged. | ebourg
| DatabaseConfiguration.isEmpty() now returns true if an SQLException occurs. | ebourg
| Added two methods copy(Configuration, Configuration) and append(Configuration, Configuration) in ConfigurationUtils to copy properties between configurations. | ebourg
| Moved the constructors implementations from PropertiesConfiguration and XMLConfiguration to AbstractFileConfiguration. | ebourg
| Remove deprecated getVector() implementations. | epugh
| File based configurations can now be automatically reloaded when the underlying file is modified. Fixes CONFIGURATION-147. | ebourg
| Added a clear() method to the Configuration interface to remove all properties. Fixes CONFIGURATION-156. | ebourg
| Added a SystemConfiguration wrapping the system properties. ConfigurationFactory recognizes the corresponding < system/ > element. Fixes CONFIGURATION-208. | ebourg
| Added a MapConfiguration to turn any Map into a Configuration. The getConfiguration() methods in ConfigurationConverter now use MapConfiguration, as a result the Configuration returned is always synchronized with the underlying Properties or ExtendedProperties, changes made to the Configuration are available in the Properties, and reciprocally. | ebourg
| The "autoSave" feature of XMLConfiguration has been generalized to all file based configurations. Fixes CONFIGURATION-146. | ebourg
| Numeric properties can now be specified in hexadecimal format, for example "number = 0xC5F0". Fixes CONFIGURATION-191. | ebourg
| Fixed HierarchicalConfiguration.getKeys(String), it returned an empty iterator if the prefix string contained indices. Fixes CONFIGURATION-36. | oheger
| Added a DataConfiguration decorator providing getters for all useful types found in a configuration (URL, Locale, Date, Calendar, Color, lists and arrays) | ebourg
| Added 5 new configurations to be used in a web environment: AppletConfiguration, ServletConfiguration, ServletContextConfiguration, ServletRequestConfiguration, ServletFilterConfiguration. | ebourg

## Release 1.0 - 2004-10-11

Type | Changes | By
--- | --- | ---
| The getStringArray() method in CompositeConfiguration now interpolates the strings. Fixes CONFIGURATION-66. | ebourg
| SubsetConfiguration now shares the "throwExceptionOnMissing" property with its parent. Fixes CONFIGURATION-23. | ebourg
| Removed "file:" at the beginning of the base path when calling setFile() on a FileConfiguration. This prevented auto saving an XMLConfiguration loaded from a File (issue reported by Mark Roth). | ebourg
| All NamingEnumerations in JNDIConfiguraiton are now properly closed (Suggested by Eric Jung). | ebourg
| Properties added to an XMLConfiguration are no longer duplicated in the resulting XML file. Fixes CONFIGURATION-90. | ebourg

## Release 1.0-rc2 - 2004-09-24

Type | Changes | By
--- | --- | ---
| Unified the mechanisms for loading and saving file based configurations. PropertiesConfiguration, XMLConfiguration and HierarchicalXMLConfiguration now implement the same FileConfiguration interface. BasePathLoader, BasePathConfiguration, ClassPropertiesConfiguration and BasePropertiesConfiguration have been removed. | ebourg
| Replaced the calls to Boolean.booleanValue(boolean) in AbstractConfiguration and ConfigurationDynaBean to be Java 1.3 compatible. Fixes CONFIGURATION-22. | ebourg
| Changing the prefix of a JNDIConfiguration will now reset the base context used. Fixes CONFIGURATION-112. | ebourg
| The context used by JNDIConfiguration can be specified in its constructor or through the setContext() method. The context can be accessed with the getContext() method which is now public. Thanks to Eric Jung . | ebourg
| Make the behaviour on missing properties for the get methods that return objects configurable. A property `throwExceptionOnMissing`can be set and then the getters throw an `NoSuchElementException`. The old default behaviour of returning a `null`value has been restored. | henning
| Allow configurations extending AbstractConfiguration to change the delimiter used from "," to something else. Fixes CONFIGURATION-151. | epugh
| PropertiesConfiguration.save() method has issues with preserving the filename | epugh
| Test cases for HierarchicalConfigurationXMLReader stores comments as text nodes. Fixes CONFIGURATION-132. Thanks to Mark Woodman . | epugh
| Clarify for ConfigurationDynaBean that the get method should throw an illegalArgumentException if there is no property specified. Fixes CONFIGURATION-183. Thanks to Ricardo Gladwell . | epugh
| Fixed a ClassCastException when adding a non String property to an XMLConfiguration. Fixes CONFIGURATION-25. | ebourg
| Fixed the handling of attribute properties by HierarchicalConfigurationConverter. Fixes CONFIGURATION-138. Thanks to Oliver Heger . | ebourg
| Fixed a ClassCastException thrown on adding a non string property in a DatabaseConfiguration. Fixes CONFIGURATION-125. | ebourg
| Bring back the getVector() methods in the Configuration interface. These methods are needed for " drop-on " replacement of the various pre-1.0 commons-configuration snapshots and are already deprecated. These metho ds will be removed for 1.1. | henning

## Release 1.0-rc1 - 2004-08-14

Type | Changes | By
--- | --- | ---
| HierarchicalConfigurationXMLReader stores comments as text nodes. Fixes CONFIGURATION-132. Thanks to Oliver Heger . | epugh
| project.xml contains bad dependencies. Fixes CONFIGURATION-122. Thanks to Ricardo Gladwell . | epugh
| clearXmlProperty doesn't remove list properties completely. Fixes CONFIGURATION-64. Thanks to Brent Worden . | epugh
| new ConfigurationDynaBean. Fixes CONFIGURATION-183. Thanks to Ricardo Gladwell . | epugh
| new ConfigurationMap and ConfigurationSet. Fixes CONFIGURATION-185. Thanks to Ricardo Gladwell . | epugh
| Problem adding property XMLConfiguration. Fixes CONFIGURATION-91. Thanks to Ricardo Gladwell . | epugh
| ConfigurationXMLDocument removed until post 1.0. | epugh
| DatabaseConfiguration doesn't support List properties. Fixes CONFIGURATION-18. | epugh
| Fixed several bugs related to XMLConfiguration: Can't add a new property as an attribute in XMLConfiguration XMLConfiguration doesn't support attribute names with a dot XMLConfiguration doesn't ignore comments XMLConfiguration.save() doesn't escape reserved characters | ebourg
| Added save methods in XMLConfiguration similar to PropertiesConfiguration to save the configuration to another file. Fixes CONFIGURATION-114. | ebourg
| Removed the DOM4J implementations in favor of the DOM ones. DOMConfiguration has been renamed to XMLConfiguration, and HierarchicalDOMConfiguration to HierarchicalXMLConfiguration. The elements parsed by the ConfigurationFactory have been changed accordingly. | ebourg
| Added a save() method to PropertiesConfiguration and save(Writer out), save(OutputStream out), save(OutputStream out, String encoding) to BasePropertiesConfiguration. | ebourg
| List values are now properly stored as comma separated values in the Properties object returned by ConfigurationConverter.getProperties() Fixes CONFIGURATION-98. | ebourg
| Introduced a ConversionException thrown when the value of a property is not compatible the type requested. It replaces the ClassCastException and the NumberFormatException thrown previously. | ebourg
| Tokens like ${ref} in a PropertyConfiguration are now properly saved. Fixes CONFIGURATION-174. | ebourg
| The getList() method of a CompositeConfiguration now returns the list composed of the elements in the first matching configuration and the additional elements found in the in memory configuration. Fixes CONFIGURATION-127. | ebourg
| SubsetConfiguration returns a List on getList(). AbstractConfiguration wouldn't properly deal with a List, only with a Container for getList()! Thanks to jschaible for the unit test. | epugh
| Direct support of XML via DOM. New classes DOMConfiguration and HierarchicalDOMConfiguration. | jschaible
| Update build to not include test configuration files in resulting jar. | jschaible
| Refactored JNDIConfiguration to use AbstractConfiguration. | ebourg
| Fixed invalid subsets by refactoring out the subset logic into a SubsetConfiguration. Fixes CONFIGURATION-76. | ebourg
| Reapply the ConfigurationXMLDocument that went missing during migration out of sandbox. | oheger
| Apply ASL 2.0 license. Thanks to Jeff Painter for scripting the conversion! | epugh
| Changed CompositeConfiguration to extend from AbstractConfiuration. This means that the behavior of CompositeConfiguration is much similar to others like PropertiesConfiguration in handling of missing keys, interpolation, etc.. Previously CompositeConfiguration had quite a few differences. | epugh
| Removed "defaults" from BaseConfiguration. Defaults are now done via using a CompositeConfiguration, either directly or via a ConfigurationFactory. if you want to save changes made to a Configuration, then you use a CompositeConfiguration and get back the inMemoryConfiguration that has the delta of changes. Added a bit of documentation on this. | epugh
| Enhancement: Configuration Comparator. Fixes CONFIGURATION-154. | epugh
| BaseConfiguration: containsKey ignores default properties. I have changed it so that now the defaults are paid attention to. Fixes CONFIGURATION-54. | epugh
| The Configuration interface now supports BigDecimal and BigInteger numbers. | ebourg
| ConfigurationException is now thrown by public methods instead of Exception or IOException or whatnot. | epugh
| For configuration based on properties files, allow characters like \n etc to be escaped and unescaped. | ebourg
| New DatabaseConfiguration that uses a database to store the properties. It supports 2 table structures : one table per configuration (2 colums key/value) one table for multiple configurations (2 columns key/value + 1 column for the name of the configuration) | ebourg
| ConfigurationFactory now supports the hierarchicalDom4j element in configuration definition file | oheger
| Change all Vector objects to List objects. | ebourg
| ConfigurationFactory now supports two types of properties files, additional and override. Additional properties add each other together. Override override each other. This allows you to have a single property that is either aggregated from a number of sources, or have a property that is overridden according to a specific order of sources. | oheger
| AbstractConfiguration addProperty now delegates to an abstract addPropertyDirect implemented by BaseConfiguration. | oheger
| Changed getString() method to throw a NoSuchElementException instead of "" if the configuration property doesn't exist. | kshaposhnikov
| Added AbstractConfiguration to make it easier to create subclasses by only having to implement the methods required. | kshaposhnikov
| ClassPropertiesConfiguration Additions Use the classloader of class that is provided by the constructor. Add a constructor that indicates whether to use relative or absolute. Change getPropertyStream to utilize the relative or absolute flag. Add a test case that checks that absolute paths work. | bdunbar
| JNDIConfiguration.getKeys() AdditionThe JNDIConfiguration.getKeys() method was returning an unsupported operation error. However, this is an important method to have supported. | epugh
| CompositeConfiguration.getKeys() FixThe CompositeConfiguration.getKeys() method was returning an unordered list of configuration values. However, many apps expect the order that keys are returned to be the order they are added into the properties file. | epugh