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">
