Author: oheger
Date: Wed Aug 13 20:15:51 2014
New Revision: 1617828
URL: http://svn.apache.org/r1617828
Log:
Extended chapter about CombinedConfigurationBuilder.
Described how Configurations can be used to simplify the creation of a builder
for simple use cases.
Modified:
commons/proper/configuration/trunk/src/site/xdoc/userguide/howto_combinedbuilder.xml
Modified:
commons/proper/configuration/trunk/src/site/xdoc/userguide/howto_combinedbuilder.xml
URL:
http://svn.apache.org/viewvc/commons/proper/configuration/trunk/src/site/xdoc/userguide/howto_combinedbuilder.xml?rev=1617828&r1=1617827&r2=1617828&view=diff
==============================================================================
---
commons/proper/configuration/trunk/src/site/xdoc/userguide/howto_combinedbuilder.xml
(original)
+++
commons/proper/configuration/trunk/src/site/xdoc/userguide/howto_combinedbuilder.xml
Wed Aug 13 20:15:51 2014
@@ -182,6 +182,21 @@ CombinedConfiguration config = builder.g
making use of the <code>definitionBuilder</code> property allows at least
passing in a specially configured builder object.
</p>
+ <p>
+ If you do not need any specific initialization and just want to read the
+ configuration definition from an XML document, the
+ <code><a
href="../apidocs/org/apache/commons/configuration/builder/fluent/Configurations.html">
+ Configurations</a></code> helper class introduced in section
+ <a href="howto_filebased.html#Making_it_easier">Making it easier</a> is
+ made for you. It offers convenience methods for creating a builder for
+ combined configurations from various sources. Here is an example how a
+ builder can be constructed from a definition file specified as a file
+ path:
+ </p>
+ <source><![CDATA[
+Configurations configs = new Configurations();
+CombinedConfigurationBuilder builder =
configs.combinedBuilder("path/to/definition/file.xml");
+]]></source>
</subsection>
<subsection name="Overriding properties">
