Apache Commons logo Commons Configuration

Apache Commons Configuration Release Notes

Release History

Version Date Description
2.11.0 2024-06-07 Minor release with new features and updated dependencies; requires Java 8 or above.
2.10.1 2024-03-17 Minor release with new features and updated dependencies; requires Java 8 or above.
2.10.0 2024-03-06 Minor release with new features and updated dependencies; requires Java 8 or above.
2.9.0 2023-03-25 Minor release with new features and updated dependencies; requires Java 8 or above.
2.8.0 2022-07-05 Minor release with new features and updated dependencies; requires Java 8 or above.
2.7 2020-03-07 Minor release with new features and updated dependencies; requires Java 8 or above.
2.6 2019-09-13 Minor release with new features and updated dependencies; requires Java 8 or above.
2.5 2019-05-23 Minor release with new features and updated dependencies; requires Java 8 or above.
2.4 2018-10-23 Minor release with new features and updated dependencies; requires Java 8 or above.
2.3 2018-08-04 Minor release with new features and updated dependencies; requires Java 7 or above.
2.2 2017-10-12 Minor release with new APIs and bug fixes.
2.1.1 2017-02-05 Bugfix release for 2.1
2.1 2016-08-20 First maintenance release for Configuration 2.x.
2.0 2016-03-24 Major redesign of the Configuration 1.x API
2.0-beta2 2015-12-05 Second beta release, some minor API changes.
2.0-beta1 2015-06-19 First beta release, getting closer to final.
2.0-alpha2 2014-12-20 Some more API fine-tuning.
2.0-alpha1 2014-09-23 First alpha release after a major redesign.
1.10 2013-10-27 Minor bug fixes and improvements
1.9 2012-08-22 Minor bug fixes and improvements
1.8 2012-02-04 Support for Java 1.5
1.7 2011-09-07 Many bugfixes, some new features.
1.6 2008-12-25 Another set of smaller bug fixes
1.5 2007-11-24 Many smaller bugfixes
1.4 2007-04-08 Improved interpolation, configuration for INI files, reloading strategy triggered with JMX, bug fixes.
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 First official release
1.0-rc2 2004-09-24  
1.0-rc1 2004-08-14  

Release 2.11.0 – 2024-06-07

Type Changes By
Add Add support for empty sections #408. Fixes CONFIGURATION-844. Thanks to Thomas Steiner, Gary Gregory. ggregory
Add Add ImmutableConfiguration.containsValue(Object). Thanks to Rikkarth, Gary Gregory. ggregory
Fix Fail-fast with a NullPointerException if DataConfiguration.DataConfiguration(Configuration) is called with null. Thanks to Gary Gregory. ggregory
Fix Fail-fast with a NullPointerException if XMLPropertiesConfiguration.XMLPropertiesConfiguration(Element) is called with null. Thanks to Gary Gregory. ggregory
Fix Fail-fast with a NullPointerException if a SubsetConfiguration constructor is called with a null Configuration. Thanks to Gary Gregory. ggregory
Fix Methods should not be empty #393. Fixes CONFIGURATION-843. Thanks to Gary Gregory. ggregory
Fix Guard MapConfiguration against null maps #381. Thanks to Heewon Lee, Gary Gregory. ggregory
Fix Fail-fast with a NullPointerException if AppletConfiguration(Applet) is called with null. Thanks to Gary Gregory. ggregory
Fix Fail-fast with a NullPointerException if ServletConfiguration(Servlet) is called with null. Thanks to Gary Gregory. ggregory
Fix Fail-fast with a NullPointerException if ServletConfiguration(ServletConfig) is called with null. Thanks to Gary Gregory. ggregory
Fix Fail-fast with a NullPointerException if ServletContextConfiguration(Servlet) is called with null. Thanks to Gary Gregory. ggregory
Fix Fail-fast with a NullPointerException if ServletContextConfiguration(ServletContext) is called with null. Thanks to Gary Gregory. ggregory
Fix Fail-fast with a NullPointerException if ServletFilterConfiguration(FilterConfig) is called with null. Thanks to Gary Gregory. ggregory
Fix Fail-fast with a NullPointerException if ServletRequestConfiguration(ServletRequest) is called with null. Thanks to Gary Gregory. ggregory
Fix Deprecate DatabaseConfiguration.getDatasource() in favor of getDataSource(). Thanks to Gary Gregory. ggregory
Fix Fix PMD DynamicCombinedConfiguration in AbstractImmutableNodeHandler. Thanks to Gary Gregory. ggregory
Fix Fix PMD DynamicCombinedConfiguration in AbstractListDelimiterHandler. Thanks to Gary Gregory. ggregory
Fix Fix PMD DynamicCombinedConfiguration in DefaultPrefixLookupsHolder. Thanks to Gary Gregory. ggregory
Fix Fix PMD DynamicCombinedConfiguration in DynamicCombinedConfiguration. Thanks to Gary Gregory. ggregory
Fix Fix PMD DynamicCombinedConfiguration in PropertiesConfiguration. Thanks to Gary Gregory. ggregory
Fix Restore previous behavior allowing Spring to inject multiple values #425. Fixes CONFIGURATION-846. Thanks to Andrea Bollini, Gary Gregory, Tim Donohue, kbarlowgw. ggregory
Fix Property with an empty string value was not processed #431. Fixes CONFIGURATION-847. Thanks to Andrea Bollini, Gary Gregory, Tim Donohue, kbarlowgw. ggregory
Update Bump commons-logging:commons-logging from 1.3.0 to 1.3.2 #390, #418. Thanks to Dependabot. ggregory
Update Bump commons-io:commons-io from 2.15.1 to 2.16.1 #394, #400. Thanks to Dependabot. ggregory
Update Bump org.apache.commons:commons-parent from 67 to 70 #396. Thanks to Dependabot. ggregory
Update Bump slf4j.version from 2.0.12 to 2.0.13 #403. Thanks to Dependabot. ggregory
Update Bump org.apache.commons:commons-text from 1.11.0 to 1.12.0 #404. Thanks to Dependabot. ggregory
Update Bump spring.version from 5.3.33 to 5.3.35 #424. Thanks to Gary Gregory. ggregory
Update Bump commons-codec:commons-codec from 1.16.1 to 1.17.0. Thanks to Gary Gregory. ggregory
Update Bump com.fasterxml.jackson.core:jackson-databind from 2.17.0 to 2.17.1 #417. Thanks to Gary Gregory. ggregory

Release 2.10.1 – 2024-03-17

Type Changes By
Fix java.lang.module.FindException: Module servlet.api not found. Fixes CONFIGURATION-839. Thanks to Bob Marinier, Gary Gregory. ggregory
Fix StackOverflowError adding property in AbstractListDelimiterHandler.flattenIterator(). Fixes CONFIGURATION-840. Thanks to Bob Marinier, Gary Gregory. ggregory
Fix StackOverflowError calling ListDelimiterHandler.flatten(Object, int) with a cyclical object tree. Fixes CONFIGURATION-841. Thanks to Gary Gregory. ggregory
Update Bump jackson-databind from 2.16.1 to 2.17.0 #378. Thanks to Dependabot. ggregory
Update Bump log4j.version from 2.23.0 to 2.23.1 #379. Thanks to Dependabot. ggregory
Update Bump spring.version from 5.3.32 to 5.3.33 #380. Thanks to Dependabot, Gary Gregory. ggregory

Release 2.10.0 – 2024-03-06

Type Changes By
Fix [StepSecurity] ci: Harden GitHub Actions #307. Thanks to step-security-bot, Gary Gregory. ggregory
Fix ConfirgurationPropertySource doesn't supply resolved values #309. Fixes CONFIGURATION-834. Thanks to Keith Barlow, Gary Gregory. ggregory
Fix Take prefix delimiter into account when SubsetConfiguration.getKeysInternal() is called #300. Thanks to KeijoB, Gary Gregory. ggregory
Fix Guard ConfigurationMap against null configuration #355. Thanks to Heewon Lee, Gary Gregory. ggregory
Fix Properties parser stack overflows on large single-key inputs #369. Fixes CONFIGURATION-838. Thanks to Ian Lynagh. ggregory
Fix DatabaseConfiguration.AbstractJdbcOperation.execute() throws NullPointerException when no data source is set #368. Thanks to Heewon Lee, Gary Gregory. ggregory
Add Add AbstractConfiguration.getKeysInternal(String, String) #300. Thanks to KeijoB, Gary Gregory. ggregory
Add Add ImmutableConfiguration.getKeys(String, String) #300. Thanks to KeijoB, Gary Gregory. ggregory
Add Add PrefixedKeysIterator.PrefixedKeysIterator(Iterator<String%gt;, String, String) #300. Thanks to KeijoB, Gary Gregory. ggregory
Add Add Maven property project.build.outputTimestamp for build reproducibility. Thanks to Gary Gregory. ggregory
Add Guard PatternSubtreeConfigurationWrapper constructor against null #365. Thanks to Heewon Lee. ggregory
Update Bump jackson-databind from 2.14.2 to 2.16.1 #297, #303, #326, #331, #340. Thanks to Dependabot. ggregory
Update Bump commons-io:commons-io from 2.11.0 to 2.15.1. Thanks to Gary Gregory. ggregory
Update Bump spring-* from 5.3.26 to 5.3.32. Thanks to Gary Gregory. ggregory
Update Bump commons-parent from 57 to 67. Thanks to Gary Gregory. ggregory
Update Bump commons-codec:commons-codec from 1.15 to 1.16.1. Thanks to Gary Gregory. ggregory
Update Bump commons-lang3 from 3.11 to 3.14.0. Thanks to Gary Gregory. ggregory
Update Bump org.yaml:snakeyaml from 2.0 to 2.2 #312, #315. Thanks to Dependabot. ggregory
Update Bump slf4j.version from 2.0.7 to 2.0.12 #358. Thanks to Dependabot. ggregory
Update Bump org.apache.commons:commons-dbcp2 from 2.9.0 to 2.12.0. Thanks to Gary Gregory. ggregory
Update Bump org.apache.commons:commons-pool2 from 2.11.1 to 2.12.0. Thanks to Gary Gregory. ggregory
Update Bump org.apache.logging.log4j:log4j-1.2-* from 2.20.0 to 2.23.0 #334, #339, #367. Thanks to Gary Gregory, Dependabot. ggregory
Update Bump org.apache.commons:commons-text from 1.10.0 to 1.11.0. Thanks to Gary Gregory. ggregory
Update Bump commons-logging:commons-logging from 1.2 to 1.3.0. Thanks to Gary Gregory. ggregory

Release 2.9.0 – 2023-03-25

Type Changes By
Fix CombinedConfiguration#getKeys() can throw NoSuchElementException. Fixes CONFIGURATION-799. Thanks to Jarek Sacha, Gary Gregory. ggregory
Fix Fix ambiguity on the section determining #229. Fixes CONFIGURATION-822. Thanks to Branislav Beňo, Gary Gregory, Bruno P. Kinoshita. ggregory
Fix Use Java style array decelerations #244. Thanks to Arturo Bernal. ggregory
Add Add DefaultConversionHandler#setListDelimiterHandler(ListDelimiterHandler). Fixes CONFIGURATION-799. Thanks to Xinshiyou, Gary Gregory. ggregory
Fix Add ImmutableNode.stream(). Thanks to Gary Gregory. ggregory
Fix Avoid NullPointerException in org.apache.commons.configuration2.web.AppletConfiguration.getKeysInternal(). Thanks to Gary Gregory. ggregory
Fix Fix JDBC prepared statements leak in org.apache.commons.configuration2.DatabaseConfiguration.clearPropertyDirect(String). Thanks to Gary Gregory. ggregory
Update Bump actions/cache from 3.0.8 to 3.0.10 #223, #225. Thanks to Dependabot. kinow
Update Bump actions/checkout from 3 to 3.1.0 #224. Thanks to Gary Gregory, Dependabot. ggregory
Update Bump actions/setup-java from 3 to 3.5.1. Thanks to Gary Gregory. ggregory
Update Bump optional Apache Log4j 1.2.17 with 2.20.0. Fixes CONFIGURATION-815. Thanks to Gary Gregory. ggregory
Update Bump spotbugs-maven-plugin from 4.7.0.0 to 4.7.3.0 #193, #195, #228, #237. Thanks to Dependabot, Gary Gregory. ggregory
Update Bump spotbugs from 4.7.0 to 4.7.3. Thanks to Gary Gregory. ggregory
Update Bump org.springframework:spring-* from 5.3.21 to 5.3.26. Thanks to Dependabot, Gary Gregory. ggregory
Update Bump junit-jupiter from 5.8.2 to 5.9.1 #197, #217. Thanks to Dependabot. kinow
Update Bump mockito-core from 4.6.1 to 4.11.0 #200, #235, #249, #257, #259. Thanks to Dependabot, Gary Gregory. kinow
Update Bump slf4j.version from 1.7.36 to 2.0.7 #202, #210, #215, #238, #241, #291. Thanks to Dependabot. kinow
Update Bump maven-checkstyle-plugin from 3.1.2 to 3.2.0 #201. Thanks to Dependabot. kinow
Update Bump maven-javadoc-plugin from 3.4.0 to 3.4.1. Thanks to Gary Gregory. ggregory
Update Bump maven-pmd-plugin 3.17.0 to 3.19.0. Thanks to Gary Gregory. ggregory
Update Bump pmd from 6.47.0 to 6.53.0. Thanks to Gary Gregory. ggregory
Update Bump snakeyaml from 1.30 to 2.0 #203, #212, #219, #282, #283. Thanks to Dependabot, strangelookingnerd. kinow
Update Bump jackson-databind from 2.13.3 to 2.14.2 #227, #246, #274. Thanks to Gary Gregory. kinow
Update Bump spring.version from 5.3.22 to 5.3.23 #211. Thanks to Dependabot. kinow
Update Bump commons-parent from 53 to 57 #216, #253, #299. Thanks to Dependabot, Gary Gregory. kinow
Update Bump log4j.version from 2.18.0 to 2.20.0 #213, #281. Thanks to Dependabot. kinow
Update Bump japicmp-maven-plugin from 0.15.7 to 0.17.1. Thanks to Gary Gregory. ggregory
Update Bump commons-text from 1.9 to 1.10.0 #221. Thanks to Dependabot. kinow

Release 2.8.0 – 2022-07-05

Type Changes By
Fix Make interpolation of collections and arrays in ConfigurationInterpolator consistent with behavior of DefaultConversionHandler. Add ConfigurationInterpolator.setStringConverter to allow customized string conversion behavior. Fixes CONFIGURATION-753. mattjuntunen
Fix Computation of blank lines after header comment #82. Fixes CONFIGURATION-795. Thanks to dpeger. ggregory
Fix Remove redundant initializer #110. Fixes CONFIGURATION-801. Thanks to Arturo Bernal. ggregory
Fix Use final #111. Fixes CONFIGURATION-802. Thanks to Arturo Bernal. ggregory
Fix Java 8 lambda improvements and more #112. Fixes CONFIGURATION-803. Thanks to Arturo Bernal. ggregory
Fix Redundant local variable #113. Fixes CONFIGURATION-804. Thanks to Arturo Bernal. ggregory
Fix Use try with resource #114. Fixes CONFIGURATION-805. Thanks to Arturo Bernal. ggregory
Fix [Javadoc] Specify that typed getList returns null for missing key #100. Fixes CONFIGURATION-805. Thanks to Roman Zaynetdinov. ggregory
Fix Mention EnvironmentConfiguration in the list of configuration sources #45. Thanks to Oliver B. Fischer. ggregory
Fix DefaultListDelimiterHandler.escapeList working only for List>String< #137. Fixes CONFIGURATION-808. Thanks to cigaly. ggregory
Fix Use final #141. Thanks to Arturo Bernal. ggregory
Fix Replace test asserts by simpler but equivalent calls. #139 Thanks to Arturo Bernal. ggregory
Fix Single Variable Interpolation #182. Fixes CONFIGURATION-764. Thanks to Ning Zhang, Matt Juntunen, Bruno P. Kinoshita, Gary Gregory. ggregory
Fix Implement proper concurrency in ConstantLookup. Thanks to Gary Gregory. ggregory
Fix Support new namespace jakarta.mail.* used by javamail 2.0+ (first release October 2020) #186. Fixes CONFIGURATION-813. Thanks to Dependabot. kinow
Add Implement Iterable in ImmutableNode #74. Thanks to SethiPandi. ggregory
Update Unclosed file handle when reading config from JAR file URL. Add and use FileBasedBuilderProperties.setURL(URL, URLConnectionOptions). Fixes CONFIGURATION-794. Thanks to Robin Jansohn, Gary Gregory, Rob Spoor. ggregory
Add Add PropertiesConfigurationLayout.getBlankLinesBefore() and deprecate getBlancLinesBefore(). Thanks to Gary Gregory. ggregory
Add Add PropertiesConfigurationLayout.setBlankLinesBefore() and deprecate setBlancLinesBefore(). Thanks to Gary Gregory. ggregory
Add Add PropertiesConfigurationLayout.PropertyLayoutData.getBlankLines() and deprecate getBlancLines(). Thanks to Gary Gregory. ggregory
Add Add PropertiesConfigurationLayout.PropertyLayoutData.setBlankLines() and deprecate setBlancLines(). Thanks to Gary Gregory. ggregory
Add Add ImmutableConfiguration.getEnum() methods. Fixes CONFIGURATION-789. Thanks to Gary Gregory. ggregory
Add Add ImmutableConfiguration.getDuration() methods. Fixes CONFIGURATION-789. Thanks to Gary Gregory. ggregory
Update Make default interpolation prefix lookups configurable via system property. Remove dns, url, and script lookups from defaults. If these lookups are required for use in AbstractConfiguration subclasses, they must be enabled via system property. See ConfigurationInterpolator.getDefaultPrefixLookups() for details. mattjuntunen
Update Bump actions/cache from 2 to 3.0.4 #99, #151, #169. Thanks to Dependabot, Gary Gregory. ggregory
Update Bump actions/checkout from 1 to 3 #47, #62, #70, #85, #150, #163. Thanks to Dependabot. ggregory
Update Bump actions/setup-java from 1.4.0 to 3 #63, #65, #73, #174. Thanks to Dependabot, Gary Gregory. ggregory
Update Bump codeql-action from v1 to v2. Thanks to Dependabot, Matt Juntunen. mattjuntunen
Update Bump Spring dependency versions: org.springframework:spring-beans 4.3.26.RELEASE -> 5.3.21 org.springframework:spring-context 4.3.26.RELEASE -> 5.3.21 org.springframework:spring-core 4.3.26.RELEASE -> 5.3.21 org.springframework:spring-test 4.3.26.RELEASE -> 5.3.21 #165, #172 Thanks to Dependabot, Matt Juntunen, kinow, Gary Gregory. mattjuntunen
Update Bump commons-parent from 52 to 53. Thanks to Dependabot, Matt Juntunen. mattjuntunen
Update Bump Apache Commons Lang from 3.9 to 3.12.0. Fixes CONFIGURATION-787. Thanks to Gary Gregory. ggregory
Update Bump com.fasterxml.jackson.core:jackson-databind from 2.10.3 to 2.13.3, #60. Fixes CONFIGURATION-790. Thanks to Gary Gregory, Dependabot. ggregory
Update Bump Slf4j test dependencies: org.slf4j:slf4j-api 1.7.26 -> 1.7.33, org.slf4j:slf4j-ext 1.7.26 -> 1.7.33, org.slf4j:slf4j-log4j12 1.7.26 -> 1.7.33, org.slf4j:slf4j-nop 1.7.26 -> 1.7.33. Thanks to Gary Gregory. ggregory
Update Bump commons-parent from 50 to 52. Thanks to Dependabot. ggregory
Update Bump mailapi from 1.6.4 to 1.6.7 #48. Thanks to Dependabot, Gary Gregory. ggregory
Update Bump spotbugs-maven-plugin from 3.1.12.2 to 4.7.0.0, #55, #75, #79, #93, #116, #183. Thanks to Dependabot, Gary Gregory. ggregory
Update Bump hsqldb from 2.5.0 to 2.5.2 #54, #128. Thanks to Dependabot. ggregory
Update Bump commons-text from 1.8 to 1.9. Thanks to Gary Gregory. ggregory
Update Bump servlet-api from 2.4 to 2.5 #58. Thanks to Gary Gregory. ggregory
Update Bump maven-checkstyle-plugin from 3.1.0 to 3.1.2, #57, #97. Thanks to Gary Gregory. ggregory
Update Bump commons-pool2 from 2.8.0 to 2.10.0, #61, #124. Thanks to Dependabot, Gary Gregory. ggregory
Update Bump optional commons-codec from 1.14 to 1.15. Thanks to Gary Gregory. ggregory
Update Bump checkstyle from 8.26 to 9.3, #66, #71, #90, #101, #118, #121, #132, #155. Thanks to Dependabot, Gary Gregory. ggregory
Update Bump commons.jacoco.version 0.8.5 to 0.8.8 (Fixes Java 15 builds). Thanks to Gary Gregory. ggregory
Update Bump tests from commons-pool2 2.10.0 to 2.11.1. Thanks to Gary Gregory. ggregory
Update Bump tests from commons-dbcp2 2.7.0 to 2.9.0. Thanks to Gary Gregory. ggregory
Update Bump snakeyaml from 1.26 to 1.30 #68, #126, #137. Thanks to Dependabot, Gary Gregory. ggregory
Update Bump commons.japicmp.version from 0.14.1 to 0.15.7. Thanks to Gary Gregory. ggregory
Update Bump junit from 4.13 to 4.13.2 #78. Thanks to Dependabot, Gary Gregory. ggregory
Update Bump Apache Commons VFS 2.6.0 -> 2.9.0. Thanks to Gary Gregory. ggregory
Update Bump jackson-databind from 2.11.3 to 2.13.2.2 ,#88, #94, #127, #159, #168, #173. Thanks to Dependabot. ggregory
Update Bump commons.animal-sniffer.version 1.19 -> 1.20. Thanks to Gary Gregory. ggregory
Update Bump commons.javadoc.version from 3.1.1 to 3.4.0. Thanks to Gary Gregory. ggregory
Update Bump org.dbunit:dbunit from 2.7.0 to 2.7.3, #167. Thanks to Gary Gregory, Dependabot. ggregory
Update Bump tests to hamcrest v2.2 #143. Thanks to John Patrick. ggregory
Update Bump slf4j.version from 1.7.33 to 1.7.36 #166. Thanks to Dependabot. ggregory
Update Bump mailapi from 1.6.6 to 2.0.1 #186. Thanks to Dependabot. kinow
Update Use GitHub Actions setup-java Maven cache property #190. Thanks to sullis. kinow

Release 2.7 – 2020-03-07

Type Changes By
Fix Single argument DataConfiguration APIs always create empty arrays. Fixes CONFIGURATION-761. Thanks to Gary Gregory. ggregory
Update Use variable arguments. Fixes CONFIGURATION-762. Thanks to Gary Gregory. ggregory
Update Bump com.puppycrawl.tools:checkstyle from 8.24 to 8.25. Thanks to Gary Gregory. ggregory
Update Bump com.fasterxml.jackson.core:jackson-databind from 2.9.9 to 2.10.0. Fixes CONFIGURATION-763. Thanks to Gary Gregory. ggregory
Add Refactor XMLConfiguration.write(Writer) to add XMLConfiguration.write(Writer, Transformer). Fixes CONFIGURATION-765. Thanks to Gary Gregory. ggregory
Fix NullPointerException in XMLConfiguration#createTransformer() when no FileLocator is set. Fixes CONFIGURATION-767. Thanks to Gary Gregory. ggregory
Fix XMLConfiguration#write does not indent XML elements. Fixes CONFIGURATION-768. Thanks to Gary Gregory. ggregory
Fix Bump com.fasterxml.jackson.core:jackson-databind 2.10.0 -> 2.10.1. Fixes CONFIGURATION-771. Thanks to Gary Gregory. ggregory
Update [test] org.easymock:easymock 4.0.2 -> 4.1. Thanks to Gary Gregory. ggregory
Fix User's Guide > Properties files > Saving - small documentation bugs #41. Fixes CONFIGURATION-773. Thanks to Dan Dragut. ggregory
Update Bump Apache Commons VFS from 2.4.1 to 2.5.0. Fixes CONFIGURATION-775. Thanks to Gary Gregory. ggregory
Update Bump Apache Commons VFS from 2.5.0 to 2.6.0. Fixes CONFIGURATION-777. Thanks to Gary Gregory. ggregory
Update Bump optional Apache Commons Codec from 1.13 to 1.14. Fixes CONFIGURATION-778. Thanks to Gary Gregory. ggregory
Update Bump tests from JUnit 4.12 to 4.13. Thanks to Gary Gregory. ggregory
Update Bump optional jackson-databind from 2.10.1 to 2.10.2. Fixes CONFIGURATION-779. Thanks to Gary Gregory. ggregory
Update Bump com.fasterxml.jackson.core:jackson-databind from 2.10.2 to 2.10.3. Fixes CONFIGURATION-783. Thanks to Gary Gregory. ggregory
Update Update org.yaml:snakeyaml from 1.25 to 1.26 and tweak parser configuration. Fixes CONFIGURATION-784. Thanks to Gary Gregory. ggregory
Update Bump org.springframework:spring-* from 4.3.25.RELEASE to 4.3.26.RELEASE. Fixes CONFIGURATION-785. Thanks to Gary Gregory. ggregory
Update Bump org.apache.commons:commons-parent from 48 to 50 Thanks to Rob Tompkins. chtompki

Release 2.6 – 2019-09-13

Type Changes By
Fix XMLPropertyListConfiguration cannot set arrays in the correct plist form. Fixes CONFIGURATION-750. Thanks to Jason Pickens, Gary Gregory, Emmanuel Bourg. ggregory
Update Bump Apache Commons Text from 1.6 to 1.7. Fixes CONFIGURATION-751. Thanks to Gary Gregory. ggregory
Update Bump Apache Commons VFS from 2.3 to 2.4.1. Fixes CONFIGURATION-752. Thanks to Gary Gregory. ggregory
Update Bump Apache Commons Text from 1.7 to 1.8. Fixes CONFIGURATION-754. Thanks to Gary Gregory. ggregory
Fix Fix Javadoc for org.apache.commons.configuration2.PropertiesConfiguration.getIncludeOptional(). Thanks to Gary Gregory. ggregory
Add Document "includeOptional" on the site. Thanks to Gary Gregory. ggregory
Update [CVE-2014-0114] Bump Apache Commons BeanUtils from 1.9.3 to 1.9.4. Fixes CONFIGURATION-755. Thanks to Gary Gregory. ggregory
Update Fix syntax in user guide documentation #33. Thanks to Kevin Wang. ggregory
Add Allow for custom behavior to handle errors loading included properties files. Fixes CONFIGURATION-756. Thanks to Gary Gregory. ggregory
Update Bump org.yaml:snakeyaml from 1.24 to 1.25. Fixes CONFIGURATION-757. Thanks to Gary Gregory. ggregory
Update Bump tests from org.apache.commons:commons-dbcp2 2.6.0 to 2.7.0. Thanks to Gary Gregory. ggregory
Update Bump tests from org.apache.commons:commons-pool2 2.6.2 to 2.7.0. Thanks to Gary Gregory. ggregory
Update Bump commons-codec:commons-codec from 1.12 to 1.13. Fixes CONFIGURATION-758. Thanks to Gary Gregory. ggregory
Update Bump tests from org.hsqldb:hsqldb 2.4.1 to 2.5.0. Thanks to Gary Gregory. ggregory
Update Bump tests from com.sun.mail:mailapi 1.6.3 to 1.6.4. Thanks to Gary Gregory. ggregory
Update Bump Spring from 4.3.24.RELEASE to 4.3.25.RELEASE. Fixes CONFIGURATION-759. Thanks to Gary Gregory. ggregory
Fix Properties file using cyclical includes cause a StackOverflowError instead of detecting the misconfiguration. Fixes CONFIGURATION-760. Thanks to Gary Gregory. ggregory
Update Bump maven-checkstyle-plugin from 3.0.0 to 3.1.0. Thanks to Gary Gregory. ggregory
Update Use current version of Checkstyle: 6.18 to 8.24. Thanks to Gary Gregory. ggregory

Release 2.5 – 2019-05-23

Type Changes By
Fix Allow user to specify the comments and separator chars. Fixes CONFIGURATION-731. Thanks to Shuai Zhang, Gary Gregory. ggregory
Update Bump Jackson from 2.9.7 to 2.9.8. Fixes CONFIGURATION-738. Thanks to Gary Gregory. ggregory
Update Bump Apache Commons Codec from 1.11 to 1.12. Fixes CONFIGURATION-739. Thanks to Gary Gregory. ggregory
Update Bump Apache Commons VFS from 2.2 to 2.3. Fixes CONFIGURATION-740. Thanks to Gary Gregory. ggregory
Update Bump Spring from 4.3.19 to 4.3.22. Fixes CONFIGURATION-741. Thanks to Gary Gregory. ggregory
Update Bump optional library snakeyaml from 1.23 to 1.24. Fixes CONFIGURATION-743. Thanks to Gary Gregory. ggregory
Update Bump Apache Commons Lang from 3.8.1 to 3.9. Fixes CONFIGURATION-747. Thanks to Gary Gregory. ggregory
Update Bump Jackson from 2.9.8 to 2.9.9. Fixes CONFIGURATION-746. Thanks to Gary Gregory. ggregory
Update Bump Spring from 4.3.22 to 4.3.24. Fixes CONFIGURATION-747. Thanks to Gary Gregory. ggregory
Update Add the special key "includeoptional" for properties files. Fixes CONFIGURATION-745. Thanks to Gary Gregory. ggregory

Release 2.4 – 2018-10-23

Type Changes By
Fix Fixed numerous typos in user guides. Fixes CONFIGURATION-710. Thanks to thc202. oheger
Fix Bump Apache Commons Lang from 3.7 to 3.8.1. Fixes CONFIGURATION-711. ggregory
Add FileHandlerReloadingDetector now has a new refresh() method to initialize the reloading state from the underlying file. This new method is called by DefaultReloadingDetectorFactory when a new detector instance is created. This makes sure that a changed configuration file is directly detected on the first invocation of the isReloadingRequired() method. Fixes CONFIGURATION-712. Thanks to Rolland Hobbie. oheger
Add Configuration properties can now be converted to regular expressions. Fixes CONFIGURATION-713. Thanks to Lars W. oheger
Add With JupIOFactory a new IOFactory implementation is now available that implements handling of whitespace in a way closer to java.util.Properties. This class can be used when stricter compatibility with Java standard methods for reading and writing properties files is needed. Fixes CONFIGURATION-715. Thanks to Patrick Schmidt. oheger
Add JupIOFactory (introduced for CONFIGURATION-715) also implements handling of escape sequences in a way closer to java.util.Properties. Fixes CONFIGURATION-716. Thanks to Patrick Schmidt. oheger
Update Replace use of deprecated Commons Lang string substitution code for Commons Text. Fixes CONFIGURATION-720. ggregory
Update Bump Java requirement from version 7 to 8. Fixes CONFIGURATION-694. ggregory
Update Bump Jackson from 2.9.6 to 2.9.7. Fixes CONFIGURATION-721. ggregory
Update Bump optional dependency snakeyaml from 1.21 to 1.23. Fixes CONFIGURATION-722. ggregory
Update Bump optional Spring dependencies from 4.3.18.RELEASE to 4.3.19.RELEASE. Fixes CONFIGURATION-723. ggregory
Add Add support for Commons Text 1.4 localhost string lookup as a default lookup. Fixes CONFIGURATION-724. ggregory
Update Bump Apache Commons Text from 1.4 to 1.5. Fixes CONFIGURATION-725. ggregory
Add Add support for Commons Text 1.5 new string lookups as default lookups. Fixes CONFIGURATION-726. ggregory
Fix org.apache.commons.configuration2.DatabaseConfiguration never closes result sets and statements. Fixes CONFIGURATION-727. ggregory
Update Bump Apache Commons Text from 1.5 to 1.6. Fixes CONFIGURATION-728. ggregory

Release 2.3 – 2018-08-04

Type Changes By
Update Bump Spring from 4.3.14.RELEASE to 4.3.18.RELEASE. Fixes CONFIGURATION-707. ggregory
Update Bump optional dependency snakeyaml from 1.20 to 1.21. Fixes CONFIGURATION-706. ggregory
Update Bump Jackson from 2.9.5 to 2.9.6. Fixes CONFIGURATION-705. ggregory
Fix Root node attributes are now updated correctly when loading XML configuration files. Fixes CONFIGURATION-652. Thanks to Claude Warren. oheger
Update Added a .gitignore file to the project. Fixes CONFIGURATION-675. oheger
Update Bump Apache Commons Codec from 1.10 to 1.11. Fixes CONFIGURATION-678. ggregory
Update Bump Jackson from 2.8.9 to 2.9.3. Fixes CONFIGURATION-679. ggregory
Update Bump Apache Commons Lang from 3.6 to 3.7. Fixes CONFIGURATION-680. ggregory
Update Bump Apache Commons VFS from 2.1 to 2.2. Fixes CONFIGURATION-681. ggregory
Update Bump Snakeyaml from 1.18 to 1.19. Fixes CONFIGURATION-682. ggregory
Update Bump optional dependency snakeyaml from 1.19 to 1.20. Fixes CONFIGURATION-696. ggregory
Update Bump Spring from 4.3.9.RELEASE to 4.3.13.RELEASE. Fixes CONFIGURATION-683. ggregory
Update Bump optional dependency Jackson from 2.9.3 to 2.9.5. Fixes CONFIGURATION-695. ggregory
Update Bump optional dependency Spring from 4.3.13.RELEASE to 4.3.14.RELEASE. Fixes CONFIGURATION-697. ggregory
Fix JSONConfiguration can now handle list structures with complex objects as elements. Fixes CONFIGURATION-686. oheger
Fix Fixed a memory leak in CombinedConfigurationBuilder. Builder for the child sources were created each time a new result configuration was requested; thus the list with child builders got longer and longer. This also had an impact on reloading because unnecessary reloading operations could be triggered. Now it is guaranteed that child builders are created only once. Fixes CONFIGURATION-687. oheger
Fix Fixed a bug related to the handling of multiple include files in PropertiesConfiguration. Fixes CONFIGURATION-688. oheger
Fix ExprLookup.getVariables() no longer returns null, but a copy of the current variables of this lookup object. Fixes CONFIGURATION-690. oheger
Fix ExprLookup now handles expressions that do not return a string result by converting them to string. Fixes CONFIGURATION-691. oheger
Add ConversionExceptions thrown when accessing the properties of a configuration now contain the original cause of the exception. Fixes CONFIGURATION-692. oheger
Add Configuration properties can now be converted to the data types File and Path. Fixes CONFIGURATION-693. Thanks to Lars W. oheger
Add Add org.apache.commons.configuration2.MapConfiguration.toString(). Fixes CONFIGURATION-698. ggregory
Add CompositeConfiguration now supports an addConfigurationFirst() method to add child configurations with a higher priority. Fixes CONFIGURATION-701. Thanks to Nicholas Verbeck. oheger
Fix XMLConfiguration now handles elements correctly whose value consists only of whitespace if the xml:space attribute is set to preserve. Fixes CONFIGURATION-703. Thanks to Pascal Essiembre. oheger

Release 2.2 – 2017-10-12

Type Changes By
Add Added an Automatic-Module-Name header to the manifest for compatibility with the Java 9 module system. Fixes CONFIGURATION-673. Thanks to Andreas Kuhtz. oheger
Fix Fixed a NPE in INIConfiguration when saving a configuration with an empty section. Fixes CONFIGURATION-671. oheger
Fix The node model returned by SubnodeConfiguration.getNodeModel() has now the correct root node set. Fixes CONFIGURATION-670. oheger
Update Bump optional Spring dependency from 4.2.5.RELEASE to 4.3.9.RELEASE. Fixes CONFIGURATION-669. ggregory
Update Bump Apache Commons Lang from 3.3.2 to 3.6. Fixes CONFIGURATION-667. ggregory
Add Add convenience ctor ConfigurationRuntimeException(String, Object...). Fixes CONFIGURATION-666. ggregory
Add Add org.apache.commons.configuration2.AbstractHierarchicalConfiguration.toString(). Fixes CONFIGURATION-665. ggregory
Add Add API org.apache.commons.configuration2.tree.ImmutableNode.getChildren(String). Fixes CONFIGURATION-664. ggregory
Update Fixed a typo in the upgrade to 2.0 guide. Fixes CONFIGURATION-663. oheger
Update Bump platform requirement from Java 6 to 7. Fixes CONFIGURATION-661. ggregory
Add Add toString() methods here and there to help debugging. Fixes CONFIGURATION-660. ggregory
Add Add API org.apache.commons.configuration2.DataConfiguration.getURI(String) methods. Fixes CONFIGURATION-658. ggregory
Add Added new YAMLConfiguration class to support configuration files in YAML format. Fixes CONFIGURATION-656. Thanks to The Alchemist. oheger
Add ConfigurationUtils and ConfigurationConverter now offer better support for immutable configurations. Fixes CONFIGURATION-653. Thanks to Vincent Maurin. oheger
Add INIConfiguration can now be configured to use a custom separator between properties and values when writing an ini file. Fixes CONFIGURATION-647. Thanks to Vladimir Martinek. oheger
Add Added new JSONConfiguration class to support configuration files in JSON format. Fixes CONFIGURATION-258. Thanks to The Alchemist. oheger

Release 2.1.1 – 2017-02-05

Type Changes By
Fix Improved the handling of lists defined by a string with delimiter characters in XMLConfiguration. Such lists now retain their original format when the configuration is saved. Fixes CONFIGURATION-649. oheger
Fix Made the IOFactory property of PropertiesBuilderParameter compatible with the most recent version of Commons BeanUtils. This version changed the handling of properties starting with multiple uppercase letters. Fixes CONFIGURATION-648. oheger
Fix PropertiesConfiguration now works correctly with the auto-save mode. Fixes CONFIGURATION-646. oheger
Fix PropertiesConfigurationLayout no longer duplicates a header comment if a file with another comment is loaded. Fixes CONFIGURATION-644. Thanks to Andrew DeMaria. oheger
Fix Documentation improvements for the user's guide. Fixes CONFIGURATION-643. oheger
Fix Improved documentation of FileBased interface. The Javadocs now state explicitly that the methods should not be called by client code. Exception handling in configuration classes implementing FileLocatorAware has been improved. Fixes CONFIGURATION-641. oheger
Fix PropertiesConfiguration now correctly unescapes some special characters that are always escaped in Java properties files. Fixes CONFIGURATION-640. oheger
Update In the OSGi bundle manifest of the Commons Configuration bundle the package imports for Spring packages are now marked as optional. Fixes CONFIGURATION-639. Thanks to Rico Neubauer. oheger
Update Improved handling of temporary files and folders in unit tests. Fixes CONFIGURATION-638. Thanks to Ahmet Celik. oheger
Update Updated dependency to Commons BeanUtils to version 1.9.3. This fixes an issue with an exception stacktrace that was logged when a ConfigurationBuilder was used. Fixes CONFIGURATION-627. oheger

Release 2.1 – 2016-08-20

Type Changes By
Fix PropertiesConfigurationLayout now allows manipulating the order of keys when the properties file is written. Fixes CONFIGURATION-636. Thanks to Tim Lark. oheger
Fix HomeDirectoryLocationStrategy now works correctly in the mode that evaluates the FileLocator's base path. Fixes CONFIGURATION-634. Thanks to Raviteja Lokineni. oheger
Fix Interpolation was improved to better support properties with multiple values. Fixes CONFIGURATION-633. oheger
Fix The methods getStringArray() and getList() of CompositeConfiguration now support the interpolation of variables that reference properties with multiple values. Fixes CONFIGURATION-632. oheger
Update Support for the ant build was dropped. Fixes CONFIGURATION-628. oheger
Update ImmutableConfiguration.getArray() has been deprecated. Arrays can now be queried using the generic get() method in a type-safe way. Fixes CONFIGURATION-626. oheger
Add Support Commons Configuration as PropertySource in Spring. Fixes CONFIGURATION-624. deki
Fix Fixed a problem in INIConfiguration.write() with keys containing a separator character. This separator had been duplicated. Such keys are now handled correctly when the configuration is saved. Fixes CONFIGURATION-622. oheger
Update Bump Apache Commons VFS from 2.0 to 2.1. Fixes CONFIGURATION-631. ggregory
Update Bump optional dependency Apache Commons Codec from 1.9 to 1.10. Fixes CONFIGURATION-635. ggregory

Release 2.0 – 2016-03-24

Type Changes By
Update Moved ConfigurationLogger class to io package to avoid cyclic dependencies between packages. Fixes CONFIGURATION-621. oheger
Fix Fixed two invalid examples in the user's guide for file-based configurations. Fixes CONFIGURATION-620. Thanks to Mark Vedder. oheger
Add CombinedConfigurationBuilder now supports inheritance of its parameters to child configuration sources. This is enabled by default. Fixes CONFIGURATION-619. oheger
Fix When using immutable configurations exceptions thrown by the wrapped configuration came out as UndeclaredThrowableException. This has been fixed; now the correct original exception is thrown. Fixes CONFIGURATION-618. oheger
Update Changed generic types in the signatures of a MapConfiguration constructor and AbstractConfiguration.getList(String, List). These changes were made in version 1.10 as fixes for CONFIGURATION-557 and CONFIGURATION-558. But it had been missed to merge them to trunk. Fixes CONFIGURATION-615. oheger

Release 2.0-beta2 – 2015-12-05

Type Changes By
Update References to Commons Logging have been removed from the Configuration API. It is still possible to influence logging by making use of the new ConfigurationLogger abstraction. Fixes CONFIGURATION-614. oheger
Update The return type of ConfigurationBuilder.getConfiguration() was changed from Configuration to ImmutableConfiguration because this is the base interface for all configuration objects. Fixes CONFIGURATION-612. Thanks to Jon Weygand. oheger
Fix Fixed a bug in PropertiesConfiguration related to the loading of include files. The FileHandler used for this purpose was not fully initialized. Fixes CONFIGURATION-609. oheger
Fix Adapted the return type of ReloadingFileBasedConfigurationBuilder.configure(). Fixes CONFIGURATION-608. oheger
Fix XMLConfiguration no longer drops keys when list delimiter characters occur in element values. Fixes CONFIGURATION-605. oheger
Fix Fixed a problem in the conversion of a flat configuration to a hierarchical one that could cause the loss of properties in a combined configuration constructed by an override combiner. Fixes CONFIGURATION-604. oheger

Release 2.0-beta1 – 2015-06-19

Type Changes By
Update Removed obsolete ConfigurationBuilder interface in the base package. Fixes CONFIGURATION-598. Thanks to Bjarne Boström. oheger

Release 2.0-alpha2 – 2014-12-20

Type Changes By
Add DefaultExpressionEngine can now be customized to match configuration keys in a case-insensitive manner. This is useful for instance for dealing with Windows INI files. Fixes CONFIGURATION-574. oheger
Add Added support for querying encoded properties. Fixes CONFIGURATION-565. oheger
Fix PropertiesConfiguration now supports again properties without a value and a separator character. The keys of such properties are added to the configuration with an empty String as value. Fixes CONFIGURATION-564. oheger
Update XMLPropertyListConfiguration can now save arrays in the correct form. Fixes CONFIGURATION-427. oheger
Add A size() method was added to the ImmutableConfiguration interface. Fixes CONFIGURATION-200. oheger

Release 2.0-alpha1 – 2014-09-23

Type Changes By
Update Removed methods from ConfigurationConverter related to ExtendedProperties. This class is no longer supported by recent versions of Commons Collections. Fixes CONFIGURATION-591. oheger
Update Removed Serializable interface from all configuration implementations. Some configuration classes declared this interface without being actually serializable. Fixes CONFIGURATION-590. oheger
Update The name of the top-level package and the maven coordinates have been changed to allow a coexistence of Commons Configuration 1.x with 2.0. Fixes CONFIGURATION-588. oheger
Update The event mechanism has been reworked. There is now a generic event listener interface which can be used to receive notifications from multiple types of event sources. Fixes CONFIGURATION-584. oheger
Fix Fixed a StringIndexOutOfBoundsException in PropertiesConfigurationLayout which was caused by lines containing only whitespace. Fixes CONFIGURATION-582. oheger
Add A migration guide has been created which supports when upgrading from version 1.x to 2.0. Fixes CONFIGURATION-579. oheger
Update The user's guide has been fully reworked to cover all new and enhanced features of version 2.0. Fixes CONFIGURATION-578. oheger
Update The dependency to Commons Collections is no longer needed. Fixes CONFIGURATION-577. oheger
Update A new abstract base class for hierarchical configurations was introduced which supports arbitrary hierarchical data structures. The type of the nodes used by the configuration can now be specified as a generic type argument. This makes the integration of other hierarchical structures easier. Fixes CONFIGURATION-576. oheger
Update Hierarchical configurations now operate on immutable structures. Data is no longer represented by ConfigurationNode objects. The ImmutableNode class now serves as data container. Fixes CONFIGURATION-575. oheger
Update XPathExpressionEngine can now deal with namespace prefixes in node and attribute names. Fixes CONFIGURATION-573. oheger
Fix When a CombinedConfiguration is cleared it removes itself as change listener from all child configurations. This fixes a possible memory leak. Fixes CONFIGURATION-572. oheger
Fix Fixed a possible ConcurrentModificationException when a SystemConfiguration instance is passed to the append() or copy() methods. Fixes CONFIGURATION-570. oheger
Fix XMLBeanDeclaration now escapes node names before they are used to determine nested properties. Fixes CONFIGURATION-567. Thanks to Shen liang. oheger
Update The DefaultExpressionEngine class is now immutable. An instance can be shared between multiple configuration objects. Fixes CONFIGURATION-563. oheger
Update Improved the API of ExprLookup. Fixes CONFIGURATION-562. oheger
Add It is now possible to define default values for initialization properties of configurations. Fixes CONFIGURATION-559. oheger
Update Fixed a bug in the handling of the xml:space attribute in XMLConfiguration. The attribute is now also applied to the current element, not only to sub elements. Fixes CONFIGURATION-555. oheger
Update BeanHelper is no longer a static utility class. Instances can be created with a specific configuration of bean factories. There is still a default instance which can be obtained via the BeanHelper.INSTANCE field. Fixes CONFIGURATION-554. oheger
Update The code for accessing configuration files hs been reworked. Methods related to locating configuration files have been moved from ConfigurationUtils to a new FileLocatorUtils class. Customizable strategy classes (implementing the new FileLocationStrategy) can be used for searching for configuration files. Fixes CONFIGURATION-553. oheger
Add The data type conversion mechanism has been made extensible. There is a new interface ConversionHandler which controls the data type conversions available for a configuration object. By setting a custom implementation, conversions can be adapted or extended. Fixes CONFIGURATION-551. oheger
Add Conversion to Character is now supported. Fixes CONFIGURATION-550. oheger
Update BeanHelper can now process BeanDefinitions initializing properties of collection types of their target beans. Fixes CONFIGURATION-546. Thanks to Justin Couch. oheger
Update Added missing dependencies to build.xml. Fixes CONFIGURATION-544. Thanks to Oliver Kopp. oheger
Update The mechanism for synchronizing configurations has been completely redesigned. It is now based on Synchronizer objects which can be configured by client code. A new chapter was added to the user's guide regarding thread-safety of configurations. Fixes CONFIGURATION-542. oheger
Update MapConfiguration now directly uses a Properties object passed to its constructor as data store rather than copying it. This allows SystemConfiguration to be connected to system properties; i.e. changing a property through SystemConfiguration immediately affects the corresponding system property. Fixes CONFIGURATION-540. oheger
Add Multi-file configurations are no longer restricted to XML configuration files. Arbitrary file-based configurations are now supported. Fixes CONFIGURATION-541. oheger
Update The deprecated INIConfiguration class was removed. HierarchicalINIConfiguration was renamed to INIConfiguration. Fixes CONFIGURATION-539. oheger
Update The deprecated ConfigurationFactory class was removed. Fixes CONFIGURATION-537. oheger
Update File-based configurations are now implemented in a different way. The interfaces FileConfiguration and ReloadingStrategy have been removed, also the base classes AbstractFileConfiguration and AbstractHierarchicalFileConfiguration. They are replaced by the FileBased interface and the FileHandler class which implements central I/O functionality. Reloading is now in the responsibility of configuration builders. Fixes CONFIGURATION-536. oheger
Add DatabaseConfiguration now provides get methods for querying its properties defining the underlying database structures. Fixes CONFIGURATION-535. oheger
Update The includesAllowed property of PropertyConfiguration is now independent from the existence of a base path. Fixes CONFIGURATION-534. oheger
Add DatabaseConfiguration now automatically converts CLOBs to strings if they appear in property values. Fixes CONFIGURATION-533. oheger
Update Concurrent access to configurations and reloading have been completely redesigned. Because reloading is now handled by configuration builders there is no need to acquire a lock in order to protected against a reload operations. Fixes CONFIGURATION-530. oheger
Update AbstractConfiguration.clearPropertyDirect() is now abstract. Fixes CONFIGURATION-527. Thanks to Matthias Richter. oheger
Update XMLPropertiesConfiguration now supports loading from and saving to DOM nodes. Fixes CONFIGURATION-526. Thanks to Oliver Kopp. oheger
Add PropertiesConfiguration now keeps a comment at the bottom of a properties file. A new footer property was added for reading and writing this footer comment. Fixes CONFIGURATION-525. oheger
Update Interpolation now works correctly after a configuration was cloned. The ConfigurationInterpolator instance is now cloned, too. Fixes CONFIGURATION-524. oheger
Update ConfigurationUtils.fileFromUrl() now correctly handles URL containing encoded percent characters. Fixes CONFIGURATION-521. Thanks to Oliver Kopp. oheger
Update Support for reloading of configuration data has been reworked. Fixes CONFIGURATION-520. oheger
Add Configuration objects are now created via configuration builders. A new API for configuration builders has been added. Fixes CONFIGURATION-519. oheger
Update Classes and interfaces related to interpolation have been slightly reworked. ConfigurationInterpolator is now thread-safe. There are multiple ways to define the ConfigurationInterpolator object to be used by an AbstractConfiguration instance. Fixes CONFIGURATION-518. oheger
Add Hierarchical configurations now provide methods to obtain sub configurations for all child elements of a given key. Fixes CONFIGURATION-517. oheger
Update PropertiesConfiguration no longer escapes double quotes on saving. Fixes CONFIGURATION-516. oheger
Update The visibility of some internal methods of PropertiesConfiguration.PropertiesWriter has been increased to protected. This simplifies the implementation of a custom escaping strategy. Fixes CONFIGURATION-515. oheger
Add Bean declarations now support constructor invocations. Fixes CONFIGURATION-514. oheger
Update HierarchicalConfiguration is now an interface. The base implementation class is named BaseHierarchicalConfiguration. Fixes CONFIGURATION-513. oheger
Add It is now possible to obtain an immutable view on a Configuration or HierarchicalConfiguration object. New interfaces, ImmutableConfiguration, and ImmutableHierarchicalConfiguration have been introduced. Fixes CONFIGURATION-512. oheger
Add Generic get() methods have been added to the Configuration interface. These methods expect a target class and try to convert the value of the specified property to this target class. Fixes CONFIGURATION-508. oheger
Update Removed obsolete nested classes Node and NodeVisitor of HierarchicalConfiguration. The related deprecated class ConfigurationKey was removed, too. Fixes CONFIGURATION-506. oheger
Update XMLConfiguration no longer supports attributes with multiple values or list delimiter parsing in attributes. This feature was complex and error prone and brought little value to the user. Fixes CONFIGURATION-505. oheger
Update SubnodeConfiguration now provides a new method for clearing it and removing its root node from the parent configuration. The method HierarchicalConfiguration.configurationsAt() now returns a list of SubnodeConfiguration so that it is easier to make direct use of this feature. Fixes CONFIGURATION-504. oheger
Update XMLConfiguration now adds attributes of elements defining a list to all list nodes. Fixes CONFIGURATION-500. oheger
Update Concurrent access to configurations and reloading have been completely redesigned. This should reduce the amount of synchronization. Fixes CONFIGURATION-496. oheger
Update Removed some static fields for specifying global default values. Using static fields in this way is thread-hostile. There are now alternatives for setting default values. Fixes CONFIGURATION-486. oheger
Update Updated dependency to Commons Lang from version 2.6 to 3.1. Fixes CONFIGURATION-462. oheger
Update EventSource is now an interface. With BaseEventSource there is a default implementation. Fixes CONFIGURATION-419. oheger
Update The handling of list delimiters and their escape characters has been reworked. A new ListDelimiterHandler interface was introduced allowing applications to customize the treatment of list delimiters. Fixes CONFIGURATION-418. oheger
Update Concurrent access to configurations has been reworked. Fixes CONFIGURATION-330. oheger
Add With the new reloading mechanism automatic and periodic reloading checks can be performed. Fixes CONFIGURATION-204. oheger
Add Reloading checks can now be performed in a background thread. Fixes CONFIGURATION-202. oheger
Update It is now possible to define the strategy used for locating configuration files. Fixes CONFIGURATION-153. oheger
Update Reloading can no longer corrupt a configuration instance. This is now handled by a configuration builder; the original configuration instance is not modified. Fixes CONFIGURATION-136. oheger
Update It is now possible to influence the conversion from a container object (a collection or an array) to a single value (e.g. what is returned by getString() if the current property has multiple values). Per default, the first value is returned. By overriding methods of the configuration's ConversionHandler, this behavior can be changed. Fixes CONFIGURATION-26. oheger

Release 1.10 – 2013-10-27

Type Changes By
Update XMLConfiguration now adds attributes of elements defining a list to all list nodes. Fixes CONFIGURATION-500. oheger
Add PropertiesConfiguration now keeps a comment at the bottom of a properties file. A new footer property was added for reading and writing this footer comment. Fixes CONFIGURATION-525. oheger
Update XMLPropertiesConfiguration now supports loading from and saving to DOM nodes. Fixes CONFIGURATION-526. Thanks to Oliver Kopp. oheger
Update The includesAllowed property of PropertyConfiguration is now independent from the existence of a base path. Fixes CONFIGURATION-534. oheger
Update BeanHelper can now process BeanDefinitions initializing properties of collection types of their target beans. Fixes CONFIGURATION-546. Thanks to Justin Couch. oheger
Add Conversion to Character is now supported. Fixes CONFIGURATION-550. oheger
Update Fixed a bug in the handling of the xml:space attribute in XMLConfiguration. The attribute is now also applied to the current element, not only to sub elements. Fixes CONFIGURATION-555. oheger
Fix In 1.7 and before, any change to the system properties was immediately reflected in a SystemConfiguration object. This behavior broke in 1.8 and 1.9. This has been fixed for 1.10. Fixes CONFIGURATION-556. henning
Fix In 1.7 and before, it was possible to pass an arbitrary Map into the constructor of MapConfiguration. With the generification in 1.8, this actually broke and it was no longer possible to pass in e.g. a Map<String, String> because the signature now required a Map<String, Object>. Changing the constructor to accept a Map<String, ?> restores this. Fixes CONFIGURATION-557. henning
Fix Similar to CONFIGURATION-557, the getList(String, List) method was generified to be getList(String, List<Object>) but needs to be getList(String, List<?>) so that code that used a more specific list (such as a List<String>) still compiles against the new API. Fixes CONFIGURATION-558. henning

Release 1.9 – 2012-08-22

Type Changes By
Update Small changes in user guide documentation. Fixes CONFIGURATION-503. Thanks to Tino Sino. oheger
Update Improvements of basic features and AbstractConfiguration documentation. Fixes CONFIGURATION-502. Thanks to Tino Sino. oheger
Add XMLPropertyListConfiguration no longer swallows exception caused by invalid date properties. Now a warning message is logged. Fixes CONFIGURATION-501. oheger
Fix List properties can now be set correctly on a HierarchicalConfiguration if delimiter parsing is disabled. Fixes CONFIGURATION-495. oheger
Update Made static DateFormat fields in XMLPropertyListConfiguration.PListNode final and added a note about proper synchronization. Fixes CONFIGURATION-488. oheger
Fix DataConfiguration.get() now also works with String properties and if no data type conversion is required. Fixes CONFIGURATION-487. oheger
Update DatabaseConfiguration now always closes the result set. Fixes CONFIGURATION-483. oheger
Update The Import-Package section in the OSGi manifest now uses the resolution:=optional directive for optional dependencies. Fixes CONFIGURATION-482. Thanks to Chris Seieroe. oheger
Fix Variable substitution in configuration sources declared in a definition file for DefaultConfigurationBuilder now works across multiple sources. Fixes CONFIGURATION-481. oheger
Fix PropertyListConfiguration now can deal with C-style comments in plist configuration files. Both block and single-line comments are supported. Fixes CONFIGURATION-477. oheger

Release 1.8 – 2012-02-04

Type Changes By
Fix Fixed possible ClassCastExceptions in CompositeConfiguration related to special in-memory configurations. Fixes CONFIGURATION-476. oheger
Update Class ConfigurationKey was deprecated in favor of DefaultConfigurationKey. Fixes CONFIGURATION-475. oheger
Update Implemented delimiter parsing in HierarchicalINIConfiguration to be consistent with other Configuration implementations. Note that this can impact existing code. To switch back to the old behavior, call setDelimiterParsingDisabled(true) before loading the configuration. Fixes CONFIGURATION-474. oheger
Add CompositeConfiguration now provides better support for child configurations that are used as in-memory configuration. Fixes CONFIGURATION-471. oheger
Update Classes generated by JavaCC are now created dynamically during the build process. Fixes CONFIGURATION-470. oheger
Add Commons Configuration now requires Java 5 or later. ebourg
Add Binary literals are now supported (i.e Ob11010001). Fixes CONFIGURATION-466. ebourg
Update Updated the dependency to Commons Jexl to version 2.1.1. This version provides correct OSGi manifest headers. Fixes CONFIGURATION-465. oheger
Update Improved documentation of AbstractFileConfiguration related to load() methods and their impact on the base path. Fixes CONFIGURATION-463. oheger
Update The project now uses standard Maven directory layout. Fixes CONFIGURATION-461. oheger

Release 1.7 – 2011-09-07

Type Changes By
Fix Reloading now also works for configuration sources declared in the additional section of a configuration definition file for DefaultConfigurationBuilder. Fixes CONFIGURATION-460. oheger
Update ConfigurationFactory has been deprecated. The user guide was updated to no more mention this class. Fixes CONFIGURATION-459. oheger
Add HierarchicalConfiguration now provides a specific implementation of the clear() method. This is more efficient and also solves some other problems related to clearing a SubnodeConfiguration. Fixes CONFIGURATION-458. oheger
Update Improved Javadocs of getKeys(String) method for some configuration classes. Fixes CONFIGURATION-456. oheger
Update HierarchicalINIConfiguration.getSection() now creates a section if it does not exist. The SubnodeConfiguration returned by this method is now always connected to the parent ini configuration. Fixes CONFIGURATION-455. oheger
Add XPathExpressionEngine now provides better support for the setProperty() method. Fixes CONFIGURATION-452. oheger
Add The parsing of ini files has been improved for property definitions containing multiple separator characters. Fixes CONFIGURATION-448. oheger
Add DefaultConfigurationBuilder now supports including environment properties using the "env" tag. Fixes CONFIGURATION-447. oheger
Update XMLConfiguration now handles attributes correctly whose value is an empty string. Fixes CONFIGURATION-446. oheger
Fix Transforming a CombinedConfiguration with ViewNodes to an XMLConfiguration could cause problems with attributes. This has been fixed. Fixes CONFIGURATION-445. oheger
Update Child configuration builders created for a <configuration> element in a configuration definition file now inherit the configuration and error listeners from the original DefaultConfigurationBuilder. This makes it possible to suppress log output created for optional configurations. Fixes CONFIGURATION-439. oheger
Update JNDIConfiguration.getKeys() no more logs an exception if the prefix does not exist. Fixes CONFIGURATION-438. Thanks to Mike Noordermeer. oheger
Update Child configuration builders created for a <configuration> element in a configuration definition file now inherit some of their properties from the builder object which processed the file. Fixes CONFIGURATION-437. oheger
Update The optional dependency to Apache Ant has been changed to the new groupId org.apache.ant. The version was updated to the most recent version 1.8.2 (older versions should still work). Fixes CONFIGURATION-436. oheger
Fix HierarchicalINIConfiguration now recognizes comment characters in property definitions only if they are preceded by whitespace. Thus comment characters can now be part of the property value. This is for instance required for the definition of file paths which use the semicolon as path separator. Fixes CONFIGURATION-434. oheger
Fix Minor improvements of the support for indexed properties in ConfigurationDynaBean. Fixes CONFIGURATION-433. oheger
Fix The methods getList() and getStringArray() of AbstractConfiguration can now handle single-valued properties of primitive types. Fixes CONFIGURATION-432. oheger
Fix XMLConfiguration no longer escapes backslashs in the values of XML elements. Fixes CONFIGURATION-428. oheger
Fix HierarchicalINIConfiguration now works correctly with configurations that contain only properties in the global section. Fixes CONFIGURATION-424. oheger
Fix testFromClassPath() can fail when it should not because of inconsistent escaping of output from PropertiesConfiguration.getURL() and FileChangedReloadingStrategy.getFile().toURL(). Fixes CONFIGURATION-423. Thanks to William Buckley. rgoers
Fix A bug related to the interpretation of escape sequences for backslashes has been fixed. The user guide has also been improved in this area. Fixes CONFIGURATION-418. oheger
Fix Files with a plus character in their names are now handled correctly. Fixes CONFIGURATION-415. oheger
Fix SubsetConfiguration now produces correct events. Fixes CONFIGURATION-413. Thanks to Alexander Prishchepov. oheger
Add DatabaseConfiguration can now be instructed to perform a commit after an update of the managed database table. This makes it usable in environments where the connections do not use auto-commit mode. Fixes CONFIGURATION-412. oheger
Add Added a refresh() method to AbstractFileConfiguration and AbstractHierarchicalFileConfiguration. Fixes CONFIGURATION-410. oheger
Fix HierarchicalINIConfiguration now correctly saves sections whose name contains delimiter characters. Fixes CONFIGURATION-409. oheger
Update PropertiesConfiguration.save() escaped slashes in properties values. This was caused by a bug in commons-lang 2.4. Updating to the new version commons-lang 2.5 fixed this problem. Fixes CONFIGURATION-408. oheger
Fix Fixed a potential IllegalStateException in HierarchicalINIConfiguration that can be thrown when the global section is requested concurrently. Fixes CONFIGURATION-407. oheger
Fix XMLPropertyListConfiguration no longer throws a ConfigurationException if the file to be loaded does not have an outer dict element. Fixes CONFIGURATION-405. oheger
Fix The default expression engine used by hierarchical configurations used to throw a NumberFormatException if invalid indices were used in property keys. This has been fixed. As a side effect brackets can now be used in property keys. Fixes CONFIGURATION-404. Thanks to Rob Walker. oheger
Fix When an empty XMLConfiguration was saved and reloaded the root element was assigned an empty text value. Because of this isEmpty() returned false for this configuration. This has been fixed. Fixes CONFIGURATION-403. oheger
Add Default variable interpolation now supports the env: prefix for referencing environment variables. Fixes CONFIGURATION-399. oheger
Fix Schema violation exceptions are now propagated back to the caller. Fixes CONFIGURATION-397. rgoers
Fix XMLConfiguration and CombinedConfiguraton are now synchronized to fix problems caused by reloading in a multithreaded environment. Fixes CONFIGURATION-390. rgoers
Fix HierarchicalConfiguration.NodeVisitor is now passed the correct key to its visitAfterChildren() method. Fixes CONFIGURATION-396. oheger
Fix BaseConfiguration.clone() now also clones collections stored in the internal map. This causes list properties to be handled correctly. Fixes CONFIGURATION-393. oheger
Add DefaultConfigurationBuilder now supports defining ini files in its configuration definition file. Fixes CONFIGURATION-389. oheger
Fix Attribute or element values will not be escaped when attribute or element splitting are disabled. Fixes CONFIGURATION-388. rgoers
Add When using Commons Lang 2.6 or higher as dependency nested interpolation in variable names is supported. Fixes CONFIGURATION-363. oheger
Fix Empty dictionaries in a PropertyList configuration are now preserved when the configuration is saved. Fixes CONFIGURATION-362. ebourg
Fix DatabaseConfiguration now generates correct events for the clear() and clearProperty() methods. Fixes CONFIGURATION-385. oheger
Add Add ExprLookup to allow expressions to be evaluated in configurations. When used, this requires that Apache Commons Jexl be added as a dependency to projects using Commons Configuration. Fixes CONFIGURATION-380. rgoers
Add MapConfiguration now provides a way of controlling the trimming behavior. Fixes CONFIGURATION-374. oheger
Add Added MergeCombiner to allow elements in two configurations to be merged when the element and attributes in the first file match those in the second file. Fixes CONFIGURATION-378. rgoers
Add File system access has been abstracted to a FileSystem interface. Two implementations are provided, DefaultFileSystem that behaves in a backward compatible manner and VFSFileSystem which uses Commons VFS to retreive and store files. Fixes CONFIGURATION-340. rgoers
Add PropertiesConfigurationLayout now allows setting the line separator to be used when writing the properties file. Fixes CONFIGURATION-314. oheger
Add PropertiesConfigurationLayout now also stores the property separators used for the single properties. It is also possible to change them for specific properties or set a global properties separator. In earlier versions the separator was hard-coded to " = ". Fixes CONFIGURATION-371. oheger
Add PropertiesConfiguration now defines a nested interface IOFactory. Using this interface it is possible to inject custom PropertiesReader and PropertiesWriter implementations. Fixes CONFIGURATION-370. oheger
Fix SubnodeConfiguration now fires an event of type EVENT_SUBNODE_CHANGED if a structural change of the parent configuration was detected. If the SubnodeConfiguration is contained in a CombinedConfiguration, the CombinedConfiguration receives this event and can update itself. Fixes CONFIGURATION-368. oheger
Fix MultiFileHierarchicalConfiguration was not using basepath to construct the file url. It also threw an exception if the file pattern resolved to a non-existent file. This is now configurable. Fixes CONFIGURATION-361. rgoers
Update Align interpolation functionality of SubnodeConfiguration and SubsetConfiguration. SubsetConfiguration will now also interpolate keys of the parent configuration or use the local lookups of its parent. SubnodeConfiguration is in turn now able to lookup local keys as well. Fixes CONFIGURATION-375. joehni
Update Align interpolation functionality of SubnodeConfiguration and SubsetConfiguration. Fixes CONFIGURATION-376. joehni
Update Align interpolation functionality of SubnodeConfiguration and SubsetConfiguration. Fixes CONFIGURATION-377. joehni
Fix SubsetConfiguration did not use locally registered lookups of its interpolator. Fixes CONFIGURATION-369. joehni
Fix Fixed broken links to the API documentation in the user's guide. Fixes CONFIGURATION-359. oheger
Update Improvements of the user's guide for hierarchical configurations. Fixes CONFIGURATION-358. oheger
Fix The message of the ConversionException thrown by AbstractConfiguration.getBigInteger() is now correct. Fixes CONFIGURATION-357. oheger
Add Added getConfigurations and getConfigurationNameList. Fixes CONFIGURATION-356. rgoers
Add Allow configurations to be validated using XML Schemas. Fixes CONFIGURATION-257. rgoers
Add Allow configurations to be validated using XML Schemas. Fixes CONFIGURATION-355. rgoers

Release 1.6 – 2008-12-25

Type Changes By
Update Some dependencies to other Commons components have been updated to the recent versions. Affected are Commons Lang, Commons Collections, Commons Logging, Commons BeanUtils, and Commons JXPath. The older versions should still work. oheger
Add Allow system properties to be set from a configuration file. Fixes CONFIGURATION-353. rgoers
Add Allow variable resolvers to be defined configured in DefaultConfigurationBuilder. Fixes CONFIGURATION-351. rgoers
Add Added MultiFileHierarchicalConfiguration, DynamicCombinedConfiguration and PatternSubtreeConfigurationWrapper. Fixes CONFIGURATION-350. rgoers
Add The visibility of DefaultConfigurationBuilder.XMLConfigurationProvider was changed from package local to public. This makes it easier to implement providers that create configuration classes derived from XMLConfiguration. Fixes CONFIGURATION-349. Thanks to Ralph Goers. oheger
Fix AbstractHierarchicalFileConfiguration.getKeys() now also checks whether a reload is required. Fixes CONFIGURATION-348. oheger
Fix AbstractFileConfiguration.getKeys() now returns an iterator that points to a snapshot of the keys of the configuration. This prevents ConcurrentModificationExceptions during iteration when a reload is performed. Fixes CONFIGURATION-347. oheger
Fix ConfigurationUtils.convertToHierarchical() now creates multiple configuration nodes for properties with multiple values. This improves compatibility with queries. Fixes CONFIGURATION-346. oheger
Fix PropertiesConfiguration now per default uses the encoding "ISO-8859-1" for loading properties files. Fixes CONFIGURATION-345. oheger
Fix CombinedConfiguration could cause a deadlock when it was accessed while concurrently a reload of one of its child configuration happened. This was fixed by reducing synchronization where it is not strictly necessary. Fixes CONFIGURATION-344. oheger
Fix The "force reload check" mechanism of CombinedConfiguration now also works with sub configurations created by configurationAt(). Fixes CONFIGURATION-341. oheger
Fix When performing interpolation the methods getList() and getStringArray() of CompositeConfiguration did not take the order of child configurations into account. This could lead to wrong interpolated values when the key was contained in multiple child configuration. Interpolation is now always done in the correct order. Fixes CONFIGURATION-339. oheger
Add PropertiesConfiguration now also performs interpolation when searching for include files. This means that the name of a file to include can be determined by another property. Fixes CONFIGURATION-338. Thanks to David Donn. oheger
Add DefaultConfigurationBuilder now supports defining new configuration providers in the configuration definition file. Fixes CONFIGURATION-337. Thanks to Ralph Goers. oheger
Add When converting a flat configuration to a hierarchical one it is now possible to specify the expression engine to be used for this purpose. This may be necessary if the flat configuration contains keys with special characters interpreted by the expression engine. CombinedConfiguration defines the new setConversionExpressionEngine() method. The expression engine passed to this method will be used when converting flat child configurations to hierarchical ones. Fixes CONFIGURATION-336. oheger
Add XMLConfiguration now allows disabling the attribute splitting mechanism introduced in the 1.5 release (as part of the fix for CONFIGURATION-268). This may be necessary for correctly processing attributes containing both the list delimiter and the attribute delimiter character. The new property "disableAttributeSplitting" was added for this purpose. Fixes CONFIGURATION-335. oheger
Fix Made handling of parent nodes more consistent when setRoot() or setRootNode() of HierarchicalConfiguration are involved. Fixes CONFIGURATION-334. oheger
Fix Properties written through a DataConfiguration to a wrapped PropertiesConfiguration got lost when the PropertiesConfiguration was saved. This has been fixed. Fixes CONFIGURATION-332. oheger
Add XMLBeanDeclaration now defines a factory method createBeanDeclaration() for creating the declarations for complex nested properties. This method can be overridden by derived classes for injecting custom BeanDeclaration implementations. Fixes CONFIGURATION-331. oheger
Fix A bug in XMLConfiguration.addNodes() made it impossible to add attribute nodes using this method. This has been fixed. Fixes CONFIGURATION-328. oheger
Fix INIConfiguration misinterpreted variables in the global section with a dot in their name as section names. HierarchicalINIConfiguration fixes this problem. Fixes CONFIGURATION-327. oheger
Add INIConfiguration does not support obtaining a subset for the global section. HierarchicalINIConfiguration provides the getSection() method that returns the content of the global section if null is passed in as section name. Fixes CONFIGURATION-326. oheger
Fix INIConfiguration does not return the global section in its getSections() method. HierarchicalINIConfiguration fixes this problem. Fixes CONFIGURATION-325. oheger
Add HierarchicalINIConfiguration adds support for line continuation. Fixes CONFIGURATION-324. oheger
Update INIConfiguration has been deprecated. Its functionality is now available through the new HierarchicalINIConfiguration class. oheger
Add With HierarchicalINIConfiguration a complete new Configuration implementation for parsing Windows INI files is available. This new class is a full replacement of INIConfiguration and addresses some of its shortcomings. Being derived from HierarchicalConfiguration it offers the enhanced functionality of hierarchical configurations. oheger
Fix ConfigurationDynaBean now works properly with indexed properties stored internally in the underlying configuration as arrays. Fixes CONFIGURATION-322. ebourg
Fix The iterator returned by HierarchicalConfiguration.getKeys(String prefix) now also contains the prefix if this key is contained in the configuration. Fixes CONFIGURATION-321. oheger
Fix XMLPropertyListConfiguration is no longer limited to 32 bits integers. Fixes CONFIGURATION-320. ebourg
Fix When an XMLConfiguration is created using the copy constructor, the name of the root element is now preserved. Fixes CONFIGURATION-318. oheger
Fix Changing the text of the root element of an XMLConfiguration had no effect when the configuration was saved. This has been fixed. Fixes CONFIGURATION-316. oheger
Fix CombinedConfiguration used to send two EVENT_COMBINED_INVALIDATE events for each modified child configuration. Now this event is sent only once after the affected child configuration was updated. Fixes CONFIGURATION-315. oheger
Fix XMLConfiguration now supports the xml:space attribute. This attribute can be used to preserve whitespace in the content of XML elements. Fixes CONFIGURATION-307. oheger
Fix INIConfiguration now preserves whitespace in quoted values. Fixes CONFIGURATION-306. oheger
Fix If a change has been detected by FileChangedReloadingStrategy, the reloadingRequired() method will now return true until reloadingPerformed() has been called. Fixes CONFIGURATION-302. oheger
Fix Fixed a NullPointerException that could be thrown under certain circumstances when saving an XMLConfiguration that was created using the constructor that takes a HierarchicalConfiguration. Fixes CONFIGURATION-301. oheger
Fix Instantiating an XMLPropertyListConfiguration no longer fails if the DTD is missing from the classpath. Fixes CONFIGURATION-309. ebourg
Fix It's now possible to read a configuration file containing a '#' in its name (requires Java 1.4 or above). Fixes CONFIGURATION-300. ebourg
Fix Fixed the date format for XMLPropertyListConfiguration. Fixes CONFIGURATION-260. ebourg

Release 1.5 – 2007-11-24

Type Changes By
Update Some of the dependencies in the m2 pom have been updated to be more consistent. Thanks to Jörg Schaible. oheger
Update The dependency to commons-logging was updated to the current version 1.1. Older versions of commons-logging will still work. Thanks to Jörg Schaible. oheger
Add A new method interpolatedConfiguration() was added to AbstractConfiguration. This method returns a configuration with the same type and content as the original configuration, however all variables have been resolved. Fixes CONFIGURATION-273. oheger
Fix Resolving of variables with the prefix const (constant fields) caused a ClassCastException under certain circumstances if non-String fields were involved. This has been fixed. Fixes CONFIGURATION-299. oheger
Update The dependencies to commons-codec and commons-jxpath have been marked as optional. They are not required by the core classes. Thanks to Nicolas De Loof. oheger
Add There is a new configuration implementation EnvironmentConfiguration, which provides access to (OS) environment variables. On Java >= 1.5 this class can be directly used; on earlier versions a dependency to ant is required. Fixes CONFIGURATION-284. Thanks to Nicolas De Loof. oheger
Fix A bug in XMLConfiguration caused that attributes of the root element could not be changed. This has been fixed. Fixes CONFIGURATION-296. oheger
Add A new method registerEntityId() was added to XMLConfiguration, which allows to register URLs for entities. A new default implementation of the EntityResolver interface handles these entities automatically. Fixes CONFIGURATION-290. oheger
Fix The subset() method of HierarchicalConfiguration now takes the value of the subset's root node into account if it is not ambigous. Fixes CONFIGURATION-295. oheger
Fix Nodes added to a XMLConfiguration using the addNodes() method could lose their value when the configuration was saved. This is now fixed. Fixes CONFIGURATION-294. oheger
Fix New copy() and append() methods have been added to AbstractConfiguration. They replace the methods with the same names in ConfigurationUtils, which do not handle all features of AbstractConfiguration properly (e.g. list delimiters in property values are incorrectly treated). To avoid such problems, the new methods should be used. Fixes CONFIGURATION-272. oheger
Fix The addNodes() method of hierarchical file-based configurations now correctly triggers an auto save. Fixes CONFIGURATION-291. oheger
Fix HierarchicalConfiguration.addNodes() now resets the reference property of all nodes to be added. This fixes a problem with XMLConfiguration, which now detects the added nodes as new and treats them correctly when the configuration is saved. Fixes CONFIGURATION-287. oheger
Add DefaultConfigurationBuilder will now notify registered error listeners about optional configuration sources that could not be created. Before exceptions thrown by optional configurations were swallowed. Fixes CONFIGURATION-285. oheger
Fix ConfigurationUtils.convertToHierarchical() now correctly deals with property values containing escaped list delimiters. This also affects CombinedConfiguration when sub configurations with such property values are contained. Fixes CONFIGURATION-283. oheger
Fix AbstractConfiguration.addProperty() now correctly deals with list and array properties if delimiter parsing is disabled. Fixes CONFIGURATION-275. oheger
Fix The default expression engine used by HierarchicalConfiguration instances is now lazily initialized. This avoids NullPointerExceptions in certain server environments after a redeploy. Fixes CONFIGURATION-282. oheger
Fix Cycles in the JNDI tree no longer cause a stack overflow in JNDIConfiguration. Fixes CONFIGURATION-281. oheger
Add The base implementation of clear() in AbstractConfiguration now checks for a potential UnsupportedOperationException when iterating over the existing properties. Fixes CONFIGURATION-277. oheger
Fix Using file-based configurations in auto-save mode together with a reloading strategy could cause data loss. This has been fixed. Fixes CONFIGURATION-280. Thanks to Roman Kurmanowytsch. oheger
Fix A PropertiesConfiguration that was created from a non existing file lost its content when it was saved. This problem has been solved. Fixes CONFIGURATION-279. oheger
Add A new getSource() method was added to CompositeConfiguration and CombinedConfiguration, which returns the child configuration, in which a given property is defined. Fixes CONFIGURATION-215. oheger
Fix PropertiesConfiguration now supports escaping the escape character for list delimiters. Fixes CONFIGURATION-274. oheger
Fix PropertiesConfiguration no longer escapes the list delimiter on saving if the list delimiter has been disabled. Fixes CONFIGURATION-269. ebourg
Fix List properties and properties containing interpolated variables are now properly saved by INIConfiguration. Fixes CONFIGURATION-270. ebourg
Update When delimiter parsing was disabled for XMLConfiguration, saving and loading the configuration accidently added escape characters to properties containing the list delimiter character. This has been fixed. It is now also possible to escape the escape character itself. Fixes CONFIGURATION-268. oheger
Update The return value of FileConfiguration.getFile() is now always consistent with the result of getURL(). Fixes CONFIGURATION-253. oheger
Update INIConfiguration uses the platform's specific line separator instead of the Windows line separator. ebourg
Fix INIConfiguration flushes the output at the end of a save operation. Fixes CONFIGURATION-267. ebourg
Update For hierarchical file-based configurations the auto-save mechanism is now also triggered if a subnode configuration is changed. In such a case the new event type EVENT_SUBNODE_CHANGED will be sent to registered listeners. Fixes CONFIGURATION-265. oheger
Update ConfigurationInterpolator now also invokes the default lookup object for variables with a prefix that could not be resolved by their associated lookup object. Fixes CONFIGURATION-266. Thanks to Tobias Noebel. oheger
Add A SubnodeConfiguration per default does not see certain changes of its parent configuration (e.g. reloads). With a new boolean parameter of HierarchicalConfiguration's configurationAt() method a mode can be enabled, in which the subnode configuration checks for such changes and reconstructs itself if necessary. Fixes CONFIGURATION-264. oheger
Fix byte[] properties are properly saved as data fields in the plist configurations (PropertyListConfiguration and XMLPropertyListConfiguration). ebourg
Add DataConfiguration now supports java.net.InetAddress, javax.mail.internet.InternetAddress, and Java 5 enumeration types. Properties are converted to these types using the new generic getters. ebourg
Fix The object getters in DataConfiguration with no default value (i.e getURL(key)) now throw a NoSuchElementException if the flag throwExceptionOnMissing is set. ebourg
Add Generic get methods have been added to DataConfiguration (get(), getArray() and getList()) ebourg
Fix XMLConfiguration used to drop attributes when an element's value was a list. This has been fixed. Fixes CONFIGURATION-263. oheger
Add File configurations can now be saved to FTP URLs, or any other URL protocol supporting data output. Fixes CONFIGURATION-249. ebourg
Fix Fixed a potential issue in DatabaseConfiguration where an error on closing a statement would prevent the connection from being closed. Fixes CONFIGURATION-180. ebourg
Add Date objects are now supported in ASCII plist files. Fixes CONFIGURATION-261. ebourg
Update XMLPropertyListConfiguration no longer requires commons-digester and commons-beanutils to work. ebourg
Update Fixed INIConfiguration to handle the quoted values and the lines containing a value and a comment. ebourg

Release 1.4 – 2007-04-08

Type Changes By
Update MapConfiguration and the web-based configurations now treat strings that contain an escaped list delimiter correctly: The escape character will be removed, so that for instance "foo\,bar" becomes "foo,bar". Fixes CONFIGURATION-256. oheger
Update DatabaseConfiguration now handles list delimiters in property values correctly. Fixes CONFIGURATION-255. oheger
Update After cloning a XMLConfiguration there was still a connection to the original configuration. So when the clone was modified and then saved the content of the original configuration was written. This has now been fixed. Fixes CONFIGURATION-254. Thanks to Carsten Kaiser. oheger
Update Class loading in BeanHelper is now done using ClassUtils of Commons Lang. oheger
Add With ManagedReloadingStrategy a new reloading strategy for file-based configurations was added that can be triggered through JMX. Fixes CONFIGURATION-237. Thanks to Nicolas de Loof. oheger
Update The dependencies to Commons Lang, Commons Collections, and Commons Digester are updated to use the recent available version. However older versions will still work. oheger
Add A pom for maven 2 was added. oheger
Update ConfigurationUtils.getFile() now always checks first whether the passed in file name is absolute. If it is, this file will be returned. This prevents that on Unix under certain circumstances absolute file names are interpreted as relative ones. Fixes CONFIGURATION-252. oheger
Update The dependency to xml-apis was changed to the version 1.0.b2. The so far used version 2.0.2 is reported to be bogus. Fixes CONFIGURATION-251. oheger
Add In addition to configuration event listeners now so-called configuration error listeners are supported. These listeners are notified about internal errors that had been logged and swallowed by privious versions. The new enableRuntimeExceptions() method of ConfigurationUtils registers a special error listener at the passed in configuration that generates a runtime exception when an error event is received. Fixes CONFIGURATION-245. oheger
Add AbstractConfiguration now allows to set an instance specific logger using the setLogger() method. This gives clients more control over a configuration's logging behavior. oheger
Add SubsetConfiguration and CompositeConfiguration were updated to fully support an instance specific list delimiter. Concerning splitting of string properties that contain a list delimiter character, these classes now behave like a "normal" configuration. Fixes CONFIGURATION-155. oheger
Add Variable interpolation features have been improved. A variable can now have the form ${prefix:variableName} where the prefix defines the type of the variable. The standard types sys for system properties and const for constants are supported. Variables without a prefix are treated as references to other configuration properties (which is compatible to earlier versions). Fixes CONFIGURATION-192. oheger
Update Commons Configuration now depends on Commons Lang 2.2. Some features of Lang's new text package are used. oheger
Update The number of dependencies needed for DefaultConfigurationBuilder was reduced by letting some of the default configuration providers resolve their classes per reflection. Fixes CONFIGURATION-244. oheger
Update File-based configurations with a reloading strategy did not work well together with CombinedConfiguration because the reloading strategy is only checked when its associated configuration is accessed (which does not happen when only the combined configuration is queried). As a workaround CombinedConfiguration now provides the boolean forceReloadCheck property. If this is set to true, all contained configurations will be triggered when a property is queried. This will cause a reload if necessary. Fixes CONFIGURATION-240. oheger
Add Configuration declarations in the configuration definition file for DefaultConfigurationBuilder that are marked as optional now support a new attribute config-forceCreate. If this attribute is set to true and the initialization of the configuration fails, DefaultConfigurationBuilder tries to add an empty configuration of the correct type to the resulting combined configuration. Before this change optional configurations that caused errors were never added to the combined configuration. Fixes CONFIGURATION-243. oheger
Update CompositeConfiguration.clearProperty() now generates the correct update events. Fixes CONFIGURATION-241. oheger
Update The configuration returned by HierarchicalConfiguration.subset() performed variable interpolation only in the keys that belong to the subset. Now the parent configuration is searched, too, to resolve the value of the referenced property. This is consistent with the way SubnodeConfiguration works. Fixes CONFIGURATION-242. oheger
Update DefaultConfigurationBuilder now internally uses the standard expression engine for hierarchical configurations. So the dependency to Commons JXPath is no more needed when this class is used. Note that this change has some impact on existing code that manually sets properties before the combined configuration is created; this code must now be adapted to the changed syntax of property keys. Fixes CONFIGURATION-234. oheger
Add HierarchicalConfiguration and some of its sub classes now define a copy constructor. Fixes CONFIGURATION-236. oheger
Add A new configuration class for windows ini files was added. Fixes CONFIGURATION-197. Thanks to Trevor Charles Miller. oheger
Update For file-based configurations loaded by ConfigurationFactory the load() method was called before all of the properties specified by attributes of the XML element have been initialized. Now load() is called after property initialization. Fixes CONFIGURATION-229. oheger
Update Interpolation of non string values did not work when SubsetConfiguration was involved. This has now been fixed. Fixes CONFIGURATION-235. oheger
Update The compatibility of ConfigurationDynaBean with other configuration types than those that inherit from BaseConfiguration was improved. Fixes CONFIGURATION-227. oheger
Update The getList() method of CompositeConfiguration does now fully support variable interpolation. So it is possible to refer to a variable in one (sub) configuration that is defined in another configuration. Fixes CONFIGURATION-233. Thanks to Rainer Jung. oheger
Update XPathExpressionEngine used to create wrong keys for attribute nodes. This caused some operations on XMLConfiguration to fail when such an expression engine was set (e.g. reloading). Now correct keys for attributes are constructed. Fixes CONFIGURATION-230. oheger
Update Some of the methods of file-based hierarchical configurations (e.g. subset() or configurationAt()) did not take an eventually set reloading strategy into account. This is now fixed by overriding the internal fetchNodeList() method in AbstractHierarchicalFileConfiguration and letting it always check for a reload. Fixes CONFIGURATION-228. oheger

Release 1.3 – 2006-09-24

No changes in this release.

Release 1.3-rc2 – 2006-09-03

Type Changes By
Update 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
Update 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 configuration. Fixes CONFIGURATION-222. Thanks to Gabriele Garuglieri. oheger
Add 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
Update 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
Update DataConfiguration.getDateArray() used to ignore the format argument. This was fixed. Fixes CONFIGURATION-220. oheger
Update 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
Update 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
Add A new class PropertiesConfigurationLayout was introduced whose task is to preserve the structure (e.g. comments, blank 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
Add clone() methods have been added to BaseConfiguration, AbstractFileConfiguration, MapConfiguration, CompositeConfiguration, and CombinedConfiguration. So the most important Configuration implementations now support cloning. To ConfigurationUtils an utility method cloneConfiguration() was added that allows to conveniently clone a configuration. Fixes CONFIGURATION-145. oheger
Update 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
Update 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
Add The new class DefaultConfigurationBuilder was added as an alternative to ConfigurationFactory. It provides some more features and creates a CombinedConfiguration object oheger
Add The new class CombinedConfiguration was added as a hierarchical alternative to CompositeConfiguration. oheger
Add 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
Add A new method convertToHierarchical() was added to ConfigurationUtils, which is able to convert an arbitrary configuration object into a hierarchical configuration. oheger
Update 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
Update The dependency to dom4j was removed; it was only used by two test classes, which have been re-written. oheger
Update 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
Add Added two new constructors in CompositeConfiguration accepting a collection of configurations as a parameter. Fixes CONFIGURATION-178. ebourg
Add (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
Update 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
Add 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
Add 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 configurationAt() method of HierarchicalConfiguration returns such a SubnodeConfiguration for a specified sub node. oheger
Add 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
Add 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
Update 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 possible. Some methods dealing with Node objects have been deprecated and replaced by versions operating on ConfigurationNode objects instead. oheger
Update 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

No changes in this release.

Release 1.2-rc3 – 2005-12-07

Type Changes By
Update 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
Update The dependency to Commons Beanutils Collections was unnecessary and thus removed. oheger
Update 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
Update 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
Update 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
Update AbstractHierarchicalFileConfiguration, a new base class for file based hierarchical configurations, was introduced. XMLConfiguration now extends this class. ebourg, oheger
Update 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
Update 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
Update ConfigurationConverter.getProperties() now uses the delimiter of the specified configuration to convert the list properties into strings. Fixes CONFIGURATION-123. ebourg
Update 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
Update 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
Update JNDIConfiguration no longer logs an error when attempting to get a property that doesn't exist in the configuration. Fixes CONFIGURATION-44. ebourg
Update Attempting to load a configuration from a directory instead of a file will now throw a ConfigurationException. Fixes CONFIGURATION-99. ebourg
Update 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
Add 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
Update 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
Update 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
Update 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
Add 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
Update getKeys() in HierarchicalConfiguration now returns the keys in the same order the properties were inserted. Fixes CONFIGURATION-74. ebourg
Update Commons Configuration now depends on Commons Collections 3.1 instead of 3.0 ebourg
Add 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
Update 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
Add Added support for XMLPropertiesConfiguration in ConfigurationFactory. A <properties> element will generate a XMLPropertiesConfiguration if the filename ends with ".xml". ebourg
Add PropertiesConfiguration now supports escaped key/value separators in the keys (i.e foo\:key = bar). Fixes CONFIGURATION-184. ebourg
Add PropertiesConfiguration now supports all key/value separators supported by java.util.Properties ('=', ':' and white space characters). Fixes CONFIGURATION-166. ebourg
Update Commons Configuration now depends on Commons Lang 2.1 instead of 2.0 ebourg
Update Comment lines for PropertiesConfiguration can start with the '!' char (compatibility with java.util.Properties). Fixes CONFIGURATION-207. ebourg
Update 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
Add 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
Update 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
Update Updated XMLConfiguration to correctly deal with properties containing dots in their names. Such properties could not be accessed before. Fixes CONFIGURATION-85. oheger
Update 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
Update 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
Update 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
Update 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
Update 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
Update 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
Update 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
Update 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
Update 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
Update 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
Update XMLConfiguration now uses the delimiter set by setDelimiter(char). Thanks to Zsolt Koppany. ebourg

Release 1.1 – 2005-04-02

Type Changes By
Update Fixed a ConcurrentModificationException thrown when calling clear() on a SubsetConfiguration applied to a BaseConfiguration. Fixes CONFIGURATION-134. ebourg
Update 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
Update 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
Update Fixed a bug in FileChangedReloadingStrategy preventing the detection of a file change in some cases. ebourg
Update Changed getXXXArray() and getXXXList() in DataConfiguration to return an empty array/list for empty values. ebourg
Update 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
Add 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
Add 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
Add Added a comment header to PropertiesConfiguration. The header is not parsed when the file is loaded yet. Fixes CONFIGURATION-190. ebourg
Add Added the setEncoding(String) and the getEncoding() methods to the FileConfiguration interface to control the encoding of the configuration file. ebourg
Add 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
Update Merged 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
Update 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
Fix 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
Fix Calling getProperties on a JNDIConfiguration no longer throws an UnsupportedOperationException. ebourg
Remove Removed the getPropertyDirect method from AbstractConfiguration, concrete configurations now implement directly the getProperty method from the Configuration interface. ebourg
Add Added implementation of a save() method for HierarchicalXMLConfiguration. Fixes CONFIGURATION-187. oheger
Update Constructing a file based configuration with a File no longer throws an exception when the file doesn't exist. ebourg
Add Saving a configuration now creates the path to the file if it doesn't exist. ebourg
Update AbstractFileConfiguration.save(File) no longer fails silently when an error occurs, a ConfigurationException is thrown instead. Fixes CONFIGURATION-45. ebourg
Fix ConfigurationUtils.locate() now checks if the URL based resources exist. This fixes a bug preventing configuration files from being found if the configuration descriptor is in a JAR file (reported by Grant Ingersoll). ebourg
Fix Fixed NPE that were caused in the constructors of file based configurations if an invalid file name was specified. Fixes CONFIGURATION-96. oheger
Add 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
Fix JNDIConfiguration.getKeys() now returns an empty iterator instead of throwing a ConfigurationRuntimeException when a NamingException occurs. The NamingExceptions are now logged. ebourg
Fix DatabaseConfiguration.isEmpty() now returns true if an SQLException occurs. ebourg
Add Added two methods copy(Configuration, Configuration) and append(Configuration, Configuration) in ConfigurationUtils to copy properties between configurations. ebourg
Update Moved the constructors implementations from PropertiesConfiguration and XMLConfiguration to AbstractFileConfiguration. ebourg
Remove Remove deprecated getVector() implementations. epugh
Add File based configurations can now be automatically reloaded when the underlying file is modified. Fixes CONFIGURATION-147. ebourg
Add Added a clear() method to the Configuration interface to remove all properties. Fixes CONFIGURATION-156. ebourg
Add Added a SystemConfiguration wrapping the system properties. ConfigurationFactory recognizes the corresponding <system/> element. Fixes CONFIGURATION-208. ebourg
Add 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
Add The "autoSave" feature of XMLConfiguration has been generalized to all file based configurations. Fixes CONFIGURATION-146. ebourg
Add Numeric properties can now be specified in hexadecimal format, for example "number = 0xC5F0". Fixes CONFIGURATION-191. ebourg
Fix Fixed HierarchicalConfiguration.getKeys(String), it returned an empty iterator if the prefix string contained indices. Fixes CONFIGURATION-36. oheger
Add Added a DataConfiguration decorator providing getters for all useful types found in a configuration (URL, Locale, Date, Calendar, Color, lists and arrays) ebourg
Add 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
Fix The getStringArray() method in CompositeConfiguration now interpolates the strings. Fixes CONFIGURATION-66. ebourg
Fix SubsetConfiguration now shares the "throwExceptionOnMissing" property with its parent. Fixes CONFIGURATION-23. ebourg
Fix 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
Update All NamingEnumerations in JNDIConfiguraiton are now properly closed (Suggested by Eric Jung). ebourg
Fix 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
Update 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
Fix Replaced the calls to Boolean.booleanValue(boolean) in AbstractConfiguration and ConfigurationDynaBean to be Java 1.3 compatible. Fixes CONFIGURATION-22. ebourg
Fix Changing the prefix of a JNDIConfiguration will now reset the base context used. Fixes CONFIGURATION-112. ebourg
Add 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
Add Make the behavior 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 behavior of returning a null value has been restored. henning
Add Allow configurations extending AbstractConfiguration to change the delimiter used from "," to something else. Fixes CONFIGURATION-151. epugh
Fix PropertiesConfiguration.save() method has issues with preserving the filename epugh
Fix Test cases for HierarchicalConfigurationXMLReader stores comments as text nodes. Fixes CONFIGURATION-132. Thanks to Mark Woodman. epugh
Fix 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
Fix Fixed a ClassCastException when adding a non String property to an XMLConfiguration. Fixes CONFIGURATION-25. ebourg
Fix Fixed the handling of attribute properties by HierarchicalConfigurationConverter. Fixes CONFIGURATION-138. Thanks to Oliver Heger. ebourg
Fix Fixed a ClassCastException thrown on adding a non string property in a DatabaseConfiguration. Fixes CONFIGURATION-125. ebourg
Add 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 methods will be removed for 1.1. henning

Release 1.0-rc1 – 2004-08-14

Type Changes By
Add HierarchicalConfigurationXMLReader stores comments as text nodes. Fixes CONFIGURATION-132. Thanks to Oliver Heger. epugh
Add project.xml contains bad dependencies. Fixes CONFIGURATION-122. Thanks to Ricardo Gladwell. epugh
Add clearXmlProperty doesn't remove list properties completely. Fixes CONFIGURATION-64. Thanks to Brent Worden. epugh
Add new ConfigurationDynaBean. Fixes CONFIGURATION-183. Thanks to Ricardo Gladwell. epugh
Add new ConfigurationMap and ConfigurationSet. Fixes CONFIGURATION-185. Thanks to Ricardo Gladwell. epugh
Fix Problem adding property XMLConfiguration. Fixes CONFIGURATION-91. Thanks to Ricardo Gladwell. epugh
Remove ConfigurationXMLDocument removed until post 1.0. epugh
Fix DatabaseConfiguration doesn't support List properties. Fixes CONFIGURATION-18. epugh
Fix Fixed a bug related to XMLConfiguration. Can't add a new property as an attribute in XMLConfiguration. Fixes CONFIGURATION-137. ebourg
Fix Fixed a bug related to XMLConfiguration. XMLConfiguration doesn't support attribute names with a dot. Fixes CONFIGURATION-116. ebourg
Fix Fixed a bug related to XMLConfiguration. XMLConfiguration doesn't ignore comments. Fixes CONFIGURATION-4. ebourg
Fix Fixed a bug related to XMLConfiguration. XMLConfiguration.save() doesn't escape reserved characters. Fixes CONFIGURATION-32. ebourg
Add Added save methods in XMLConfiguration similar to PropertiesConfiguration to save the configuration to another file. Fixes CONFIGURATION-114. ebourg
Update 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
Add Added a save() method to PropertiesConfiguration and save(Writer out), save(OutputStream out), save(OutputStream out, String encoding) to BasePropertiesConfiguration. ebourg
Fix List values are now properly stored as comma separated values in the Properties object returned by ConfigurationConverter.getProperties(). Fixes CONFIGURATION-98. ebourg
Update 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
Fix Tokens like ${ref} in a PropertyConfiguration are now properly saved. Fixes CONFIGURATION-174. ebourg
Fix 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
Fix 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
Add Direct support of XML via DOM. New classes DOMConfiguration and HierarchicalDOMConfiguration. jschaible
Update Update build to not include test configuration files in resulting jar. jschaible
Update Refactored JNDIConfiguration to use AbstractConfiguration. ebourg
Update Fixed invalid subsets by refactoring out the subset logic into a SubsetConfiguration. Fixes CONFIGURATION-76. ebourg
Fix Reapply the ConfigurationXMLDocument that went missing during migration out of sandbox. oheger
Update Apply ASL 2.0 license. Thanks to Jeff Painter for scripting the conversion! epugh
Add 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
Update 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
Update Enhancement: Configuration Comparator. Fixes CONFIGURATION-154. epugh
Update BaseConfiguration: containsKey ignores default properties. I have changed it so that now the defaults are paid attention to. Fixes CONFIGURATION-54. epugh
Add The Configuration interface now supports BigDecimal and BigInteger numbers. ebourg
Add ConfigurationException is now thrown by public methods instead of Exception or IOException or whatnot. epugh
Add For configuration based on properties files, allow characters like \n etc to be escaped and unescaped. ebourg
Add 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
Add ConfigurationFactory now supports the hierarchicalDom4j element in configuration definition file oheger
Update Change all Vector objects to List objects. ebourg
Add 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
Update AbstractConfiguration addProperty now delegates to an abstract addPropertyDirect implemented by BaseConfiguration. oheger
Update Changed getString() method to throw a NoSuchElementException instead of "" if the configuration property doesn't exist. kshaposhnikov
Add Added AbstractConfiguration to make it easier to create subclasses by only having to implement the methods required. kshaposhnikov
Fix 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
Fix JNDIConfiguration.getKeys() Addition: The JNDIConfiguration.getKeys() method was returning an unsupported operation error. However, this is an important method to have supported. epugh
Fix CompositeConfiguration.getKeys() Fix The 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