Added new event type CONFIGURATION_REQUEST.

Events of this type are generated each time a builder's getConfiguration()
method is called. A use case is that a listener might invalidate the
managed configuration based on some conditions before it is actually
accessed.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1597286 13f79535-47bb-0310-9956-ffa450edef68
Added a new builder event type.

The event ConfigurationBuilderResultCreatedEvent is now generated every time a
new result object of the builder is created.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1597287 13f79535-47bb-0310-9956-ffa450edef68
Added ReloadingBuilderSupportListener class.

This is an internally used helper class which adds support for reloading to an
arbitrary BasicConfigurationBuilder by associating it with a reloading
controller.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1597288 13f79535-47bb-0310-9956-ffa450edef68
ReloadingFileBasedConfigurationBuilder now uses ReloadingBuilderSupportListener.

The implementation could be simplified because functionality is already
provided by the generic reloading listener class.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1597289 13f79535-47bb-0310-9956-ffa450edef68
Added connectToReloadingController() to BasicConfigurationBuilder.

This method allows enabling reloading facilities to an arbitrary configuration
builder.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1597290 13f79535-47bb-0310-9956-ffa450edef68
Made methods for adding and removing event listeners final.

Sub classes need to invoke these methods during construction time - and a
constructor should not invoke non-final methods. Also, it really makes
sense to have these methods final as the default implementation should be
sufficient and not changed by derived classes.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1597292 13f79535-47bb-0310-9956-ffa450edef68
ReloadingFileBasedConfigurationBuilder now uses the connectToReloadingController() method.

This functionality from the base class can be used directly.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1597293 13f79535-47bb-0310-9956-ffa450edef68
Extended the chapter about reloading in the user guide.

Described reloading support for arbitrary configuration builders and reloading
checks triggered on access to the managed configuration.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1597294 13f79535-47bb-0310-9956-ffa450edef68
Added a sub section about managed reloading to the reloading chapter.

This is an adapted version of the original documentation about the managed
reloading strategy supported in version 1.x.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1597295 13f79535-47bb-0310-9956-ffa450edef68
[CONFIGURATION-520] Updated changes.xml.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1597296 13f79535-47bb-0310-9956-ffa450edef68
[CONFIGURATION-559] Updated changes.xml.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1597297 13f79535-47bb-0310-9956-ffa450edef68
[CONFIGURATION-519] Updated changes.xml.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1597298 13f79535-47bb-0310-9956-ffa450edef68
Missing svn properties.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/configuration/trunk@1597306 13f79535-47bb-0310-9956-ffa450edef68