commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ohe...@apache.org
Subject svn commit: r1617828 - /commons/proper/configuration/trunk/src/site/xdoc/userguide/howto_combinedbuilder.xml
Date Wed, 13 Aug 2014 20:15:51 GMT
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">



Mime
View raw message