Author: chtompki
Date: Tue Oct 23 16:54:43 2018
New Revision: 1844676
URL: http://svn.apache.org/viewvc?rev=1844676&view=rev
Log:
Re-commit RELEASE-NOTES.txt
Added:
commons/proper/configuration/branches/RELEASE_2_4_BRANCH/RELEASE-NOTES.txt
Removed:
commons/proper/configuration/branches/RELEASE_2_4_BRANCH/RELEASE-NOTES.txt.bak
Added:
commons/proper/configuration/branches/RELEASE_2_4_BRANCH/RELEASE-NOTES.txt
URL:
http://svn.apache.org/viewvc/commons/proper/configuration/branches/RELEASE_2_4_BRANCH/RELEASE-NOTES.txt?rev=1844676&view=auto
==============================================================================
--- commons/proper/configuration/branches/RELEASE_2_4_BRANCH/RELEASE-NOTES.txt
(added)
+++ commons/proper/configuration/branches/RELEASE_2_4_BRANCH/RELEASE-NOTES.txt
Tue Oct 23 16:54:43 2018
@@ -0,0 +1,779 @@
+ Commons Configuration Package
+ Version 2.4
+ Release Notes
+
+
+INTRODUCTION:
+=============
+
+This document contains the release notes for this version of the Commons
+Configuration component. It describes the changes since the previous version.
+The Commons Configuration software library provides a generic configuration
+interface which enables an application to read configuration data from a
variety
+of sources.
+
+Tools to assist in the reading of configuration/preferences files in
+various formats
+
+Minor release with new features and updated dependencies.
+
+Changes in this version include:
+
+NEW FEATURES
+============
+
+o CONFIGURATION-712: 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. Thanks to Rolland Hobbie.
+o CONFIGURATION-713: Configuration properties can now be converted to regular
expressions. Thanks to Lars W.
+o CONFIGURATION-715: 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. Thanks to Patrick Schmidt.
+o CONFIGURATION-716: JupIOFactory (introduced for CONFIGURATION-715) also
implements
+ handling of escape sequences in a way closer to
java.util.Properties. Thanks to Patrick Schmidt.
+o CONFIGURATION-724: Add support for Commons Text 1.4 localhost string lookup
as a default lookup.
+o CONFIGURATION-726: Add support for Commons Text 1.5 new string lookups as
default lookups.
+
+FIXED BUGS
+==========
+
+o CONFIGURATION-710: Fixed numerous typos in user guides. Thanks to thc202.
+o CONFIGURATION-711: Update Apache Commons Lang from 3.7 to 3.8.1.
+o CONFIGURATION-727: org.apache.commons.configuration2.DatabaseConfiguration
never closes result sets and statements.
+
+CHANGES
+=======
+
+o CONFIGURATION-720: Replace use of deprecated Commons Lang string
substitution code for Commons Text.
+o CONFIGURATION-694: Update Java requirement from version 7 to 8.
+o CONFIGURATION-721: Update Jackson from 2.9.6 to 2.9.7.
+o CONFIGURATION-722: Update optional dependency snakeyaml from 1.21 to 1.23.
+o CONFIGURATION-723: Update optional Spring dependencies from 4.3.18.RELEASE
to 4.3.19.RELEASE.
+o CONFIGURATION-725: Update Apache Commons Text from 1.4 to 1.5.
+o CONFIGURATION-728: Update Apache Commons Text from 1.5 to 1.6.
+
+
+Historical list of changes:
http://commons.apache.org/proper/commons-configuration/changes-report.html
+
+For complete information on Apache Commons Configuration, including
instructions on how to submit bug reports,
+patches, or suggestions for improvement, see the Apache Apache Commons
Configuration website:
+
+http://commons.apache.org/proper/commons-configuration/
+
+
+Older release notes
+===================
+
+ Apache Commons Configuration
+ Version 2.3
+ Release Notes
+
+
+INTRODUCTION:
+=============
+
+This document contains the release notes for this version of the Commons
+Configuration component. It describes the changes since the previous version.
+The Commons Configuration software library provides a generic configuration
+interface which enables an application to read configuration data from a
+variety of sources.
+
+Version 2.3 is another maintenance release for the Configuration 2.x series. It
+contains bug fixes and also a few new features like support for File and Path
+as data types. The release is fully source and binary compatible with version
+2.2.
+
+Commons Configuration 2.3 requires Java 1.7 or higher.
+
+New features
+============
+o CONFIGURATION-692
+ ConversionExceptions thrown when accessing the properties of a configuration
+ now contain the original cause of the exception.
+
+o CONFIGURATION-693
+ Configuration properties can now be converted to the data types File and
+ Path.
+
+o CONFIGURATION-698
+ Add org.apache.commons.configuration2.MapConfiguration.toString().
+
+o CONFIGURATION-698
+ Add toString() methods here and there to help debugging.
+
+o CONFIGURATION-701
+ CompositeConfiguration now supports an addConfigurationFirst() method to add
+ child configurations with a higher priority.
+
+Fixed Bugs
+==========
+o CONFIGURATION-652
+ Root node attributes are now updated correctly when loading XML configuration
+ files.
+
+o CONFIGURATION-686
+ JSONConfiguration can now handle list structures with complex objects as
+ elements.
+
+o CONFIGURATION-687
+ 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.
+
+o CONFIGURATION-688
+ Fixed a bug related to the handling of multiple include files in
+ PropertiesConfiguration.
+
+o CONFIGURATION-690
+ ExprLookup.getVariables() no longer returns null, but a copy of the current
+ variables of this lookup object.
+
+o CONFIGURATION-691
+ ExprLookup now handles expressions that do not return a string result by
+ converting them to string.
+
+o CONFIGURATION-703
+ XMLConfiguration now handles elements correctly whose value consists only of
+ whitespace if the xml:space attribute is set to preserve.
+
+Other changes
+=============
+o CONFIGURATION-675
+ Added a .gitignore file to the project.
+
+o Some dependencies have been updated to their most recent versions. However,
+ as no new features of these dependencies are used, the older versions should
+ still work. The following dependencies are affected:
+ o Update Apache Commons Lang dependency from 3.6 to 3.7.
+ o Update Apache Commons VFS from 2.1 to 2.2.
+ o Update Apache Commons Codec from 1.10 to 1.11.
+ o Update Spring from 4.3.9.RELEASE to 4.3.18.RELEASE
+ o Update optional dependency snakeyaml from 1.18 to 1.21.
+ o Update optional dependency Jackson from 2.8.9 to 2.9.6.
+
+
+Historical list of changes:
http://commons.apache.org/proper/commons-configuration/changes-report.html
+
+For complete information on Apache Commons Configuration, including
instructions on how to submit bug reports,
+patches, or suggestions for improvement, see the Apache Apache Commons
Configuration website:
+
+http://commons.apache.org/proper/commons-configuration/
+
+ Apache Commons Configuration
+ Version 2.2
+ Release Notes
+
+
+INTRODUCTION:
+=============
+
+This document contains the release notes for this version of the Commons
+Configuration component. It describes the changes since the previous version.
+The Commons Configuration software library provides a generic configuration
+interface which enables an application to read configuration data from a
+variety of sources.
+
+Version 2.2 is another maintenance release for the Configuration 2.x series. It
+contains a number of bug fixes and also some new features. Among the highlights
+is the new support for JSON and YAML configurations. The release is fully
+source and binary compatible with version 2.1.1.
+
+Commons Configuration 2.2 requires Java 1.7 or higher.
+
+New features
+============
+o CONFIGURATION-666
+ Add convenience ctor ConfigurationRuntimeException(String, Object...).
+
+o CONFIGURATION-665
+ Add
org.apache.commons.configuration2.AbstractHierarchicalConfiguration.toString().
+
+o CONFIGURATION-664
+ Add API
org.apache.commons.configuration2.tree.ImmutableNode.getChildren(String).
+
+o CONFIGURATION-660
+ Add toString() methods here and there to help debugging.
+
+o CONFIGURATION-658
+ Add API org.apache.commons.configuration2.DataConfiguration.getURI(String)
+ methods.
+
+o CONFIGURATION-656
+ Added new YAMLConfiguration class to support configuration files in YAML
+ format.
+
+o CONFIGURATION-653
+ ConfigurationUtils and ConfigurationConverter now offer better support for
+ immutable configurations.
+
+o CONFIGURATION-647
+ INIConfiguration can now be configured to use a custom separator between
+ properties and values when writing an ini file.
+
+o CONFIGURATION-258
+ Added new JSONConfiguration class to support configuration files in JSON
+ format.
+
+Fixed Bugs
+==========
+o CONFIGURATION-671
+ Fixed a NPE in INIConfiguration when saving a configuration with an empty
+ section.
+
+o CONFIGURATION-669
+ The node model returned by SubnodeConfiguration.getNodeModel() has now the
+ correct root node set.
+
+Other changes
+=============
+o CONFIGURATION-673
+ Added an Automatic-Module-Name header to the manifest for compatibility with
+ the Java 9 module system.
+
+o CONFIGURATION-669
+ Update optional Spring dependency from 4.2.5.RELEASE to 4.3.9.RELEASE.
+
+o CONFIGURATION-667
+ Update Apache Commons Lang dependency from 3.3.2 to 3.6.
+
+o CONFIGURATION-663
+ Fixed a typo in the upgrade to 2.0 guide.
+
+o CONFIGURATION-661
+ Update platform requirement from Java 6 to 7.
+
+
+Historical list of changes:
http://commons.apache.org/proper/commons-configuration/changes-report.html
+
+For complete information on Apache Commons Configuration, including
instructions on how to submit bug reports,
+patches, or suggestions for improvement, see the Apache Apache Commons
Configuration website:
+
+http://commons.apache.org/proper/commons-configuration/
+
+
+ Apache Commons Configuration
+ Version 2.1.1
+ Release Notes
+
+
+INTRODUCTION:
+=============
+
+This document contains the release notes for this version of the Commons
+Configuration component. It describes the changes since the previous version.
+The Commons Configuration software library provides a generic configuration
+interface which enables an application to read configuration data from a
+variety of sources.
+
+The release is fully source and binary compatible with version 2.1.
+
+Commons Configuration 2.1 requires Java 1.6 or higher.
+
+Fixed Bugs
+==========
+o CONFIGURATION-649
+ 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.
+
+o CONFIGURATION-648
+ 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.
+
+o CONFIGURATION-646
+ PropertiesConfiguration now works correctly with the auto-save mode.
+
+o CONFIGURATION-644
+ PropertiesConfigurationLayout no longer duplicates a header comment if a file
+ with another comment is loaded. Thanks to Andrew DeMaria.
+
+o CONFIGURATION-643
+ Documentation improvements for the user's guide.
+
+o CONFIGURATION-641
+ 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.
+
+o CONFIGURATION-640
+ PropertiesConfiguration now correctly unescapes some special characters that
+ are always escaped in Java properties files.
+
+Other changes
+=============
+o CONFIGURATION-639
+ In the OSGi bundle manifest of the Commons Configuration bundle the package
+ imports for Spring packages are now marked as optional.
+ Thanks to Rico Neubauer.
+
+o CONFIGURATION-638
+ Improved handling of temporary files and folders in unit tests.
+ Thanks to Ahmet Celik.
+
+o CONFIGURATION-627
+ 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.
+
+
+Historical list of changes:
http://commons.apache.org/proper/commons-configuration/changes-report.html
+
+For complete information on Apache Commons Configuration, including
instructions on how to submit bug reports,
+patches, or suggestions for improvement, see the Apache Apache Commons
Configuration website:
+
+http://commons.apache.org/proper/commons-configuration/
+
+
+ Commons Configuration Package
+ Version 2.1
+ Release Notes
+
+INTRODUCTION
+============
+
+This document contains the release notes for this version of the Commons
+Configuration component. It describes the changes since the previous version.
+The Commons Configuration software library provides a generic configuration
+interface which enables an application to read configuration data from a
variety
+of sources.
+
+Version 2.1 is a first bug-fix release for the Configuration 2.x series and
+also adds a new feature related to the integration with the Spring framework.
+A list of all changes can be found below.
+
+The release is fully source and binary compatible with version 2.0.
+
+Commons Configuration 2.1 requires Java 1.6 or higher.
+
+New Features
+============
+o CONFIGURATION-636
+ PropertiesConfigurationLayout now allows manipulating the order of keys when
+ the properties file is written.
+
+o CONFIGURATION-624
+ Support Commons Configuration as PropertySource in Spring.
+
+Fixed Bugs
+==========
+o CONFIGURATION-634
+ HomeDirectoryLocationStrategy now works correctly in the mode that evaluates
+ the FileLocator's base path.
+
+o CONFIGURATION-633
+ Interpolation was improved to better support properties with multiple values.
+
+o CONFIGURATION-632
+ The methods getStringArray() and getList() of CompositeConfiguration now
+ support the interpolation of variables that reference properties with
+ multiple values.
+
+o CONFIGURATION-622
+ 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.
+
+Other changes
+=============
+o CONFIGURATION-628
+ Support for the ant build was dropped.
+
+o CONFIGURATION-626
+ ImmutableConfiguration.getArray() has been deprecated. Arrays can now be
+ queried using the generic get() method in a type-safe way.
+
+o CONFIGURATION-631
+ Updated optional dependency to Apache Commons VFS from 2.0 to 2.1. (The older
+ version still works.)
+
+o CONFIGURATION-635
+ Updated optional dependency to Apache Commons Codec from 1.9 to 1.10. (The
+ older version still works.)
+
+
+Historical list of changes:
http://commons.apache.org/proper/commons-configuration/changes-report.html
+
+For complete information on Apache Commons Configuration, including
instructions
+on how to submit bug reports, patches, or suggestions for improvement, see the
+Apache Commons Configuration website:
+http://commons.apache.org/proper/commons-configuration/
+
+ Commons Configuration Package
+ Version 2.0
+ Release Notes
+
+INTRODUCTION
+============
+
+After a series of alpha and beta releases (please consult the corresponding
+release notes below), this is the first final release for Apache Commons
+Configuration 2.0.
+
+Version 2.0 is a complete redesign of the Configuration 1.x API with the aim to
+fix some limitations in the original design and make the library more flexible
+and powerful. Therefore, this release is not a drop-in replacement for Commons
+Configuration 1.x; there have been incompatible changes in many areas that
+require adaptations on client code. A migration guide is available at
+
+http://commons.apache.org/configuration/userguide/upgradeto2_0.html
+
+that describes all breaking changes and helps when upgrading to the new
+version. One obvious breaking change is the renaming of the main package
+(all classes are now located under org.apache.commons.configuration2) and the
+Maven coordinates (groupId: org.apache.commons, artifactId:
+commons-configuration2). This was necessary to allow both versions to coexist
+on the classpath without conflicts.
+
+The user's guide has been completely reworked to describe all features of the
+new version. It can be found at
+
+http://commons.apache.org/configuration/userguide/user_guide.html
+
+Changes:
+========
+o CONFIGURATION-621:
+ Moved ConfigurationLogger class to io package to avoid cyclic dependencies
+ between packages.
+o CONFIGURATION-619:
+ CombinedConfigurationBuilder now supports inheritance of its parameters to
+ child configuration sources. This is enabled by default.
+o CONFIGURATION-615:
+ 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.
+
+Fixed Bugs:
+===========
+o CONFIGURATION-620:
+ Fixed two invalid examples in the user's guide for file-based configurations.
+o CONFIGURATION-618:
+ 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.
+
+Commons Configuration 2.0 requires Java 1.6 or higher.
+
+ Commons Configuration Package
+ Version 2.0-beta2
+ Release Notes
+
+After the first beta release in June 2015 there has been some feedback from the
+community resulting in (minor) adaptations of the API. In most cases, the
+return values of methods have been changed to be more generic. There has also
+been a change in the support for logging. Therefore, this second beta release
+is provided to make these changes more "official".
+
+This release also includes some bug fixes. The bugs addressed here have partly
+existed already in the Configuration 1.0 code base; so these fixes are not all
+related to changes introduced in the 2.0 version.
+
+Below is a list of all changes in this version. Please refer to the clirr
+report at
http://commons.apache.org/proper/commons-configuration/clirr-report.html
+for information about changes which break binary compatibility.
+
+Changes:
+========
+o CONFIGURATION-614:
+ 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.
+o CONFIGURATION-612:
+ The return type of ConfigurationBuilder.getConfiguration() was changed from
+ Configuration to ImmutableConfiguration because this is the base interface
+ for all configuration objects. Thanks to Jon Weygand.
+o CONFIGURATION-608:
+ Adapted the return type of
ReloadingFileBasedConfigurationBuilder.configure().
+
+Fixed Bugs:
+===========
+o CONFIGURATION-609:
+ Fixed a bug in PropertiesConfiguration related to the loading of include
+ files. The FileHandler used for this purpose was not fully initialized.
+o CONFIGURATION-605:
+ XMLConfiguration no longer drops keys when list delimiter characters occur
+ in element values.
+o CONFIGURATION-604:
+ 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.
+
+Commons Configuration 2.0-beta2 requires Java 1.6 or higher.
+
+Historical list of changes:
http://commons.apache.org/proper/commons-configuration/changes-report.html
+
+For complete information on Apache Commons Configuration, including
instructions
+on how to submit bug reports, patches, or suggestions for improvement, see the
+Apache Commons Configuration website:
+http://commons.apache.org/proper/commons-configuration/
+
+ Commons Configuration Package
+ Version 2.0-beta1
+ Release Notes
+
+This is the first beta release of Commons Configuration 2.0 after two alpha
+versions. There has not been much feedback so far and no requests for API
+changes. Therefore, we move forwards to a beta release indicating that the API
+can be considered more stable. However, at this stage, changes of the API can
+still not be fully excluded.
+
+Below is a list of all changes in this version. Compared to version 2.0-alpha2,
+there has only be a single change: an obsolete interface (which had been
+overlooked during a major refactoring) was removed. So applications that are
+using 2.0-alpha2 should be able to migrate to 2.0-beta1 without problems.
+
+Changes:
+========
+o CONFIGURATION-598: Removed obsolete ConfigurationBuilder interface in the
+ base package.
+
+
+ Commons Configuration Package
+ Version 2.0-alpha2
+ Release Notes
+
+
+After version 2.0-alpha1 has been out for a while (the corresponding release
+notes can be found below), this second alpha release contains a few number of
+improvements and new features whose implementation required some changes on
+existing interfaces. In most cases, new methods were added offering enhanced
+functionality. Because these are typically interfaces implemented by the
+library itself client code using the previous alpha version should hardly be
+affected.
+
+Below is a list of all changes in this version:
+
+New features:
+=============
+o CONFIGURATION-574: 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.
+o CONFIGURATION-565: Added support for querying encoded properties.
+o CONFIGURATION-200: A size() method was added to the ImmutableConfiguration
interface.
+
+Fixed Bugs:
+===========
+o CONFIGURATION-564: 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.
+o CONFIGURATION-427: XMLPropertyListConfiguration can now save arrays in the
correct form.
+
+Historical list of changes:
http://commons.apache.org/proper/commons-configuration/changes-report.html
+
+For complete information on Apache Commons Configuration, including
instructions on how to submit bug reports,
+patches, or suggestions for improvement, see the Apache Commons Configuration
website:
+
+http://commons.apache.org/proper/commons-configuration/
+
+ Commons Configuration Package
+ Version 2.0-alpha1
+ Release Notes
+
+This is the first alpha release for version 2.0 of Commons Configuration.
+Version 2 is a major redesign of the Configuration API. It breaks compatibility
+in many areas and, therefore, is not a drop-in replacement for Commons
+Configuration 1.x. To allow collaboration with an older version of the library
+(and to prevent jar and dependency hell), the top-level package and the Maven
+coordinates have been changed. There is an upgrade guide available at
+
+http://commons.apache.org/configuration/userguide/upgradeto2_0.html
+
+describing the most important breaking changes. Be sure to read this
+document if you want to switch from a 1.x version to this new version. The
+user's guide which can be found at
+
+http://commons.apache.org/configuration/userguide/user_guide.html
+
+has been reworked to cover all the new and changed features.
+
+The main purpose of this alpha release is to gather feedback from the
+community about the reworked API. IT IS NOT YET PRODUCTION READY. It is
+expected that there will still be some changes on the public API.
+
+Below is a list of all changes in this version:
+
+New features:
+=============
+o CONFIGURATION-579: A migration guide has been created which supports when
upgrading from
+ version 1.x to 2.0.
+o CONFIGURATION-559: It is now possible to define default values for
initialization
+ properties of configurations.
+o CONFIGURATION-551: 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.
+o CONFIGURATION-550: Conversion to Character is now supported.
+o CONFIGURATION-541: Multi-file configurations are no longer restricted to
XML configuration
+ files. Arbitrary file-based configurations are now
supported.
+o CONFIGURATION-535: DatabaseConfiguration now provides get methods for
querying its
+ properties defining the underlying database structures.
+o CONFIGURATION-533: DatabaseConfiguration now automatically converts CLOBs
to strings if
+ they appear in property values.
+o CONFIGURATION-525: 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.
+o CONFIGURATION-519: Configuration objects are now created via configuration
builders. A new
+ API for configuration builders has been added.
+o CONFIGURATION-517: Hierarchical configurations now provide methods to
obtain sub
+ configurations for all child elements of a given key.
+o CONFIGURATION-514: Bean declarations now support constructor invocations.
+o CONFIGURATION-512: It is now possible to obtain an immutable view on a
Configuration or
+ HierarchicalConfiguration object. New interfaces,
+ ImmutableConfiguration, and
ImmutableHierarchicalConfiguration have
+ been introduced.
+o CONFIGURATION-508: 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.
+o CONFIGURATION-204: With the new reloading mechanism automatic and periodic
reloading checks
+ can be performed.
+o CONFIGURATION-202: Reloading checks can now be performed in a background
thread.
+
+Fixed Bugs:
+===========
+o CONFIGURATION-582: Fixed a StringIndexOutOfBoundsException in
PropertiesConfigurationLayout
+ which was caused by lines containing only whitespace.
+o CONFIGURATION-572: When a CombinedConfiguration is cleared it removes
itself as change
+ listener from all child configurations. This fixes a
possible memory
+ leak.
+o CONFIGURATION-570: Fixed a possible ConcurrentModificationException when a
SystemConfiguration
+ instance is passed to the append() or copy() methods.
+o CONFIGURATION-567: XMLBeanDeclaration now escapes node names before they
are used to
+ determine nested properties. Thanks to Shen liang.
+
+Changes:
+o CONFIGURATION-591: Removed methods from ConfigurationConverter related to
ExtendedProperties.
+ This class is no longer supported by recent versions of
Commons
+ Collections.
+o CONFIGURATION-590: Removed Serializable interface from all configuration
implementations.
+ Some configuration classes declared this interface
without being
+ actually serializable.
+o CONFIGURATION-588: 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.
+o CONFIGURATION-584: 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.
+o CONFIGURATION-578: The user's guide has been fully reworked to cover all
new and enhanced
+ features of version 2.0.
+o CONFIGURATION-577: The dependency to Commons Collections is no longer
needed.
+o CONFIGURATION-576: 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.
+o CONFIGURATION-575: Hierarchical configurations now operate on immutable
structures.
+ Data is no longer represented by ConfigurationNode
objects. The
+ ImmutableNode class now serves as data container.
+o CONFIGURATION-573: XPathExpressionEngine can now deal with namespace
prefixes in node and
+ attribute names.
+o CONFIGURATION-563: The DefaultExpressionEngine class is now immutable. An
instance can be
+ shared between multiple configuration objects.
+o CONFIGURATION-562: Improved the API of ExprLookup.
+o CONFIGURATION-555: 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.
+o CONFIGURATION-554: 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.
+o CONFIGURATION-553: The code for accessing configuration files has 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.
+o CONFIGURATION-546: BeanHelper can now process BeanDefinitions initializing
properties of
+ collection types of their target beans. Thanks to Justin
Couch.
+o CONFIGURATION-544: Added missing dependencies to build.xml. Thanks to
Oliver Kopp.
+o CONFIGURATION-542: 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.
+o CONFIGURATION-540: 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.
+o CONFIGURATION-539: The deprecated INIConfiguration class was removed.
+ HierarchicalINIConfiguration was renamed to
INIConfiguration.
+o CONFIGURATION-537: The deprecated ConfigurationFactory class was removed.
+o CONFIGURATION-536: 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.
+o CONFIGURATION-534: The includesAllowed property of PropertyConfiguration is
now independent
+ from the existence of a base path.
+o CONFIGURATION-530: 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.
+o CONFIGURATION-527: AbstractConfiguration.clearPropertyDirect() is now
abstract. Thanks to Matthias Richter.
+o CONFIGURATION-526: XMLPropertiesConfiguration now supports loading from and
saving to DOM
+ nodes. Thanks to Oliver Kopp.
+o CONFIGURATION-524: Interpolation now works correctly after a configuration
was cloned.
+ The ConfigurationInterpolator instance is now cloned,
too.
+o CONFIGURATION-521: ConfigurationUtils.fileFromUrl() now correctly handles
URL containing
+ encoded percent characters. Thanks to Oliver Kopp.
+o CONFIGURATION-520: Support for reloading of configuration data has been
reworked.
+o CONFIGURATION-518: 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.
+o CONFIGURATION-516: PropertiesConfiguration no longer escapes double quotes
on saving.
+o CONFIGURATION-515: The visibility of some internal methods of
PropertiesConfiguration.PropertiesWriter
+ has been increased to protected. This simplifies the
implementation of
+ a custom escaping strategy.
+o CONFIGURATION-513: HierarchicalConfiguration is now an interface. The base
implementation
+ class is named BaseHierarchicalConfiguration.
+o CONFIGURATION-506: Removed obsolete nested classes Node and NodeVisitor of
+ HierarchicalConfiguration. The related deprecated class
+ ConfigurationKey was removed, too.
+o CONFIGURATION-505: 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.
+o CONFIGURATION-504: 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.
+o CONFIGURATION-500: XMLConfiguration now adds attributes of elements
defining a list to
+ all list nodes.
+o CONFIGURATION-496: Concurrent access to configurations and reloading have
been completely
+ redesigned. This should reduce the amount of
synchronization.
+o CONFIGURATION-486: 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.
+o CONFIGURATION-462: Updated dependency to Commons Lang from version 2.6 to
3.1.
+o CONFIGURATION-419: EventSource is now an interface. With BaseEventSource
there is a
+ default implementation.
+o CONFIGURATION-418: 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.
+o CONFIGURATION-330: Concurrent access to configurations has been reworked.
+o CONFIGURATION-153: It is now possible to define the strategy used for
locating
+ configuration files.
+o CONFIGURATION-136: Reloading can no longer corrupt a configuration
instance. This is now
+ handled by a configuration builder; the original
configuration instance
+ is not modified.
+o CONFIGURATION-26: 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.
+
+
+Historical list of changes:
http://commons.apache.org/proper/commons-configuration/changes-report.html
+
+For complete information on Apache Commons Configuration, including
instructions on how to submit bug reports,
+patches, or suggestions for improvement, see the Apache Commons Configuration
website:
+
+http://commons.apache.org/proper/commons-configuration/
