svn commit: r1078288 - /commons/sandbox/digester3/trunk/src/site/xdoc/guide/dvsd3.xml

[si...@apache.org]

Author: simonetripodi
Date: Sat Mar  5 14:12:42 2011
New Revision: 1078288

URL: http://svn.apache.org/viewvc?rev=1078288&view=rev
Log:
added optimization description

Modified:
    commons/sandbox/digester3/trunk/src/site/xdoc/guide/dvsd3.xml

Modified: commons/sandbox/digester3/trunk/src/site/xdoc/guide/dvsd3.xml
URL: http://svn.apache.org/viewvc/commons/sandbox/digester3/trunk/src/site/xdoc/guide/dvsd3.xml?rev=1078288&r1=1078287&r2=1078288&view=diff
==============================================================================
--- commons/sandbox/digester3/trunk/src/site/xdoc/guide/dvsd3.xml (original)
+++ commons/sandbox/digester3/trunk/src/site/xdoc/guide/dvsd3.xml Sat Mar  5 14:12:42 2011
@@ -198,7 +198,23 @@ configurations are expressed via <code>(
     </section>
 
     <section name="Extensions optimization">
-      <p>TODO</p>
+      <p>As shown above, the universal DigesterLoader introduces a set of optimizations not or partially
+      introduced in the previous Digester releases: the <code>FromXmlRuleSet</code>, for example,
+      parses the XML Digester rules each time the Digester creation is performed:</p>
+      <source>FromXmlRuleSet ruleSet = new FromXmlRuleSet(getClass().getResource("myrule.xml"));
+    Digester digester = new Digester();
+    ruleSet.addRuleInstances(digester); // myrule.xml will be parsed
+    ...
+    Digester newDigester = new Digester();
+    ruleSet.addRuleInstances(newDigester); // myrule.xml will be parsed again!</source>
+
+      <p>In Digester3 there's only one <code>RulesModule</code>s loading, so in the case of
+      <code>FromXmlRulesModule</code>, the XML rules will be parsed only once:</p>
+      <source>DigesterLoader loader = newLoader(new FromXmlRulesModule(getClass().getResource("myrule.xml")))
+    ...
+    Digester digester = loader.newDigester(); // myrule.xml already parsed
+    ...
+    digester = loader.newDigester(); // myrule.xml won't be parsed again!</source>
     </section>
 
     <section name="Startup checks and improved error reporting">