You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by rd...@apache.org on 2002/12/30 20:13:09 UTC
cvs commit: jakarta-commons/betwixt/xdocs faq.xml
rdonkin 2002/12/30 11:13:09
Modified: betwixt/xdocs faq.xml
Log:
Added FAQ for digestor extra rules limitation. Also improved document structure
Revision Changes Path
1.3 +40 -6 jakarta-commons/betwixt/xdocs/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/betwixt/xdocs/faq.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- faq.xml 12 Jun 2002 21:40:06 -0000 1.2
+++ faq.xml 30 Dec 2002 19:13:09 -0000 1.3
@@ -58,6 +58,14 @@
</a>
</li>
</ol>
+ <p><strong>Reading Beans</strong></p>
+ <ol>
+ <li>
+ <a href="#digester-limitation">
+ How can I make my extra digestion <em>Rule</em>s work with Betwixt?
+ </a>
+ </li>
+ </ol>
<p><strong>Building Betwixt</strong></p>
<ol>
<li>
@@ -67,7 +75,7 @@
</li>
</ol>
- <section name="General">
+ <subsection name="General">
<dl>
<dt>
<a name="what-is-betwixt">
@@ -120,8 +128,8 @@
to your own look and feel. Long term bean serialization doesn't generate nice looking XML.
</dd>
</dl>
- </section>
- <section name="Writing Beans">
+ </subsection>
+ <subsection name="Writing Beans">
<dl>
<dt>
<a name="output-options">
@@ -183,8 +191,34 @@
</dd>
</dl>
- </section>
- <section name="Building Betwixt">
+ </subsection>
+ <subsection name="Reading Beans">
+ <dl>
+ <dt>
+ <a name="digester-limitation">
+ How can I make my extra digestion <em>Rule</em>s work with Betwixt?
+ </a>
+ </dt>
+ <dd>
+ Betwixt uses <a href='http://jakarta.apache.org/commons/digester.html'>Digester</a> for bean
+ reading. The current implementation adds new <em>Rule</em>s at run time (which handle
+ the reading of child elements). This makes life difficult for any extra <em>Rule</em>s
+ added by the user before the digestion started.
+ </dd>
+ <dd>
+ Extra <em>Rule</em>s added by the user will probably not work as expected. It may
+ be possible to find ways to make them work - but equally well, it may be impossible.
+ </dd>
+ <dd>
+ <em>This is a known limitation.</em>
+ </dd>
+ <dd>
+ Hopefully, this will be addressed in a later release.
+ Until then, you are recommended to use the mapping mechanisms in Betwixt instead.
+ </dd>
+ </dl>
+ </subsection>
+ <subsection name="Building Betwixt">
<dl>
<dt>
<a name="how-to-build">
@@ -198,7 +232,7 @@
documentation for details.
</dd>
</dl>
- </section>
+ </subsection>
</section>
</body>
</document>
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>