You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by oh...@apache.org on 2007/01/20 16:48:25 UTC
svn commit: r498129 -
/jakarta/commons/proper/configuration/trunk/xdocs/howto_configurationbuilder.xml
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: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org