Author: oheger
Date: Sat Jan 20 07:48:24 2007
New Revision: 498129
URL: http://svn.apache.org/viewvc?view=rev&rev=498129
Log:
Updated user guide for DefaultConfigurationBuilder to cover the new
forceReloadCheck property
Modified:
jakarta/commons/proper/configuration/trunk/xdocs/howto_configurationbuilder.xml
Modified:
jakarta/commons/proper/configuration/trunk/xdocs/howto_configurationbuilder.xml
URL:
http://svn.apache.org/viewvc/jakarta/commons/proper/configuration/trunk/xdocs/howto_configurationbuilder.xml?view=diff&rev=498129&r1=498128&r2=498129
==============================================================================
---
jakarta/commons/proper/configuration/trunk/xdocs/howto_configurationbuilder.xml
(original)
+++
jakarta/commons/proper/configuration/trunk/xdocs/howto_configurationbuilder.xml
Sat Jan 20 07:48:24 2007
@@ -294,7 +294,7 @@
</p>
<source><![CDATA[
<header>
- <result delimiterParsingDisabled="true">
+ <result delimiterParsingDisabled="true" forceReloadCheck="true">
<nodeCombiner
config-class="org.apache.commons.configuration.tree.OverrideCombiner"/>
<expressionEngine
config-class="org.apache.commons.configuration.tree.xpath.XPathExpressionEngine"/>
</result>
@@ -315,7 +315,7 @@
]]></source>
<p>
The <code>result</code> element points to the bean declaration for the
- resulting combined configuration. In this example we set an attribute
+ resulting combined configuration. In this example we set some attributes
and initialize the node combiner (which is not necessary because the
default override combiner is specified) and the expression engine to be
used. Note that the <code>config-class</code> attribute makes it
@@ -340,7 +340,7 @@
<!-- Test configuration definition file that demonstrates complex
initialization -->
<configuration>
<header>
- <result delimiterParsingDisabled="true">
+ <result delimiterParsingDisabled="true" forceReloadCheck="true">
<expressionEngine
config-class="org.apache.commons.configuration.tree.xpath.XPathExpressionEngine"/>
</result>
<combiner>
@@ -366,7 +366,19 @@
</configuration>
]]></source>
<p>
- This configuration definition file includes four configuration sources.
+ This configuration definition file includes four configuration sources
and
+ sets some properties for the resulting
<code>CombinedConfiguration</code>.
+ Of special interest is the <code>forceReloadCheck</code> property, which
+ enables a special check for detecting property changes in the contained
+ configuration sources. If this property is not set, reloading won't work.
+ Because we have configured a reloading strategy for one of the included
+ configuration sources we have to set this flag so that this reloading
+ strategy can function properly. More details about this topic can be
+ found in the Javadocs for
+ <code><a
href="apidocs/org/apache/commons/configuration/CombinedConfiguration.html">
+ CombinedConfiguration</a></code>.
+ </p>
+ <p>
With the following code we can create a
<code>DefaultConfigurationBuilder</code>
and load this file:
</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
